Passer au contenu principal

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​

  1. Dans le portail Azure, accédez à Azure Active Directory > Enterprise applications.
  2. Cliquez sur New application > Create your own application.
  3. 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​

  1. Dans l'application d'entreprise, accédez à Single sign-on et sélectionnez SAML.

  2. Dans Basic SAML Configuration, cliquez sur Edit et saisissez les éléments suivants :

    FieldValue
    Identifier (Entity ID)https://<your-casdoor-domain>/api/acs, for example https://door.example.com/api/acs
    Reply 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.

  3. Cliquez sur Save.

  4. Conservez les valeurs par défaut de Attributes & Claims, ou modifiez-les :

    ClaimDefault source
    Unique User Identifieruser.userprincipalname
    emailaddressuser.mail
    nameuser.userprincipalname

    Si 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.

  5. 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​

  1. Dans la console d'administration de Casdoor, accédez à Identity > Providers et ajoutez un fournisseur.
  2. Définissez Category sur SAML et Type sur Custom.
  3. Collez les métadonnées de fédération dans le champ Metadata et cliquez sur Parse.
  4. Enregistrez le fournisseur.
  5. 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.

Voir aussi​