Aprovisionamiento SCIM

Con SCIM 2.0, tu proveedor de identidad, por ejemplo Microsoft Entra ID u Okta, gestiona 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 enseguida: solo se muestra una vez.
2. En tu proveedor de identidad añade 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 generado en el paso 1.
3. Lanza una prueba de conexión desde el proveedor de identidad y luego asigna a la aplicación los usuarios y grupos que quieras sincronizar.

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

Qué admite exoCortex

Función	Compatibilidad
Usuarios: creación, lectura, sustitución, 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
Ordenación	sí
Operaciones en bloque (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, normalmente 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 pone active a 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 elimina del aprovisionamiento (desaprovisionamiento).

Errores

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