Aller au contenu

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_id et client_secret dans 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

JetonDuréeRemarque
Accès15 minutesOpaque, à envoyer dans Authorization: Bearer
Rafraîchissement30 joursSeulement 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

ScopeAccès
users:readLire les utilisateurs de l’organisation
users:writeCréer des apprenants
enrollments:writeInscrire des apprenants à une diffusion
progress:readLire la progression et les résultats
groups:readLire les groupes et leurs membres
catalog:readLire les formations et les diffusions
certifications:readLire les attestations et certifications (module dédié requis)
reports:readExporter 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.