
Claves de API del workspace en la página Secrets
Crear una clave de API
Puedes crear hasta 10 claves de API por workspace. Para crear una clave de API:- Haz clic en el nombre de tu workspace abajo a la izquierda y haz clic en Configuración.
- Haz clic en Secretos en la barra lateral.
- Haz clic en + Create API Key.
- Escribe un nombre para la clave.
-
Elige a qué puede acceder la clave. Consulta Elegir permisos para saber qué otorga cada opción.
- Para dar a la clave alcances específicos, selecciona los alcances que debe tener. Si seleccionas un permiso que funciona sobre apps, como Deploy apps, elige a qué apps puede llegar la clave en Acceso a aplicaciones.
- Para dar a la clave acceso a todo el espacio de trabajo, haz clic en Usar acceso a todo el espacio de trabajo y elige un nivel de acceso:
- Solo lectura: La clave puede leer datos mediante todas las API que aceptan claves de API del espacio de trabajo, pero no puede hacer cambios. Esta opción está seleccionada por defecto.
- Acceso completo: La clave puede leer datos y hacer cambios mediante todas las API que aceptan claves de API del espacio de trabajo.

Elegir acceso a todo el espacio de trabajo para una clave de API
- (Opcional) Escribe una descripción.
- Haz clic en Crear clave.
- Copia la clave y guárdala en un lugar seguro.
- Haz clic en Listo.

Elegir los permisos de una clave de API
Elegir permisos
Cada clave de API obtiene su acceso de una de 2 formas. Puede tener alcances específicos, que solo permiten las tareas que elijas. O puede tener acceso a todo el espacio de trabajo, que llega a todas las API que aceptan claves de API del espacio de trabajo en tu plan. Los alcances específicos son la opción por defecto.Elegir alcances específicos
Los alcances son permisos individuales que controlan a qué partes de tu espacio de trabajo puede acceder una clave. Da a una clave solo los alcances que la integración necesita.- Aplicaciones seleccionadas: La clave solo puede acceder a las apps específicas que elijas.
- Todas las aplicaciones actuales y futuras: La clave puede acceder a cualquier app del workspace, incluidas las apps que añadas más tarde.
Usar acceso a todo el espacio de trabajo
El acceso a todo el espacio de trabajo permite que una clave use todas las API que aceptan claves de API del espacio de trabajo. Tiene los mismos permisos que el owner del espacio de trabajo, así que no eliges los alcances uno a uno. Siempre cubre todas las apps del espacio de trabajo, incluidas las apps que añadas más tarde. Tus registros de auditoría guardan las acciones de la clave bajo la clave, junto con el owner en cuyo nombre actuó. Úsalo para una integración propia y de confianza que funcione en todo tu espacio de trabajo, como una herramienta interna que gestiona todas tus apps. Eliges uno de 2 niveles:- Solo lectura: La clave puede leer datos mediante esas API, pero no puede hacer cambios. Por ejemplo, no puede publicar apps, dar acceso a apps a otras personas, crear tokens de inicio de sesión ni cambiar usuarios SCIM.
- Acceso completo: La clave puede leer datos y hacer cambios mediante esas API.
Gestionar tus claves de API
Desde la página Secretos, puedes ver todas tus claves junto con el acceso de cada una, quién la creó, cuándo se crearon y cuándo se usaron por última vez. Haz clic en el icono Más acciones junto a una clave para editarla, desactivarla o eliminarla.- Haz clic en el nombre de tu workspace abajo a la izquierda y haz clic en Configuración.
- Haz clic en Secretos en la barra lateral.
- Haz clic en el icono Más acciones junto a la clave que quieres gestionar y elige una opción:
- Editar: Actualiza el nombre, la descripción, los permisos o el acceso de la clave.
- Desactivar clave: Impide temporalmente el uso de la clave sin eliminarla.
- Activar clave: Vuelve a habilitar una clave deshabilitada previamente.
- Eliminar clave: Elimina la clave permanentemente. Esto no se puede deshacer, y cualquier cosa que use esa clave deja de funcionar de inmediato.

Gestionar una clave de API existente del workspace
Bloquear claves de API de cuentas personales
Es posible que algunos miembros de tu espacio de trabajo todavía tengan una clave de API de cuenta personal antigua. Cuando bloqueas estas claves, solo las claves de API del espacio de trabajo, que los admins crean y gestionan, pueden llegar a las apps y los datos de tu espacio de trabajo. Puedes bloquear las claves personales tanto si tu workspace usa SSO como si no. Es especialmente útil si requieres SSO para todos los miembros del workspace, porque cierra la brecha entre cómo las personas inician sesión y cómo pueden llegar a tus datos de forma programática.- La configuración muestra cuántas solicitudes usaron una clave de API de cuenta personal contra tu workspace en los últimos 30 días, y cuántos miembros están usando activamente sus claves, para que veas a quién afecta. Puedes revisar la lista completa en tus registros de auditoría.
- Las claves de API del workspace no se ven afectadas, por lo que todo lo construido sobre una clave gestionada por un admin sigue funcionando.
- Los usuarios de apps que inician sesión en tus apps publicadas no se ven afectados.
- Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
- Haz clic en Configuración.
- Haz clic en Gobernanza.
- Activa Bloquear claves API de cuenta.

Bloquear claves de API de cuentas personales para tu workspace
Gestionar los tokens de acceso personal
Los miembros pueden crear tokens de acceso personal para que sus propios scripts y herramientas lleguen a las apps de tu workspace. Un token actúa como el miembro que lo creó y nunca supera sus propios permisos. Deja de funcionar cuando el miembro sale del workspace. Como admin, decides si se pueden usar tokens en tu workspace y cuánto puede hacer un token. Los controles están en la tarjeta Activar tokens de acceso personal de la página Gobernanza, y todos los tokens de miembros creados para el workspace aparecen en Secretos.Definir la política de tokens de acceso
La tarjeta tiene un interruptor para los tokens en general y 2 límites que acotan lo que puede ser cualquier token. Cada límite indica lo máximo que se permite a un token, así que si eliges Solo lectura nadie puede crear un token que cambie datos.
La política de tokens de acceso en Governance, con los límites que acotan lo que puede ser un token
- Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
- Haz clic en Configuración.
- Haz clic en Gobernanza.
- Activa o desactiva el interruptor Activar tokens de acceso personal.
- Junto a Permiso, elige lo máximo que puede hacer un token: Acceso completo o Solo lectura.
- Junto a Acceso, elige qué parte del workspace puede alcanzar un token: Todas las apps y Superagents o Una app o Superagent.
Revisar los tokens de acceso de los miembros
La nota al pie de la tarjeta cuenta los tokens de miembros que cumplen tu política y enlaza directamente a la lista completa. En Secretos, la tabla Tokens de acceso personal en este espacio de trabajo es solo para admins. Muestra el propietario de cada token, su acceso, su permiso, su estado y cuándo se usó por última vez. Puedes desactivar o eliminar cualquiera de ellos, pero no puedes modificarlos, ya que pertenecen al miembro que los creó.
Filtrar los tokens de acceso de los miembros, incluso según si cumplen tu política
- Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
- Haz clic en Configuración.
- Haz clic en Secretos y luego en la pestaña Tokens de acceso personal.
- En Tokens de acceso personal en este espacio de trabajo, haz clic en Filtrar para acotar la lista por permiso, último uso, estado o si un token cumple tu política.
- Junto a un token, haz clic en el icono Más acciones y haz clic en Desactivar o Eliminar.