> ## 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.
# Configurar el aprovisionamiento SCIM para Microsoft Entra ID
> Sincroniza automáticamente tus usuarios de Microsoft Entra ID con tu espacio de trabajo empresarial de Base44 usando SCIM.
El aprovisionamiento SCIM mantiene la membresía de tu espacio de trabajo empresarial de Base44 sincronizada con Microsoft Entra ID (anteriormente Azure AD). Creas una aplicación empresarial separada, la conectas a Base44, mapeas roles y activas la sincronización automática para que los miembros se añadan, actualicen y eliminen por ti. Para permitir que tu equipo inicie sesión, configura [SSO para Microsoft Entra ID](/Enterprise/Microsoft-Entra-SSO) por separado.
El aprovisionamiento SCIM solo está disponible en espacios de trabajo empresariales. Si no ves esta opción, contacta con tu equipo de cuenta de Base44.
***
## Antes de empezar
Asegúrate de tener:
* Acceso de propietario o administrador a tu espacio de trabajo empresarial de Base44.
* Acceso de administrador al [Microsoft Entra admin center](https://entra.microsoft.com).
* Tu **SCIM Base URL**, que se encuentra en **Settings** > **Auth and security**.
* Una **Workspace API key**, que se encuentra en **Settings** > **Secrets**.
***
## Configurar el aprovisionamiento SCIM
Crea una aplicación empresarial de Entra dedicada, conéctala a Base44, mapea tus roles y atributos, luego activa la sincronización automática.
### Paso 1: Crear la app SCIM
Crea una aplicación empresarial separada y no de galería para el aprovisionamiento.
**Para crear la app SCIM:**
1. En el Microsoft Entra admin center, ve a **Identity** > **Applications** > **Enterprise applications**.
2. Haz clic en **New application**, luego **Create your own application**.
3. Introduce un nombre (por ejemplo, `Base44 SCIM Provisioning`) y selecciona **Integrate any other application you don't find in the gallery**.
4. Haz clic en **Create**.
### Paso 2: Conectar a Base44
Apunta Entra a tu espacio de trabajo de Base44 usando tu SCIM Base URL y una Workspace API key. Si aún no tienes una API key, créala primero.
**Para crear una Workspace API key:**
1. En **Settings** de tu espacio de trabajo, haz clic en **Secrets**.
2. Haz clic en **Create API Key**.
3. Introduce un nombre (por ejemplo, `Entra SCIM`), añade una descripción opcional y haz clic en **Create Key**.
Base44 muestra la clave completa solo una vez. Cópiala antes de cerrar el diálogo y guárdala en un lugar seguro, ya que la usas como el **Secret Token** abajo.
**Para configurar el aprovisionamiento:**
1. Abre la app y ve a **Provisioning**, luego haz clic en **Get started**.
2. Establece **Provisioning Mode** a **Automatic**.
3. En **Admin Credentials**, establece:
* **Tenant URL:** Tu SCIM Base URL con `?aadOptscim062020` añadido al final. El resultado se ve como `https://app.base44.com/scim/v2/organizations/{{WORKSPACE_ID}}?aadOptscim062020`.
* **Secret Token:** Tu Workspace API key.
4. Haz clic en **Test Connection** para confirmar una conexión exitosa.
5. Haz clic en **Save**.
Antes de continuar, ejecuta **Test Connection** y confirma que tiene éxito. Una prueba fallida generalmente significa que la Tenant URL o el Secret Token es incorrecto.
Entra requiere el sufijo `?aadOptscim062020` en la Tenant URL. Sin él, la prueba de conexión o el aprovisionamiento pueden fallar. Este sufijo es específico de Entra, así que no lo añadas para otros proveedores de identidad.
### Paso 3: Mapear externalId
Por defecto, Entra hace coincidir a los usuarios en un valor que puede cambiar. Mapear `externalId` a `objectId`, un identificador único estable, permite a Base44 hacer coincidir de forma fiable a cada usuario para actualizaciones y desactivación.
**Para actualizar el mapeo:**
1. En **Mappings**, haz clic en **Provision Microsoft Entra ID Users**.
2. En la tabla de mapeo, encuentra la fila donde el **Target attribute** es exactamente `externalId`.
3. Haz clic en esa fila y cambia el **Source attribute** a `objectId`.
4. Haz clic en **Ok**, luego **Save**.
Después de guardar, el mapeo actualizado aparece en la tabla de atributos, con `externalId` mapeado a `objectId`.
### Paso 4: Añadir atributos personalizados
Los campos de rol y límite de créditos de Base44 no están en la lista de destinos predeterminada de Entra, así que añádelos antes de poder mapearlos.
**Para añadir los atributos:**
1. En la pantalla de mapeo **Provision Microsoft Entra ID Users**, desplázate al final y marca **Show advanced options**.
2. Haz clic en **Edit attribute list for** tu app.
3. En la parte inferior de la lista, añade:
* **Role:** `urn:base44:params:scim:schemas:extension:user:2.0:role`, con **Type** establecido a `String`.
* **Credit limit (opcional):** `urn:base44:params:scim:schemas:extension:user:2.0:creditLimit`, con **Type** establecido a `Integer`.
4. Haz clic en **Save** y confirma el cambio.
### Paso 5: Crear roles de app
Creas roles en **App registrations**, no en **Enterprise applications**. Enterprise applications es solo donde los asignas.
**Para crear roles de app:**
1. En el Microsoft Entra admin center, ve a **App registrations** y abre la pestaña **All applications**.
2. Selecciona tu app SCIM.
3. Haz clic en **App roles**, luego **Create app role**.
4. Crea un rol separado para cada nivel de permiso de Base44: `admin`, `editor` y `viewer`.
5. En el campo **Value**, escribe la cadena exacta en minúsculas que Base44 espera (`admin`, `editor` o `viewer`).
6. Haz clic en **Apply**.
Crea un rol para cada nivel de permiso. Una vez creados, los 3 aparecen en la lista **App roles** de la app.
### Paso 6: Mapear rol y límite de créditos
Entra almacena los roles como un array, pero Base44 espera un único valor de texto, por lo que el rol debe mapearse con una expresión en lugar de un mapeo directo.
**Para mapear el rol:**
1. Ve a **Enterprise applications** > tu app SCIM > **Provisioning** > **Edit attribute mapping** > **Provision Microsoft Entra ID Users**.
2. Haz clic en **Add New Mapping**, o edita la fila de rol existente.
3. Establece **Mapping type** a **Expression**.
4. En el campo **Expression**, introduce: `SingleAppRoleAssignment([appRoleAssignments])`
5. Establece **Target attribute** a `urn:base44:params:scim:schemas:extension:user:2.0:role`.
6. Establece **Match objects using this attribute** a **No**, y **Apply this mapping** a **Always**.
7. Haz clic en **Ok**.
Establecer un límite de créditos es opcional. Sin uno, el miembro extrae del grupo de créditos compartido del espacio de trabajo sin tope individual. Añade un límite de créditos solo si quieres limitar cuántos créditos puede usar un miembro específico al mes.
**Para mapear un límite de créditos (opcional):**
1. Introduce el valor del límite de créditos en el perfil de Entra del usuario bajo un campo de extensión integrado, por ejemplo `extensionAttribute1`.
2. Haz clic en **Add New Mapping** y establece **Mapping type** a **Direct**.
3. Establece **Source attribute** a `extensionAttribute1`.
4. Establece **Target attribute** a `urn:base44:params:scim:schemas:extension:user:2.0:creditLimit`.
5. Haz clic en **Ok**, luego **Save**.
### Paso 7: Asignar y aprovisionar
Elige a quién aprovisionar, dales un rol e inicia la sincronización.
**Para asignar usuarios:**
1. Ve a **Enterprise applications** > tu app SCIM > **Users and groups**.
2. Haz clic en **Add user/group** y selecciona los usuarios o grupos a aprovisionar.
3. En **Select a role**, elige el rol que creaste (`admin`, `editor` o `viewer`), luego haz clic en **Assign**.
**Para activar el aprovisionamiento:**
1. Ve a **Provisioning**.
2. Establece **Provisioning Status** a **On**.
Entra comienza a sincronizar los usuarios asignados con tu espacio de trabajo de Base44.
Si el botón **Edit** para un usuario está en gris, marca la casilla junto al usuario, haz clic en **Remove**, luego añádelo de nuevo con el rol correcto.
### Paso 8: Actualizar usuarios existentes
Si cambiaste el mapeo de `externalId` después de que algunos usuarios ya estuvieran aprovisionados, actualiza sus registros para que recojan el `objectId` correcto.
**Para actualizar usuarios existentes:**
1. Ve a **Provisioning** > **Provision on demand**.
2. Busca al usuario y ejecuta el aprovisionamiento para corregir su registro.
3. Para aplicar esto a todos, vuelve a la página principal **Provisioning** y haz clic en **Restart provisioning**.
***
## Roles y límites de créditos
Base44 acepta solo los siguientes roles a través de SCIM. Mapea tus roles de app de Entra a estos valores exactos.
| Rol | Lo que pueden hacer |
| -------- | -------------------------------------------------------------------------------- |
| `admin` | Gestionar miembros, facturación y configuración del espacio de trabajo |
| `editor` | Construir, editar y ejecutar apps; usa créditos del grupo del espacio de trabajo |
| `viewer` | Acceso de solo lectura a apps; no consume créditos |
Los límites de créditos se aplican solo a los roles `admin` y `editor`, ya que los viewers no consumen créditos. Establecer un límite de créditos de `0` se trata como sin tope. También puedes establecer límites de créditos directamente en tu espacio de trabajo, sin SCIM. Consulta [Gestionar miembros de espacios de trabajo empresariales](/Enterprise/managing-enterprise-members#per-member-credit-limits).
Los propietarios del espacio de trabajo no pueden actualizarse ni desactivarse a través de SCIM. Promueve o degrada a los propietarios desde la configuración de tu espacio de trabajo.
***
## Preguntas frecuentes
Selecciona una pregunta abajo para saber más sobre el aprovisionamiento SCIM de Entra.
Sí. El aprovisionamiento SCIM usa una **Enterprise application** dedicada, mientras que el inicio de sesión usa una **App registration** separada. Configura el aprovisionamiento en la Enterprise application y configura el inicio de sesión por separado. Consulta [SSO para Microsoft Entra ID](/Enterprise/Microsoft-Entra-SSO).
Confirma que tu Tenant URL termina con `?aadOptscim062020` y que el Secret Token es tu Workspace API key de **Settings** > **Secrets**. Verifica que la SCIM Base URL se copió de **Settings** > **Auth and security** y no se ha cambiado.
Entra almacena los roles como un array, por lo que un mapeo **Direct** falla. Establece el tipo de mapeo de rol a **Expression** y usa `SingleAppRoleAssignment([appRoleAssignments])`. Asegúrate de que el **Value** de cada rol de app sea exactamente `admin`, `editor` o `viewer` en minúsculas.
Añádelo primero. En la pantalla de mapeo, marca **Show advanced options**, haz clic en **Edit attribute list**, añade la URN completa (por ejemplo, `urn:base44:params:scim:schemas:extension:user:2.0:role`), luego guarda. El campo estará disponible en el menú desplegable después.
Asegúrate de que `externalId` está mapeado a `objectId`. Si los usuarios se aprovisionaron antes de cambiar este mapeo, usa **Provision on demand** para actualizar cada usuario, o **Restart provisioning** para actualizar a todos.
Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).