Authentifier une intégration
Présenter une clé partenaire Mastrao et limiter ses droits avec des scopes.
Contrat candidat. Cette interface est implémentée et figée pour qualification, mais son environnement partenaire n'est pas encore ouvert. Mastrao transmettra l'URL et la clé de test par un canal sécurisé après la recette staging.
Chaque clé appartient à une installation d'application rattachée à une organisation Mastrao. Le serveur déduit l'organisation et l'identité applicative de la clé : un client ne transmet jamais de tenant dans une requête.
Présenter la clé
Utilisez un seul des deux en-têtes acceptés :
Authorization: Bearer $MASTRAO_API_KEYou, pendant le pilote REST :
x-api-key: $MASTRAO_API_KEYNe combinez pas les deux en-têtes. Conservez la clé côté serveur, ne l'intégrez pas dans une application web ou mobile et ne l'écrivez pas dans les journaux.
Scopes du pilote
| Scope | Autorise |
|---|---|
meeting:create | Créer une réunion |
meeting:share | Créer un lien invité gouverné |
meeting:read | Lire l'état d'une réunion |
transcript:read | Lire la post-transcription |
summary:read | Lire la synthèse et ses éléments structurés |
Une clé sans le scope requis reçoit 403 AUTHORIZATION_DENIED. L'accès à une réunion absente ou appartenant à une autre installation reçoit 404 NOT_FOUND, sans révéler la cause.
Remise et révocation
Pour le pilote, Mastrao remettra une clé de test par un lien sécurisé à usage unique. L'accès de production, la création et la rotation en libre-service ne sont pas encore disponibles.