Ajouter Azure AD comme fournisseur SAML
Ce guide explique comment permettre aux utilisateurs de se connecter à Casdoor avec leur compte Azure AD (Microsoft Entra ID) via SAML.
Objectifs d'apprentissage
- Créez une application d'entreprise pour Casdoor dans Azure AD.
- Ajoutez Azure AD en tant que fournisseur SAML dans Casdoor.
- Attribuez des utilisateurs et testez la connexion.
Prérequis
- Un locataire Azure AD disposant des droits nécessaires pour créer des applications d'entreprise
- Accès administrateur à la console d'administration de Casdoor
Créer une application d'entreprise
- Dans le portail Azure, accédez à Azure Active Directory > Enterprise applications.
- Cliquez sur New application > Create your own application.
- Saisissez un nom, par exemple
Casdoor, sélectionnez Integrate any other application you don't find in the gallery (Non-gallery), puis cliquez sur Create.
Configurer l'authentification unique
-
Dans l'application d'entreprise, accédez à Single sign-on et sélectionnez SAML.
-
Dans Basic SAML Configuration, cliquez sur Edit et saisissez les éléments suivants :
Field Value Identifier (Entity ID) https://<your-casdoor-domain>/api/acs, for examplehttps://door.example.com/api/acsReply URL (Assertion Consumer Service URL) The same URL Azure AD envoie la réponse via HTTP POST, ce qui est requis par le point de terminaison
/api/acs. -
Cliquez sur Save.
-
Conservez les valeurs par défaut de Attributes & Claims, ou modifiez-les :
Claim Default source Unique User Identifier user.userprincipalnameemailaddress user.mailname user.userprincipalnameSi aucun attribut de nom d'utilisateur n'est mappé, Casdoor utilise l'adresse e-mail ou le NameID de l'assertion comme nom d'utilisateur.
-
Téléchargez le fichier Federation Metadata XML depuis la section SAML Certificates. Alternativement, notez le Certificate (Base64) ainsi que, dans la section Set up Casdoor, l'Login URL, l'Azure AD Identifier et l'Logout URL.
Ajouter le fournisseur dans Casdoor
- Dans la console d'administration de Casdoor, accédez à Identity > Providers et ajoutez un fournisseur.
- Définissez Category sur
SAMLet Type surCustom. - Collez les métadonnées de fédération dans le champ Metadata et cliquez sur Parse.
- Enregistrez le fournisseur.
- Ouvrez la page de modification de votre application, ajoutez le fournisseur dans l'onglet Providers, puis enregistrez.
Attribuer des utilisateurs
Dans l'application d'entreprise dans Azure AD, accédez à Users and groups et attribuez les utilisateurs ou groupes autorisés à se connecter à Casdoor.
Vérifier le résultat
Ouvrez la page de connexion de l'application et cliquez sur le bouton Azure AD. Vous pouvez également effectuer un test depuis Azure AD avec le bouton Test de la configuration SAML.