Aprovisionamiento SCIM

Con SCIM 2.0, tu proveedor de identidad, por ejemplo Microsoft Entra ID u Okta, administra los usuarios de exoCortex por ti: cuando contratas a una persona se crea el usuario, cuando cambia de puesto se actualiza y cuando deja la empresa se desactiva.

Conectar el proveedor de identidad

1. En exoCortex Core abre Identity → SCIM y genera un token SCIM. Cópialo de inmediato: se muestra una sola vez.
2. En tu proveedor de identidad agrega una aplicación con aprovisionamiento SCIM 2.0 e indica:
   • URL base: https://exocortex-api.ai-exo-cortex.com/scim/v2
   • Autenticación: token bearer, con el token que generaste en el paso 1.
3. Ejecuta una prueba de conexión desde el proveedor de identidad y luego asigna a la aplicación los usuarios y grupos que quieres sincronizar.

El token pertenece a un tenant: el proveedor de identidad solo ve y administra los usuarios de ese tenant.

Qué admite exoCortex

Función	Soporte
Usuarios: creación, lectura, reemplazo, actualización (PATCH), eliminación	sí
Grupos: creación, lectura, actualización (PATCH), eliminación	sí
Filtros	sí, por ejemplo userName eq "[email protected]", también con and; hasta 200 resultados
Ordenamiento	sí
Operaciones masivas (bulk)	no
Cambio de contraseña	no: la contraseña la elige el usuario
ETag	no

Atributos del usuario

exoCortex usa los atributos estándar del esquema de usuario SCIM:

• userName: el identificador del usuario, por lo general el correo electrónico corporativo;
• externalId: el identificador del usuario en tu proveedor de identidad;
• name.givenName y name.familyName, displayName;
• emails, con la dirección principal marcada como primary;
• active: si es false, el usuario está desactivado;
• title y userType, si existen.

Desactivar y eliminar un usuario

Cuando un usuario deja la empresa, el proveedor de identidad lo desactiva con un PATCH que establece active en false:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [{ "op": "replace", "path": "active", "value": false }]
}

Una solicitud DELETE sobre el usuario lo quita del aprovisionamiento (desaprovisionamiento).

Errores

Los endpoints SCIM responden con documentos de error SCIM (RFC 7644). Un 401 indica un token faltante, no válido, revocado o vencido: genera un nuevo token y actualízalo en el proveedor de identidad.