Las claves API son específicas del proyecto y proporcionan acceso a los recursos del proyecto. Manténgalas seguras y rótelas periódicamente.
Lista de Claves API
La lista de claves API muestra todas las claves creadas para este proyecto. Use el campo Search by name or key para encontrar una clave específica. Cada entrada muestra las siguientes columnas:| Columna | Descripción |
|---|---|
| Name | El nombre asignado a la clave API, con un distintivo que indica su tipo (Privileged o System). |
| API Key | Una vista previa truncada del valor de la clave. Use el icono de copiar para copiar la clave completa al portapapeles. |
| Created | La fecha y hora en que se creó la clave. |
| Actions | Un enlace Delete para claves creadas por el usuario. Las claves del sistema muestran Protected y no se pueden eliminar. |
Tipos de Clave
Al crear una nueva clave API, debe seleccionar uno de los siguientes tipos de clave:| Tipo | Descripción |
|---|---|
| Privileged Key | Acceso completo al proyecto. Puede enviar chats y editar o eliminar recursos del proyecto, agentes, flujos de trabajo y configuraciones. Use esta para integraciones de confianza y automatización servidor a servidor. |
| Locked-Down Viewer Key | Acceso de solo lectura al proyecto más tiempo de ejecución de chat (interacción con bot). No puede editar ni eliminar recursos del proyecto, agentes, flujos de trabajo o configuraciones. Diseñada para distribución de alcance limitado como autenticación de bots de Teams o canales. |
Crear una Nueva Clave API
Abrir el formulario de Crear Clave API
En la pestaña Settings → API Keys, seleccione el botón Create API Key.
Seleccionar un Tipo de Clave
Elija Privileged Key o Locked-Down Viewer Key según el nivel de acceso requerido.
Nombrar la clave
Ingrese un nombre descriptivo en el campo Key Name que identifique claramente el propósito de la clave.
Eliminar una Clave API
La Automator Key es una clave del sistema creada automáticamente para cada proyecto y no se puede eliminar. Todas las demás claves API que cree se pueden eliminar según sea necesario.- En la pestaña Settings → API Keys, seleccione el enlace Delete de la clave que desea eliminar.
- Confirme la eliminación en la ventana emergente.
Mejores Prácticas
- Use el tipo de clave correcto: Use claves Privileged solo para integraciones de confianza del lado del servidor. Use claves Locked-Down Viewer para despliegues públicos o bots de canales.
- Nomenclatura clara: Use nombres descriptivos que indiquen claramente el propósito de la clave y la integración a la que pertenece.
- Rotación periódica: Elimine y regenere las claves periódicamente para reducir el riesgo de acceso no autorizado.