Додавання Azure AD як провайдера SAML
Цей посібник пояснює, як дозволити користувачам входити до Casdoor через свій обліковий запис Azure AD (Microsoft Entra ID) за допомогою SAML.
Результати навчання
- Створіть корпоративний застосунок для Casdoor в Azure AD.
- Додайте Azure AD як SAML-провайдера в Casdoor.
- Призначте користувачів і перевірте вхід у систему.
Що вам знадобиться
- Тенант Azure AD з правами на створення корпоративних додатків
- Адміністраторський доступ до консолі адміністрування Casdoor
Створення корпоративного додатка
- У порталі Azure перейдіть до Azure Active Directory > Enterprise applications.
- Натисніть New application > Create your own application.
- Введіть назву, наприклад
Casdoor, виберіть Integrate any other application you don't find in the gallery (Non-gallery) і натисніть Create.
Налаштування єдиного входу (SSO)
-
У корпоративному додатку перейдіть до Single sign-on і виберіть SAML.
-
У розділі Basic SAML Configuration натисніть Edit і введіть:
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 надсилає відповідь через HTTP POST, що вимагається кінцевою точкою
/api/acs. -
Натисніть Save.
-
Залиште типові значення для Attributes & Claims або змініть їх:
Claim Default source Унікальний ідентифікатор користувача user.userprincipalnameemailaddress user.mailname user.userprincipalnameЯкщо атрибут імені користувача не зіставлено, Casdoor використовує електронну адресу або NameID твердження як ім'я користувача.
-
Завантажте Federation Metadata XML із розділу SAML Certificates. Або ж запишіть Certificate (Base64), а також у розділі Set up Casdoor: Login URL, Azure AD Identifier та Logout URL.
Додавання провайдера в Casdoor
- У консолі адміністрування Casdoor перейдіть до Identity > Providers і додайте провайдера.
- Встановіть Category як
SAMLі Type якCustom. - Вставте метадані федерації в поле Metadata і натисніть Parse.
- Збережіть провайдера.
- Відкрийте сторінку редагування вашого додатка, додайте провайдера на вкладці Providers і збережіть.
Призначення користувачів
У корпоративному додатку в Azure AD перейдіть до Users and groups і призначте користувачів або групи, які можуть входити в Casdoor.
Перевірка результату
Відкрийте сторінку входу додатка і натисніть кнопку Azure AD. Також можна протестувати з боку Azure AD за допомогою кнопки Test у конфігурації SAML.