Guides
Authentification et scopes
InTeach utilise OAuth 2. Les métadonnées du serveur d’autorisation sont publiées à /.well-known/oauth-authorization-server (RFC 8414) et celles de l’API à /.well-known/oauth-protected-resource/api/v1 (RFC 9728).
Intégration machine à machine
Le flux client_credentials convient aux synchronisations et automatisations sans utilisateur. Le client s’authentifie sur POST /oauth/token :
- de préférence avec HTTP Basic (
client_secret_basic) ; - ou avec
client_idetclient_secretdans le corps (client_secret_post).
Le paramètre scope est facultatif. Sans lui, le jeton reçoit tous les scopes du client ; avec lui, il ne peut demander qu’un sous-ensemble.
Application agissant au nom d’un utilisateur
Si des adresses de redirection sont déclarées sur le client, il peut aussi utiliser authorization_code avec PKCE (S256). L’utilisateur se connecte à l’administration InTeach et consent aux scopes demandés. Les droits effectifs restent ceux de son compte, recontrôlés à chaque appel ; l’organisation est celle du client.
Jetons
| Jeton | Durée | Remarque |
|---|---|---|
| Accès | 15 minutes | Opaque, à envoyer dans Authorization: Bearer |
| Rafraîchissement | 30 jours | Seulement pour authorization_code ; tournant, une réutilisation révoque l’autorisation |
Un jeton est refusé immédiatement si le client est révoqué, si le module API et intégrations est désactivé ou si un scope a été retiré au client.
Scopes
| Scope | Accès |
|---|---|
users:read | Lire les utilisateurs de l’organisation |
users:write | Créer des apprenants |
enrollments:write | Inscrire des apprenants à une diffusion |
progress:read | Lire la progression et les résultats |
groups:read | Lire les groupes et leurs membres |
catalog:read | Lire les formations et les diffusions |
certifications:read | Lire les attestations et certifications (module dédié requis) |
reports:read | Exporter les données de reporting |
Une opération sans le scope requis répond 403 avec le code insufficient_scope. Demandez le minimum nécessaire.
Rotation et révocation des secrets
L’administrateur peut générer un nouveau secret en conservant l’ancien valable de 0 à 7 jours (24 heures par défaut) : déployez le nouveau secret pendant ce recouvrement. Un secret précis ou le client entier peut être révoqué ; la révocation du client invalide tous ses jetons en cours.