- 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 de aprovisionamiento SCIM en Base44
Configuración del IdP
Selecciona tu proveedor de identidad abajo para ver las instrucciones paso a paso.- Okta
- Microsoft Entra ID
- IdP personalizado
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.

Buscando la SCIM 2.0 Test App en el App Catalog de Okta
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.

Introduciendo tu URL base SCIM y clave API de Base44 en Okta
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.

Activando Create Users, Update User Attributes y Deactivate Users en Okta
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.
- 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.

Confirmando que el usuario está aprovisionado y activo en Okta
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.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.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ó
El usuario no se está aprovisionando
El usuario no se está aprovisionando
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
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.