Перейти до основного вмісту

Додавання Azure AD як провайдера SAML

Цей посібник пояснює, як дозволити користувачам входити до Casdoor через свій обліковий запис Azure AD (Microsoft Entra ID) за допомогою SAML.


Результати навчання​

  • Створіть корпоративний застосунок для Casdoor в Azure AD.
  • Додайте Azure AD як SAML-провайдера в Casdoor.
  • Призначте користувачів і перевірте вхід у систему.

Що вам знадобиться​

  • Тенант Azure AD з правами на створення корпоративних додатків
  • Адміністраторський доступ до консолі адміністрування Casdoor

Створення корпоративного додатка​

  1. У порталі Azure перейдіть до Azure Active Directory > Enterprise applications.
  2. Натисніть New application > Create your own application.
  3. Введіть назву, наприклад Casdoor, виберіть Integrate any other application you don't find in the gallery (Non-gallery) і натисніть Create.

Налаштування єдиного входу (SSO)​

  1. У корпоративному додатку перейдіть до Single sign-on і виберіть SAML.

  2. У розділі Basic SAML Configuration натисніть Edit і введіть:

    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 надсилає відповідь через HTTP POST, що вимагається кінцевою точкою /api/acs.

  3. Натисніть Save.

  4. Залиште типові значення для Attributes & Claims або змініть їх:

    ClaimDefault source
    Унікальний ідентифікатор користувачаuser.userprincipalname
    emailaddressuser.mail
    nameuser.userprincipalname

    Якщо атрибут імені користувача не зіставлено, Casdoor використовує електронну адресу або NameID твердження як ім'я користувача.

  5. Завантажте Federation Metadata XML із розділу SAML Certificates. Або ж запишіть Certificate (Base64), а також у розділі Set up Casdoor: Login URL, Azure AD Identifier та Logout URL.

Додавання провайдера в Casdoor​

  1. У консолі адміністрування Casdoor перейдіть до Identity > Providers і додайте провайдера.
  2. Встановіть Category як SAML і Type як Custom.
  3. Вставте метадані федерації в поле Metadata і натисніть Parse.
  4. Збережіть провайдера.
  5. Відкрийте сторінку редагування вашого додатка, додайте провайдера на вкладці Providers і збережіть.

Призначення користувачів​

У корпоративному додатку в Azure AD перейдіть до Users and groups і призначте користувачів або групи, які можуть входити в Casdoor.

Перевірка результату​

Відкрийте сторінку входу додатка і натисніть кнопку Azure AD. Також можна протестувати з боку Azure AD за допомогою кнопки Test у конфігурації SAML.

Див. також​