L'émetteur de votre organisation
Donnez à votre organisation son propre émetteur OIDC et ses propres clés de signature, pour que vos applications n'acceptent que les jetons émis pour votre organisation ; choisissez l'algorithme de signature, renouvelez et retirez des clés, donnez votre image de marque à vos pages de connexion et connectez les personnes sur un domaine qui vous appartient.
Par défaut, toutes les organisations d'un déploiement partagent un seul
émetteur (https://<hôte d'auth>/api/auth) et un seul jeu de clés de
signature. Une application qui ne vérifie que l'émetteur et la signature, ce
que font la plupart des bibliothèques, accepterait alors aussi un jeton émis
pour l'application d'une autre organisation.
Activez l'émetteur de votre organisation : vos applications reçoivent des jetons que seules les clés de votre organisation vérifient, sous un émetteur qui n'appartient qu'à vous :
https://<hôte d'auth>/api/auth/o/<id de l'organisation>L'identifiant de l'organisation ne change jamais, donc l'émetteur non plus, même si vous renommez l'organisation.
Ce qu'il couvre
L'émetteur s'applique aux clients OAuth (Apps) dont votre organisation est propriétaire. Les applications de Scrydon et les clients qui n'appartiennent pas à votre organisation gardent l'émetteur du déploiement.
| Rôle | URL |
|---|---|
| Découverte OIDC | <émetteur>/.well-known/openid-configuration |
| Métadonnées du serveur d'autorisation (RFC 8414) | <émetteur>/.well-known/oauth-authorization-server |
| JWKS (vos clés publiques de signature) | <émetteur>/jwks |
Le document de découverte indique les points de terminaison d'autorisation,
de jeton, userinfo, d'introspection, de révocation et de fin de session,
partagés par le déploiement, comme OIDC Discovery le permet. Indiquez à votre
application l'URL de découverte : elle trouve le reste. Chaque iss que
voient vos applications porte votre émetteur : jetons d'identité, jetons
d'accès, jetons de déconnexion, redirections d'erreur et réponse
d'autorisation (RFC 9207).
Si l'émetteur d'une organisation est désactivé, ou si l'identifiant d'organisation n'existe pas, les deux documents répondent 404. Ils sont publics, comme doit l'être un document de découverte.
L'activer
Les organisations créées après cette version démarrent avec leur émetteur activé. Les organisations existantes restent sur l'émetteur du déploiement jusqu'à ce qu'un propriétaire ou un administrateur active le leur, sous Paramètres → Plateforme → Identité → Émetteur.
Activer l'émetteur change l'émetteur et les clés que voit chacune de vos applications. Une application configurée avec l'émetteur du déploiement cesse d'accepter les jetons tant que vous ne lui avez pas donné l'URL de découverte de votre organisation. Reconfigurez chaque application, puis activez l'émetteur. Le désactiver inverse le changement de la même façon. Les deux bascules sont consignées dans le journal d'audit.
Algorithme de signature et clés
| Algorithme | Clé |
|---|---|
RS256 (par défaut) | RSA 3072 bits |
PS256 | RSA 3072 bits |
ES256 | P-256 |
ES384 | P-384 |
RS256 fonctionne avec toutes les parties utilisatrices, Microsoft Entra
compris. EdDSA, HMAC et none ne sont pas proposés.
- Renouvellement. Une clé signe pendant 30 jours et reste dans votre JWKS 30 jours de plus, pour que les jetons qu'elle a signés restent vérifiables. Renouveler maintenant démarre une nouvelle clé immédiatement.
- Changer d'algorithme crée une nouvelle clé dans le nouvel algorithme. L'ancienne reste publiée jusqu'à la fin de sa période de grâce.
- Retirer une clé (par exemple après une compromission présumée) la supprime de votre JWKS immédiatement. Tous les jetons qu'elle a signés cessent d'être vérifiables, ce qu'exige une compromission.
- Vos clés privées sont scellées par la garde des secrets de votre organisation. Avec Vault Transit ou Azure Key Vault, c'est votre organisation qui détient la clé qui les enveloppe.
Activer l'émetteur, ou changer d'algorithme, crée une clé immédiatement. Une nouvelle organisation, dont l'émetteur démarre activé, reçoit sa première clé lorsqu'elle signe son premier jeton : son JWKS est vide jusque-là. Il n'y a aucun jeton à vérifier avant ce moment. Les bibliothèques qui rechargent le JWKS quand elles rencontrent un identifiant de clé inconnu récupèrent la clé d'elles-mêmes.
Image de marque de la connexion
Sous Paramètres → Plateforme → Identité → Image de marque, un propriétaire ou un administrateur peut définir ce que voient les personnes lorsqu'elles se connectent à l'une des applications de votre organisation ou sur votre domaine de connexion :
- un nom d'affichage et un court texte d'accueil (texte brut) ;
- un lien d'assistance (
https://uniquement) ; - une couleur d'accent pour le bouton principal. Elle doit ressortir d'au moins 3:1 sur la page, en thème clair comme en thème sombre. Le libellé du bouton est noir ou blanc, selon ce qui se lit le mieux, et atteint toujours au moins 4,5:1 ;
- le logo de votre organisation, c'est-à-dire le logo défini sur l'organisation.
La personnalisation n'apparaît jamais sur la page de connexion propre au déploiement, et ce n'est jamais du balisage : ni HTML, ni CSS, ni script.
Se connecter sur votre propre domaine
Les personnes peuvent se connecter sur un nom d'hôte qui vous appartient,
par exemple login.example.com :
- Vérifiez le domaine dont relève le nom d'hôte.
- Enregistrez le nom d'hôte sous Paramètres → Plateforme → Identité → Domaines de connexion. La page indique la cible CNAME vers laquelle le faire pointer.
- Créez l'enregistrement CNAME chez votre fournisseur DNS, puis sélectionnez Vérifier maintenant.
- Demandez à l'opérateur de votre déploiement d'ajouter le nom d'hôte au déploiement. Scrydon ne le sert qu'une fois que l'opérateur l'a ajouté et que la vérification CNAME réussit.
Sur votre domaine de connexion, les pages de connexion et leur cookie de session n'appartiennent qu'à cet hôte. Votre émetteur ne change pas : le document de découverte envoie le navigateur sur votre domaine de connexion pour se connecter, et vos applications continuent d'échanger les codes avec le point de terminaison de jeton du déploiement.
Scrydon revérifie chaque domaine de connexion tous les jours. Il cesse de servir l'hôte quand le CNAME ne pointe plus vers la cible, ou quand son domaine n'est plus vérifié.