> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestionar secretos del workspace

> Crea claves de API del workspace solo con los permisos que elijas, bloquea las claves de API personales de los miembros y define una política para los tokens de acceso personal.

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.

> [!WARNING]
>
> **Importante:**
>
> * Los secretos del workspace están disponibles en un plan Enterprise (Business o Enterprise).
> * 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](https://mintcdn.com/base44/db25a59iYx_0oget/images/enterprise-secrets-api-keys.png?fit=max\&auto=format\&n=db25a59iYx_0oget\&q=85\&s=9cfea0e37fdc2f006b8c6e19bafe62dd)

Claves de API del workspace en la página Secrets

> [!TIP]
>
> Para la lista completa de APIs compatibles, [consulta la referencia de la API](https://docs.base44.com/developers/references/audit-logs-api/get-started/overview.md).

***

## Crear una clave de API

Puedes crear hasta 10 claves de API por workspace.

> [!WARNING]
>
> **Importante:**
>
> * 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 (obligatorio) y una descripción opcional.
5. En **Permisos**, selecciona los alcances que esta clave debe tener. Consulta [Elegir permisos](#choosing-permissions) para saber qué otorga cada uno.
6. Si seleccionas **Deploy apps**, establece su **Acceso a aplicaciones** en **Aplicaciones seleccionadas** y elige las apps, o en **Todas las aplicaciones actuales y futuras**.
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](https://mintcdn.com/base44/kDA_oWGGKM9l0joO/images/create-key-api.png?fit=max\&auto=format\&n=kDA_oWGGKM9l0joO\&q=85\&s=c8badbf39bfb42ce5903ba13099de51e)

Elegir los permisos de una clave de API

***

## Elegir permisos

Cada clave de API tiene uno o más permisos, llamados alcances, que controlan a qué partes de tu workspace puede acceder. Da a una clave solo los permisos que la integración necesita.

| Permiso | Qué permite |
| - | - |
| **Read monitoring data** | Ver el uso, la salud y las analíticas del workspace mediante la [Monitoring API](https://docs.base44.com/developers/references/monitoring-api/get-started/overview.md). |
| **Read audit logs** | Transmitir eventos de auditoría del workspace mediante la [Audit Logs API](https://docs.base44.com/developers/references/audit-logs-api/get-started/overview.md). |
| **Read SCIM users** | Consultar los usuarios aprovisionados en tu workspace mediante [SCIM](https://docs.base44.com/Enterprise/SCIM-provisioning.md). |
| **Manage SCIM users** | Crear, actualizar y eliminar usuarios SCIM. Requiere **Read SCIM users**. |
| **Deploy apps** | Sincronizar y publicar apps en tu workspace. |
| **Provision app users** | Dar a las personas acceso a apps de tu workspace, o quitárselo. Se usa para [integrar apps](https://docs.base44.com/developers/white-label/embed-the-app.md). |
| **Mint embed sign-in tokens** | Crear tokens de un solo uso que abren una app con la sesión iniciada como uno de sus usuarios. Se usa para [integrar apps](https://docs.base44.com/developers/white-label/embed-the-app.md). |
| **Watch app builder updates** | Abrir sesiones breves de solo lectura que transmiten el chat de IA de las apps seleccionadas a un navegador. Se usa para [actualizaciones en vivo](https://docs.base44.com/developers/white-label/live-updates.md). |

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.

> [!NOTE]
>
> Puedes hacer cambios en una clave en cualquier momento. Para actualizar su nombre, descripción o permisos, edita la clave desde la página **Secretos**.

***

## Gestionar tus claves de API

Desde la página **Secretos**, puedes ver todas tus claves junto con quién las 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.

> [!NOTE]
>
> Crear, editar, habilitar, deshabilitar y eliminar una clave se registran en los [registros de auditoría](https://docs.base44.com/developers/references/audit-logs-api/get-started/overview.md) 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 o los permisos 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](https://mintcdn.com/base44/db25a59iYx_0oget/images/enterprise-secrets-key-menu.png?fit=max\&auto=format\&n=db25a59iYx_0oget\&q=85\&s=4d875da82248fe66cd1b48954f5c4418)

Gestionar una clave de API existente del workspace

***

## Bloquear claves de API de cuentas personales

Junto a las claves del workspace que creas aquí, cada usuario de Base44 tiene su propia clave de API de cuenta personal. Mientras alguien es miembro de tu workspace, su clave personal puede llegar a las apps y los datos de tu workspace. Puedes bloquear las claves personales para que solo se puedan usar las claves de API del workspace, que los admins crean y gestionan.

Puedes hacerlo tanto si tu workspace usa SSO como si no. Es especialmente útil si [requieres SSO para todos los miembros del workspace](https://docs.base44.com/es/Enterprise/SSO-for-enterprise-workspace.md#requiring-sso), porque cierra la brecha entre cómo las personas inician sesión y cómo pueden llegar a tus datos de forma programática.

> [!NOTE]
>
> **Antes de activar esto:**
>
> * Bloquear las claves de API de cuentas personales requiere un plan Enterprise (Business o Enterprise).
> * 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](https://docs.base44.com/developers/references/audit-logs-api/get-started/overview.md).
> * 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](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/block-account-api.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=21fba020378cf9370e82827a6dc5ea35)

Bloquear claves de API de cuentas personales para tu workspace

***

## Gestionar los tokens de acceso personal

Los miembros pueden crear [tokens de acceso personal](https://docs.base44.com/es/Workspaces/Personal-access-tokens.md) 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**.

> [!NOTE]
>
> **Qué debes saber antes de definir una política:**
>
> * Gestionar los tokens de los miembros requiere un plan Enterprise (Business o Enterprise). 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](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/governance-token-policy.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=86a6745a9baaf360e381c2f2ab0bba29)

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](https://mintcdn.com/base44/G_oNLsUyqxpQ5Qq5/images/filters-access-tokens.png?fit=max\&auto=format\&n=G_oNLsUyqxpQ5Qq5\&q=85\&s=3e0838d616cd8be937fbd90d52bef4ff)

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**.

> [!NOTE]
>
> Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.