Provisionnement SCIM

Avec SCIM 2.0, votre fournisseur d’identité, par exemple Microsoft Entra ID ou Okta, gère les utilisateurs d’exoCortex à votre place : lorsque vous embauchez une personne, l’utilisateur est créé ; lorsqu’elle change de poste, il est mis à jour ; lorsqu’elle quitte l’entreprise, il est désactivé.

Connecter le fournisseur d’identité

1. Dans exoCortex Core, ouvrez Identity → SCIM et générez un jeton SCIM. Copiez-le immédiatement : il n’est affiché qu’une seule fois.
2. Dans votre fournisseur d’identité, ajoutez une application avec provisionnement SCIM 2.0 et indiquez :
   • URL de base : https://exocortex-api.ai-exo-cortex.com/scim/v2
   • Authentification : jeton bearer, avec le jeton généré à l’étape 1.
3. Lancez un test de connexion depuis le fournisseur d’identité, puis attribuez à l’application les utilisateurs et les groupes à synchroniser.

Le jeton appartient à un tenant : le fournisseur d’identité ne voit et ne gère que les utilisateurs de ce tenant.

Ce qu’exoCortex prend en charge

Fonction	Prise en charge
Utilisateurs : création, lecture, remplacement, mise à jour (PATCH), suppression	oui
Groupes : création, lecture, mise à jour (PATCH), suppression	oui
Filtres	oui, par exemple userName eq "[email protected]", y compris avec and ; jusqu’à 200 résultats
Tri	oui
Opérations groupées (bulk)	non
Changement de mot de passe	non : c’est l’utilisateur qui choisit son mot de passe
ETag	non

Attributs de l’utilisateur

exoCortex utilise les attributs standard du schéma utilisateur SCIM :

• userName : l’identifiant de l’utilisateur, en général son e-mail professionnel ;
• externalId : l’identifiant de l’utilisateur dans votre fournisseur d’identité ;
• name.givenName et name.familyName, displayName ;
• emails, avec l’adresse principale marquée comme primary ;
• active : si false, l’utilisateur est désactivé ;
• title et userType, s’ils sont présents.

Désactiver et supprimer un utilisateur

Lorsqu’un utilisateur quitte l’entreprise, le fournisseur d’identité le désactive avec un PATCH qui définit active à false :

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

Une requête DELETE sur l’utilisateur le retire du provisionnement (déprovisionnement).

Erreurs

Les endpoints SCIM répondent avec des documents d’erreur SCIM (RFC 7644). Un 401 indique un jeton manquant, non valide, révoqué ou expiré : générez un nouveau jeton et mettez-le à jour dans le fournisseur d’identité.