跳到主内容

添加 Azure AD 作为 SAML 提供商

本指南介绍如何允许用户通过 SAML 使用其 Azure AD (Microsoft Entra ID) 账户登录 Casdoor。


学习目标​

  • 在 Azure AD 中为 Casdoor 创建一个企业应用程序。
  • 在 Casdoor 中添加 Azure AD 作为 SAML 提供商。
  • 分配用户并测试登录。

所需条件​

  • 具有创建企业应用程序权限的 Azure AD 租户
  • Casdoor 管理控制台的管理员访问权限

创建企业应用程序​

  1. 在 Azure portal(Azure 门户)中,前往 Azure Active Directory > Enterprise applications(企业应用程序)。
  2. 单击新建应用程序 > 创建自己的应用程序。
  3. 输入名称(例如 Casdoor),选择 Integrate any other application you don't find in the gallery (Non-gallery)(集成其他未在库中找到且非库中的应用),然后点击 Create(创建)。

配置单点登录​

  1. 在企业应用程序中,前往 Single sign-on(单点登录)并选择 SAML。

  2. 在 Basic SAML Configuration(基本 SAML 配置)中,点击 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. 单击保存。

  4. 保持默认的 Attributes & Claims(属性与声明),或进行更改:

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

    如果没有映射用户名属性,Casdoor 将使用电子邮件地址或断言中的 NameID 作为用户名。

  5. 从 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 中添加提供商​

  1. 在 Casdoor 管理控制台中,前往 Identity(身份) > Providers(提供商)并添加一个提供商。
  2. 将 Category(类别)设置为 SAML,将 Type(类型)设置为 Custom(自定义)。
  3. 将联合元数据粘贴到 Metadata(元数据)字段中,然后点击 Parse(解析)。
  4. 保存提供商.
  5. 打开你的应用编辑页面,在 Providers(提供商)选项卡中添加该提供商,然后保存。

分配用户​

在 Azure AD 的企业应用中,转到 Users and groups 并分配可以登录到 Casdoor 的用户或组。

验证结果​

打开应用的登录页面并点击 Azure AD 按钮。您也可以通过 SAML 配置中的 Test 按钮从 Azure AD 进行测试。

另请参阅​