El aprovisionamiento SCIM está disponible solo en workspaces empresariales.
- Okta
- Microsoft Entra ID (antes Azure AD)
- IdP personalizado, cualquier proveedor de identidad compatible con SCIM 2.0
Antes de empezar
Antes de configurar SCIM, asegúrate de tener:- Acceso de propietario o admin a tu workspace de Base44
- Una clave API del workspace (la encuentras en Settings → Secrets)
- Tu URL base SCIM (la encuentras en Settings → Auth and security)

Configuración del IdP
Selecciona tu proveedor de identidad abajo para ver las instrucciones paso a paso.- Okta
- Microsoft Entra ID
- IdP personalizado
Okta es un proveedor de identidad en la nube. Usa esta configuración si tu organización gestiona usuarios a través de Okta.


Para probar que funciona el aprovisionamiento:
Paso 1: Crea una app SCIM en Okta
Las apps OIDC de Okta no admiten SCIM directamente, así que necesitas una app SCIM separada.Para crear una app SCIM:- En Okta, ve a Applications → Browse App Catalog.
- Busca SCIM 2.0 Test App (Header Auth).
- Haz clic en Add Integration.
- Nombra la app (por ejemplo,
Base44 - SCIM Provisioning). - Haz clic en Done.

Paso 2: Conecta la app a Base44
Apunta Okta a tu workspace de Base44 introduciendo tu URL base SCIM y tu clave API del workspace.Para configurar la integración de API:- Abre tu nueva app SCIM y ve a la pestaña Provisioning.
- Haz clic en Configure API Integration.
- Marca Enable API integration.
- Establece SCIM 2.0 Base URL a la URL copiada desde Settings → Auth and security en tu workspace de Base44.
- Establece API Token a tu clave API del workspace.
- Haz clic en Test API Credentials. Deberías ver una confirmación de éxito.
- Haz clic en Save.

Paso 3: Activa las acciones de aprovisionamiento
Elige qué acciones puede realizar Okta sobre los miembros del workspace de Base44.Para activar el aprovisionamiento:- En la pestaña Provisioning, haz clic en To App.
- Activa:
- Create Users
- Update User Attributes
- Deactivate Users
- Haz clic en Save.

Paso 4: Configura atributos personalizados
Añade atributos específicos de Base44 a tu perfil de Okta y mapéalos a tu app SCIM.Para añadir el atributorole:- Ve a Directory → Profile Editor y encuentra tu app SCIM.
- Haz clic en Add Attribute.
- Completa la configuración:
- Data type: String
- Display name: Role
- Variable name:
role - External name:
role - External namespace:
urn:base44:params:scim:schemas:extension:user:2.0 - Enum: Marca Define enumerated list of values y añade
admin,editor,viewer - Attribute required: No
- Haz clic en Save.
creditLimit (opcional):Salta este paso si no quieres límites de crédito por miembro. El valor por defecto es sin límite.- En el mismo Profile Editor, haz clic en Add Attribute.
- Completa la configuración:
- Data type: Integer
- Display name: Credit Limit
- Variable name:
creditLimit - External name:
creditLimit - External namespace:
urn:base44:params:scim:schemas:extension:user:2.0 - Attribute required: No
- Haz clic en Save.
- Ve a tu app SCIM → Provisioning → To App → Attribute Mappings.
- Establece:
userName←user.emailrole←"editor"(o mapéalo desde el atributo de rol de tu IdP)creditLimit← tu valor preferido o atributo del IdP (si lo añadiste)
- Elimina cualquier mapeo no admitido (firstName, lastName, displayName).
- Haz clic en Save.
Paso 5: Prueba el aprovisionamiento
Asigna un usuario de prueba para confirmar que el aprovisionamiento y la desactivación funcionan como esperas.Cada usuario debe asignarse tanto a tu app Base44 SSO como a tu app Base44 SCIM Provisioning en Okta. Asignar solo a SCIM aprovisionará al usuario pero no podrá iniciar sesión vía SSO.

