Guides
Identités, SCIM et API : quelle surface choisir
| Besoin | Surface | Pourquoi |
|---|---|---|
| Synchroniser un annuaire ou un SIRH : arrivées, modifications, départs, groupes | SCIM 2.0 | Protocole standard des fournisseurs d’identité ; porte l’identité externe et la suspension |
| Créer ponctuellement un apprenant et l’inscrire (portail, CRM, automate) | API POST /users, POST /enrollments | Pas de cycle de vie d’annuaire |
| Lire progression, résultats, catalogue | API | Lecture seule, scopes fins |
| Recevoir les événements de la plateforme | Webhooks | Notifications signées |
SCIM 2.0
Le provisioning SCIM est configuré par un superadministrateur InTeach dans le module Identité et accès, qui fournit l’URL de base et un jeton dédié par connecteur. Il gère utilisateurs et groupes ; active=false suspend immédiatement l’accès sans supprimer la progression.
Règles communes
- Une suspension l’emporte toujours. Ni l’API ni le webhook historique ne réactivent un compte désactivé ou suspendu : ils répondent
409account_suspended. - Une source gère ses comptes. Un compte provisionné par SCIM ne peut pas être modifié par l’API :
409account_managed. - L’adresse e-mail n’établit jamais de liaison d’identité entre sources.