将应用连接到 Microsoft Entra ID（Azure AD）

说明

Microsoft Entra ID 是 Azure Active Directory（Azure AD）的新名称。微软在 2023 年为该产品更名，现有的 Azure AD 配置和集成无需改动即可继续使用。本页面使用新名称，但您在较旧的管理台或文档中仍可能看到 "Azure AD" 的说法。

前提条件

1. 在这里创建一个 Microsoft Entra ID 账号
2. 完成 Quickstart: Set up a tenant 设置一个租户
3. 完成 Quickstart: Register an application with the Microsoft identity platform 注册一个应用

4. 选择 "Supported account types"，支持以下选项：

   • Single tenant only - <your tenant>（仅限该组织目录中的账号）
   • Multiple Entra ID tenants（任意组织目录中的账号 - 多租户）
   • Any Entra ID tenant + Personal Microsoft accounts（多租户及个人微软账号，例如 Skype、Xbox）

   目前还不支持 "Personal accounts only"。请记住所选的账号类型，因为这会影响 Authany 管理台上的配置 5. 将 "Redirect URI" 配置为 https://<YOUR_AUTHGEAR_ENDPOINT>/sso/oauth2/callback/azureadv2。参见 How to add a redirect URI to your application。 6. 按照这里的说明添加客户端密钥。添加客户端密钥时请务必记录密钥值，因为之后不会再次显示。在 Authany 中配置 OAuth 客户端时需要用到它。

说明

Redirect URI 的格式为 /sso/oauth2/callback/:oauth_provider_alias。oauth_provider_alias 是您在 Authany 管理台中为该提供方配置的 OAuth Provider Alias。

通过管理台配置使用 Microsoft 登录

1. 在管理台中，进入身份验证 > 社交 / 企业登录。
2. 启用使用 Microsoft 登录
3. 在客户端 ID 中填入刚创建的 Microsoft Entra ID 应用的 Application (client) ID。
4. 在客户端密钥中填入为 Microsoft Entra ID 应用创建客户端密钥后获得的密钥值。
5. 对于租户字段：
6. 如果选择了单租户（第一个选项），请填入 Microsoft Entra ID 应用的 Directory (tenant) ID。
7. 如果选择了多租户（第二个选项），请填入字符串 organizations。
8. 如果选择了多租户及个人账号（第三个选项），请填入字符串 common。
9. 保存设置。

🎉 完成！您已经为您的应用添加了 Microsoft Entra ID（Azure AD）登录！

强制显示登录页面

Microsoft Entra ID 会自动登录到同一个账号，而不要求输入用户名和密码。要阻止这种行为，您可以使用 prompt=login 参数强制 Microsoft Entra ID 显示登录页面。更多信息请参见 Authany SDK 中的使用 prompt=login 参数的指南。