- En Okta, ve a Directory → People.
- Haz clic en tu usuario de prueba.
- Ve a la pestaña Applications.
- Haz clic en Assign Applications.
- Selecciona Base44 - SSO Workspace y Base44 - SCIM Provisioning, luego haz clic en Assign.
- Establece
roleaeditor,adminoviewer. Opcionalmente establececreditLimit. - Haz clic en Save and Go Back → Done.
- Revisa los miembros de tu workspace en Base44 para confirmar que el usuario aparece.
- En la pestaña Assignments, haz clic en Unassign junto al usuario de prueba.
- Confirma la eliminación.
- Verifica que el usuario ya no aparece como miembro activo en Base44.

Gestión de miembros
Una vez configurado SCIM, tu IdP gestiona los cambios de membresía automáticamente. Esto es lo que ocurre en Base44 para cada acción.Añadir miembros
Cuando asignas un usuario a tu app SCIM, Base44 crea su membresía del workspace automáticamente. El usuario puede iniciar sesión en Base44 usando SSO una vez aprovisionado.Actualizar miembros
Cuando actualizas los atributos de un usuario en tu IdP (como su rol o límite de crédito), Base44 actualiza su membresía del workspace para coincidir.Los propietarios del workspace no pueden actualizarse ni desactivarse vía SCIM. Los propietarios deben ascenderse o degradarse directamente desde la configuración del workspace.
Eliminar miembros
Cuando desasignas un usuario de tu app SCIM, Base44 lo elimina del workspace. Su cuenta global de Base44 no se elimina, y mantiene acceso a otros workspaces a los que pertenezca. Si necesitas reañadir a un miembro eliminado, reasígnalo en tu IdP. Base44 creará una nueva membresía del workspace.Roles
Base44 usa roles para controlar lo que cada miembro puede hacer. Asignas un rol al aprovisionar un usuario vía SCIM, y puedes actualizarlo en cualquier momento.| Rol | Lo que pueden hacer |
|---|---|
admin | Gestionar miembros, facturación y configuración del workspace |
editor | Crear, editar y ejecutar apps; usa créditos del pool del workspace |
viewer | Acceso de solo lectura a apps; no consume créditos |
Los roles
owner, member y guest no pueden asignarse vía SCIM. Si tu IdP tiene grupos mapeados a esos roles, actualiza el mapeo para usar admin, editor o viewer.Límites de crédito por miembro
Opcionalmente puedes limitar cuántos créditos puede usar un miembro por mes. EstablececreditLimit a un entero positivo para aplicar un límite, o déjalo vacío para no tener límite.
Los límites de crédito solo aplican a roles admin y editor. Los viewers no pueden consumir créditos, así que establecer un límite de crédito en un viewer devuelve un error. Establecer creditLimit a 0 se trata como sin límite.
También puedes establecer límites de crédito directamente desde la configuración de tu workspace sin pasar por SCIM. Consulta Gestión de miembros del workspace empresarial.
Solución de problemas
Si el aprovisionamiento no funciona como esperas, los pasos siguientes cubren los errores más comunes y cómo solucionarlos.La prueba de credenciales API falló
La prueba de credenciales API falló
Verifica que tu clave API del workspace es correcta. Comprueba que la URL base SCIM se copió desde Settings → Auth and security y no se ha modificado.
El usuario no se está aprovisionando
El usuario no se está aprovisionando
Revisa los logs de aprovisionamiento de tu IdP por errores específicos. Confirma que
role está establecido a admin, editor o viewer.No se puede actualizar ni desactivar al propietario del workspace
No se puede actualizar ni desactivar al propietario del workspace
Es por diseño. Los propietarios del workspace deben ascenderse o degradarse desde el panel de Base44. SCIM no puede modificar membresías de propietarios.
Error: No se puede establecer un límite de crédito para viewers
Error: No se puede establecer un límite de crédito para viewers
creditLimit solo puede establecerse en roles admin o editor. O cambia el rol a editor o admin, o elimina el valor de creditLimit.Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.

