Saltar al contenido principal
Los secretos del workspace te permiten crear y gestionar claves de API para acceso programático a tu workspace. Usa estas claves para desplegar apps, aprovisionar usuarios de apps o crear tokens de inicio de sesión para apps integradas. En el plan Enterprise, también puedes usarlas para transmitir registros de auditoría, extraer datos del workspace mediante la Monitoring API y leer o gestionar usuarios por SCIM. Estas funciones no están incluidas en el plan Business. Cada clave lleva solo los permisos que le des. Las claves pertenecen al workspace, por lo que siguen activas aunque el miembro que las creó deje el workspace.
Quién puede usar los secretos del workspace:
  • Plan: Necesitas un plan Enterprise (Business o Enterprise) para usar los secretos del workspace.
  • Rol: Solo los owners y admins del workspace pueden ver y gestionar secretos.
La página Secrets con una clave de API del workspace y su estado

Claves de API del workspace en la página Secrets

Para la lista completa de APIs compatibles, consulta la referencia de la API.

Crear una clave de API

Puedes crear hasta 10 claves de API por workspace.
Mantén tu clave segura:
  • Copia tu clave inmediatamente después de crearla. No puedes verla de nuevo.
  • Trátala como una contraseña. Da acceso a los datos de tu workspace mediante la API.
Para crear una clave de API:
  1. Haz clic en el nombre de tu workspace abajo a la izquierda y haz clic en Configuración.
  2. Haz clic en Secretos en la barra lateral.
  3. Haz clic en + Create API Key.
  4. Escribe un nombre para la clave.
  5. 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.
    Captura de pantalla del diálogo Create API Key con las opciones Read-only y Full access resaltadas debajo de la advertencia

    Elegir acceso a todo el espacio de trabajo para una clave de API

  6. (Opcional) Escribe una descripción.
  7. Haz clic en Crear clave.
  8. Copia la clave y guárdala en un lugar seguro.
  9. Haz clic en Listo.
Diálogo Create API Key con casillas de permisos

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. Para los permisos Deploy apps, Provision app users, Mint embed sign-in tokens y Watch app builder updates, elige a qué apps puede acceder la clave:
  • 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.
El acceso a todo el espacio de trabajo no es de mínimo privilegio. La clave puede hacer mucho más que una tarea. Si se filtra, queda expuesta una parte mucho mayor de tu espacio de trabajo. Elige alcances específicos cuando la integración solo necesite unas pocas tareas o solo deba llegar a algunas de tus apps. Elígelos también cuando le des la clave a alguien de fuera de tu empresa.
Puedes cambiar los alcances o el acceso de una clave en cualquier momento editándola desde la página Secretos.

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.
Crear, editar, habilitar, deshabilitar y eliminar una clave se registran en los registros de auditoría de tu workspace, y las acciones realizadas con una clave se atribuyen a ella.
Para gestionar una clave de API:
  1. Haz clic en el nombre de tu workspace abajo a la izquierda y haz clic en Configuración.
  2. Haz clic en Secretos en la barra lateral.
  3. 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.
El menú More actions de una clave de API con Edit, Disable key y Delete key

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.
Cómo funciona en tu plan:
  • Enterprise: Las claves de API de cuentas personales funcionan en tu espacio de trabajo hasta que las bloqueas.
  • Business: Las claves de API de cuentas personales siempre están bloqueadas, incluso cuando Bloquear claves API de cuenta está desactivado. Cualquier script, integración o cliente MCP que use una necesita una clave de API del espacio de trabajo o un token de acceso personal en su lugar.
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.
Antes de activar esto:
  • 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.
Para bloquear las claves de API de cuentas personales:
  1. Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
  2. Haz clic en Configuración.
  3. Haz clic en Gobernanza.
  4. Activa Bloquear claves API de cuenta.
El ajuste Block account API keys resaltado en la página Governance

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.
Qué debes saber antes de definir una política:
  • Necesitas un plan Enterprise (Business o Enterprise) para gestionar los tokens de los miembros. Crear y usar tokens funciona en todos los planes, así que sin este control los miembros pueden seguir creándolos.
  • Desactivar la tarjeta suspende todos los tokens de miembros de inmediato. Nada de lo que un miembro haya construido con uno funciona hasta que la vuelvas a activar.
  • Endurecer un límite no rompe los tokens de forma retroactiva. Un token que ya no cumple se marca como No cumple la política y sigue funcionando hasta que alguien lo desactive, así que tú eliges cuándo cortarlo.
  • Un miembro no puede volver a activar un token que no cumple la política, ni elegir una opción que la política no permite al crear uno nuevo.

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 tarjeta Enable personal access tokens en la página Governance, con sus 2 límites

La política de tokens de acceso en Governance, con los límites que acotan lo que puede ser un token

Para definir tu política de tokens de acceso:
  1. Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
  2. Haz clic en Configuración.
  3. Haz clic en Gobernanza.
  4. Activa o desactiva el interruptor Activar tokens de acceso personal.
  5. Junto a Permiso, elige lo máximo que puede hacer un token: Acceso completo o Solo lectura.
  6. 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ó.
El panel Filters de la tabla de tokens para admins, incluido el filtro Meets policy

Filtrar los tokens de acceso de los miembros, incluso según si cumplen tu política

Para revisar y gestionar los tokens de acceso de los miembros:
  1. Haz clic en el nombre de tu workspace abajo a la izquierda de tu cuenta.
  2. Haz clic en Configuración.
  3. Haz clic en Secretos y luego en la pestaña Tokens de acceso personal.
  4. 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.
  5. Junto a un token, haz clic en el icono Más acciones y haz clic en Desactivar o Eliminar.
Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.