Se connecter aux applications SAML
Utilisez Scrydon comme fournisseur d'identité SAML 2.0 de votre organisation pour les applications qui ne parlent que SAML, et comme fournisseur d'identité fédéré d'un domaine Microsoft 365 dans Microsoft Entra ID.
Beaucoup d'applications, en particulier dans le secteur public, n'acceptent que SAML 2.0, et Microsoft Entra ID ne fédère un domaine qu'en SAML ou en WS-Federation. Pour celles-ci, Scrydon est aussi un fournisseur d'identité SAML : vos membres se connectent à Scrydon, et Scrydon envoie à l'application une assertion signée qui dit qui ils sont.
Votre organisation a son propre fournisseur d'identité. Il se trouve sous l'émetteur de votre organisation, avec ses propres certificats de signature. Aucune autre organisation ne partage son entité ni ses clés. Activez d'abord l'émetteur de votre organisation : tant qu'il est désactivé, les points de terminaison SAML répondent 404.
Tout ce qui suit se trouve sous Paramètres → Organisation → Applications, dans les onglets Apps SAML et Fournisseur d'identité SAML.
Seul un propriétaire ou un administrateur de l'organisation peut enregistrer ou modifier une application SAML. Chaque modification, et chaque assertion que Scrydon émet ou refuse, est consignée dans le journal d'audit.
Les valeurs de votre fournisseur d'identité
Une application vous les demandera. Copiez-les depuis l'onglet Fournisseur d'identité SAML ; ne les tapez jamais à la main.
| Valeur | Où |
|---|---|
| Identifiant d'entité (émetteur) | <l'émetteur de votre organisation> |
| Métadonnées | <entité>/saml/metadata |
| Authentification unique | <entité>/saml/sso (HTTP-Redirect et HTTP-POST) |
| Déconnexion unique | <entité>/saml/slo (HTTP-Redirect) |
La plupart des applications n'ont besoin que de l'URL des métadonnées : elle contient l'identifiant d'entité, les deux points de terminaison et les certificats de signature.
Enregistrer une application
Dans l'onglet Apps SAML, sélectionnez Enregistrer une app SAML. Enregistrez une application à partir de ses propres métadonnées SAML, sous forme de fichier téléversé ou d'URL que Scrydon récupère. Scrydon y lit son identifiant d'entité, ses URL de service consommateur d'assertions (ACS), son URL de déconnexion et le certificat avec lequel elle signe ses requêtes.
- Chaque URL ACS et de déconnexion doit être en
https://. - Une URL de métadonnées doit être publique. Scrydon ne récupère pas une adresse privée, de bouclage ou de lien local.
- Un fichier de métadonnées est limité à 512 Kio, et un fichier qui contient
un
DOCTYPEest refusé.
Choisissez ensuite :
- Qui peut se connecter. Tous les membres de votre organisation, ou seulement les équipes et les personnes que vous attribuez. Cela fonctionne comme pour les applications OIDC ; voir Qui peut utiliser une application.
- Exiger des requêtes signées. Activé par défaut : Scrydon refuse une requête d'authentification que l'application n'a pas signée avec le certificat de ses métadonnées. Ne le désactivez que pour une application incapable de signer.
- Autoriser la connexion initiée par l'IdP. Désactivée par défaut. Quand elle est activée, un membre peut lancer la connexion depuis Scrydon, et la réponse ne répond à aucune requête.
Ce que Scrydon envoie
-
Une assertion signée, en RSA-SHA256 avec une clé de 3072 bits. Scrydon ne signe jamais en SHA-1 et refuse une requête signée en SHA-1.
-
Un NameID persistant : une valeur stable et opaque pour ce membre dans cette application. Ce n'est pas l'adresse e-mail du membre, et deux applications reçoivent des valeurs différentes pour le même membre.
-
L'audience et le destinataire de la seule application et de la seule URL ACS qui ont fait la demande. Chaque requête ne sert qu'une fois : la rejouer est refusé.
-
Un contexte d'authentification qui dit comment le membre s'est connecté :
Comment le membre s'est connecté AuthnContextClassRefMot de passe urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransportCertificat comme seul facteur urn:oasis:names:tc:SAML:2.0:ac:classes:X509Deux facteurs https://refeds.org/profile/mfaCarte à puce urn:oasis:names:tc:SAML:2.0:ac:classes:SmartcardPKIClé d'accès (passkey) urn:scrydon:acr:phishing_resistant
Quand une requête porte ForceAuthn="true" et que le membre s'est connecté
avant elle, Scrydon lui demande de se reconnecter.
Qui est refusé
Scrydon n'émet rien, et consigne le refus, quand le membre :
- n'est pas membre de votre organisation ;
- n'est pas attribué à l'application ;
- est suspendu ;
- s'est connecté en dessous du niveau de connexion minimal de votre organisation. Scrydon répond par un refus ; il ne lui demande pas de se reconnecter avec un niveau plus élevé.
Certificats de signature
Votre fournisseur d'identité conserve deux certificats : le certificat actuel, qui signe, et le suivant, déjà présent dans les métadonnées. Une application qui actualise vos métadonnées fait confiance au certificat suivant avant qu'il ne signe quoi que ce soit : la rotation ne provoque donc aucune interruption.
- Faire tourner le certificat fait du certificat suivant le certificat actuel et en crée un nouveau suivant. L'ancien certificat sort des métadonnées.
- Retirer supprime un certificat immédiatement. Les applications qui ne font confiance qu'à ce certificat n'acceptent plus de connexion tant qu'elles n'ont pas chargé vos nouvelles métadonnées.
Chaque certificat est valable un an. Les clés privées ne quittent jamais Scrydon.
Une application qui conserve un certificat au lieu de lire vos métadonnées, Microsoft Entra ID compris, doit recevoir le nouveau certificat avant la rotation. Entra accepte un certificat de signature suivant exactement pour cela.
Fédérer un domaine Microsoft 365 avec Entra ID
Vos membres peuvent alors se connecter à Microsoft 365 avec Scrydon. Enregistrez l'application avec le profil Microsoft Entra ID et indiquez les domaines à fédérer sous Domaines fédérés. Chaque domaine doit être :
- un domaine vérifié de votre organisation ;
- un domaine dont les membres se connectent avec Scrydon lui-même. Un domaine dont les membres se connectent via un autre fournisseur d'identité les enverrait en boucle entre Scrydon et Entra : Scrydon le refuse donc.
Avec ce profil :
- le NameID est l'
ImmutableIDEntra du membre ; - l'attribut
IDPEmailporte son nom d'utilisateur principal (UPN), l'adresse sous laquelle Microsoft 365 le connaît. Un membre dont l'UPN n'est pas sur un domaine fédéré est refusé, plutôt que d'être connecté comme quelqu'un d'autre ou comme personne ; - chaque connexion à deux facteurs, par carte à puce ou par clé d'accès est
envoyée comme
http://schemas.microsoft.com/claims/multipleauthn.
L'onglet Microsoft Entra de l'application indique ce qu'il faut configurer sur le domaine dans Entra
(internalDomainFederation dans Microsoft Graph) :
| Paramètre Entra | Valeur |
|---|---|
issuerUri | votre identifiant d'entité |
passiveSignInUri | votre URL d'authentification unique |
signOutUri | votre URL de déconnexion unique |
metadataExchangeUri | votre URL de métadonnées |
signingCertificate | le certificat actuel |
nextSigningCertificate | le certificat suivant |
preferredAuthenticationProtocol | saml |
federatedIdpMfaBehavior | enforceMfaByFederatedIdp |
isSignedAuthenticationRequestRequired | true |
promptLoginBehavior | nativeSupport |
Convertir un domaine en domaine fédéré change la façon dont tout le monde sur ce domaine se connecte à Microsoft 365, et Microsoft prévient que la modification peut mettre jusqu'à deux heures à prendre effet. Essayez d'abord sur un domaine de test, gardez un administrateur général cloud-only dont le compte n'est pas sur ce domaine, et planifiez la modification avec votre contact Scrydon. Scrydon vous demande de confirmer que ce compte existe avant de basculer le domaine.
Avant de fédérer
Sur l'onglet Microsoft Entra, au-dessus de Configurer dans Entra, une liste intitulée Avant de fédérer indique ce qui doit être en place avant de basculer un domaine. Elle porte un compteur, par exemple « 3 sur 8 prêts », et une commande Revérifier. Scrydon ne fait que lire : la liste ne modifie rien dans Scrydon ni dans Entra.
Chaque ligne affiche Prêt, À faire, À traiter ou Non vérifié. Non vérifié signifie que Scrydon n'a pas encore pu lire ce fait. Une ligne qui n'est pas prête renvoie vers l'écran qui permet de la corriger. Quand les huit lignes sont prêtes, le titre devient Prêt à fédérer.
Six lignes sont lues depuis les paramètres de votre organisation :
| Exigence | Ce que cela signifie | Où la corriger |
|---|---|---|
| L'émetteur de l'organisation est activé | Sans lui, Scrydon n'a rien avec quoi signer. | Paramètres → Plateforme → Identité → Émetteur |
| Le domaine est un domaine vérifié de l'organisation | Seul un domaine vérifié peut être fédéré. | Paramètres → Plateforme → Identité → Domaines |
| Le niveau de connexion minimal est Deux facteurs ou plus | Microsoft reçoit l'instruction de faire confiance à Scrydon pour le second facteur ; Scrydon doit donc en exiger un. Voir niveau de connexion. | Paramètres → Gouvernance → Identité, Exigences d'authentification |
| L'application exige des requêtes signées | Scrydon demande à Entra de signer ses requêtes. Avec Exiger des requêtes signées activé, une requête non signée est refusée. | L'onglet Paramètres de l'application |
| Des personnes ont accès à l'application | Une personne sans accès est refusée quand Microsoft l'envoie vers Scrydon. | L'onglet Accès de l'application |
| Les certificats de signature sont valables plus de 30 jours | Un certificat qui se termine plus tôt demande votre attention. Faites-le tourner avant de basculer. | Paramètres → Organisation → Applications → Fournisseur d'identité SAML |
Deux lignes sont lues depuis Microsoft Entra, via une connexion Microsoft :
| Exigence | Ce que cela signifie | Où la corriger |
|---|---|---|
| Une connexion Microsoft a l'autorisation de fédération de domaine Entra | L'autorisation est Domain-InternalFederation.ReadWrite.All, accordée par un administrateur général. Scrydon ne peut pas lister les autorisations d'une connexion : la ligne devient prête quand il peut lire le domaine via la connexion. | L'extension Microsoft, sous Paramètres → Plateforme → Extensions |
| Le domaine est un domaine du locataire Entra et se connecte toujours avec Microsoft Entra | Scrydon lit comment le domaine se connecte. Un domaine qui se connecte via un autre fournisseur d'identité demande votre attention. | Dans Microsoft Entra |
Si le domaine se connecte via un autre fournisseur d'identité, rebasculez-le d'abord vers Entra dans Microsoft. Scrydon ne reprend jamais un domaine fédéré ailleurs. Si Microsoft refuse la lecture, la ligne affiche la réponse de Microsoft. Les causes habituelles sont une connexion sans l'autorisation et un domaine qui ne fait pas partie de ce locataire. La ligne ne peut pas les distinguer : elle nomme donc les deux.
Deux éléments que Scrydon ne peut pas voir figurent sous À confirmer par vous. La boîte de dialogue de confirmation vous demande de cocher les deux avant d'envoyer la modification :
- Un administrateur général cloud-only existe en dehors du domaine. C'est votre
moyen de vous reconnecter si la connexion via Scrydon échoue, par exemple un
compte sur le domaine
onmicrosoft.comde votre locataire. - Les personnes auxquelles vous avez donné accès existent dans Entra avec un
ImmutableIDcorrespondant. Scrydon l'envoie comme NameID, et une personne sans correspondance ne peut pas se connecter. Avec le provisionnement activé, Scrydon crée les comptes avec cette valeur.
Le bouton Se connecter via Scrydon est visible dès le départ. Il reste désactivé tant que les huit lignes ne sont pas prêtes, et le nombre d'exigences encore ouvertes s'affiche à côté.
Quand Entra indique que le domaine se connecte via Scrydon, la liste devient Tant que la fédération est active, ces conditions doivent rester remplies. Elle compte six lignes : l'émetteur, le domaine vérifié, le niveau de connexion, les requêtes signées, les certificats de signature, et le fait qu'Entra détient les certificats actuels de cette organisation. Quand Entra détient des certificats plus anciens que ceux avec lesquels l'organisation signe, cette ligne demande votre attention et porte une action Mettre à jour les certificats. La zone ci-dessous propose Revenir à Entra.
La liste est un guide dans cet écran. Elle ne vérifie ni ne bloque les valeurs que vous saisissez à la main dans Microsoft Entra.
Configurer dans Entra
Au lieu de saisir les valeurs Entra à la main, vous pouvez laisser Scrydon les configurer. C'est facultatif, et Scrydon ne modifie rien dans votre locataire tant que vous ne le demandez pas.
- Connectez l'extension Microsoft et accordez son autorisation
Fédération de domaine Entra (
Domain-InternalFederation.ReadWrite.All). Un administrateur général doit y consentir. Elle est distincte des autres autorisations de l'extension : vous pouvez l'accorder pour la modification et la retirer ensuite. - Dans l'onglet Microsoft Entra de l'application, sous Configurer dans Entra, choisissez la connexion et un domaine fédéré. L'onglet lit auprès de Microsoft comment le domaine se connecte dès que les deux sont choisis. Avec une seule connexion, c'est à l'ouverture de l'onglet, pour le premier domaine de l'application. Vérifier la connexion et Revérifier le relisent.
- Scrydon indique comment le domaine se connecte aujourd'hui et propose la
modification adaptée :
- se connecte avec Microsoft Entra : Se connecter via Scrydon. Le bouton reste désactivé tant que les huit lignes de la liste ci-dessus ne sont pas prêtes ;
- se connecte via Scrydon : Revenir à Entra, et Mettre à jour les certificats quand Entra détient des certificats plus anciens que ceux avec lesquels Scrydon signe (à faire avant et après la rotation d'un certificat) ;
- se connecte via un autre fournisseur d'identité : rien, et sa ligne demande votre attention. Scrydon ne reprend jamais un domaine fédéré ailleurs ; rebasculez-le d'abord vers Entra dans Microsoft.
- Confirmez. Pour vous connecter via Scrydon, la boîte de dialogue vous demande d'abord de cocher les deux éléments sous À confirmer par vous. Microsoft peut mettre jusqu'à deux heures pour appliquer la modification ; vérifiez la connexion plus tard.
Scrydon n'envoie que les valeurs et les certificats propres à votre
organisation, et consigne chaque demande dans votre journal d'audit
(saml_idp.entra_domain.federation_requested,
saml_idp.entra_domain.switch_back_requested) avant d'appeler Microsoft. Seul
un propriétaire ou un administrateur de l'organisation peut faire la
modification, et uniquement depuis cet écran : les scripts, notebooks et
agents peuvent lire la fédération d'un domaine via l'extension Microsoft, mais
pas la modifier.
Ce que cela ne couvre pas :
- Seuls les clients à authentification moderne se connectent. Les anciens clients Office et les protocoles qui exigent WS-Trust ou ECP ne le font pas.
- Scrydon ne chiffre pas les assertions.
- Se déconnecter d'une application ne déconnecte pas le membre des autres.