添加 Azure AD 作为 SAML 提供商
本指南介绍如何允许用户通过 SAML 使用其 Azure AD (Microsoft Entra ID) 账户登录 Casdoor。
学习目标
- 在 Azure AD 中为 Casdoor 创建一个企业应用程序。
- 在 Casdoor 中添加 Azure AD 作为 SAML 提供商。
- 分配用户并测试登录。
所需条件
- 具有创建企业应用程序权限的 Azure AD 租户
- Casdoor 管理控制台的管理员访问权限
创建企业应用程序
- 在 Azure portal(Azure 门户)中,前往 Azure Active Directory > Enterprise applications(企业应用程序)。
- 单击新建应用程序 > 创建自己的应用程序。
- 输入名称(例如
Casdoor),选择 Integrate any other application you don't find in the gallery (Non-gallery)(集成其他未在库中找到且非库中的应用),然后点击 Create(创建)。
配置单点登录
-
在企业应用程序中,前往 Single sign-on(单点登录)并选择 SAML。
-
在 Basic SAML Configuration(基本 SAML 配置)中,点击 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端点所要求的。 -
单击保存。
-
保持默认的 Attributes & Claims(属性与声明),或进行更改:
Claim Default source Unique User Identifier user.userprincipalnameemailaddress user.mailname user.userprincipalname如果没有映射用户名属性,Casdoor 将使用电子邮件地址或断言中的 NameID 作为用户名。
-
从 SAML Certificates(SAML 证书)部分下载 Federation Metadata XML(联合元数据 XML)。或者,记录 Certificate (Base64)(证书 Base64)以及在 Set up Casdoor(设置 Casdoor)部分中的 Login URL(登录 URL)、Azure AD Identifier(Azure AD 标识符)和 Logout URL(注销 URL)。
在 Casdoor 中添加提供商
- 在 Casdoor 管理控制台中,前往 Identity(身份) > Providers(提供商)并添加一个提供商。
- 将 Category(类别)设置为
SAML,将 Type(类型)设置为Custom(自定义)。 - 将联合元数据粘贴到 Metadata(元数据)字段中,然后点击 Parse(解析)。
- 保存提供商.
- 打开你的应用编辑页面,在 Providers(提供商)选项卡中添加该提供商,然后保存。
分配用户
在 Azure AD 的企业应用中,转到 Users and groups 并分配可以登录到 Casdoor 的用户或组。
验证结果
打开应用的登录页面并点击 Azure AD 按钮。您也可以通过 SAML 配置中的 Test 按钮从 Azure AD 进行测试。