使用 Microsoft 单点登录
需要余额 HTTP 隧道
本页内容 6 个章节
让访问者在打开 HTTP 隧道之前,先使用 Microsoft Entra ID 工作或学校账户,或个人 Microsoft 账户登录。你需要在 Microsoft Entra 中注册一个应用程序,把它作为提供商添加到 Localtonet,然后为隧道开启它。
开始之前 #
- 一条 HTTP 隧道,以及你账户中的余额。参见单点登录概览。
- 能够访问 Microsoft Entra 管理中心,并拥有可以注册应用程序的角色。Microsoft 给出的最低角色是 Application Developer。
- 确定谁可以登录:仅你的组织、任何组织,或者也包括个人账户。这会决定你在 Localtonet 中填写的其中两个地址。参见账户类型与端点。
步骤 #
-
在 Microsoft Entra 中注册应用程序 #
Microsoft 自己的指南有 Register an app in Microsoft Entra ID、Add a redirect URI 和 Add app credentials。简要步骤如下:
- 在 Microsoft Entra 管理中心,依次进入 Entra ID › App registrations,然后选择 New registration。
- 输入 Name。访问者登录时会看到它。
- 在 Supported account types 下选择谁可以使用该应用程序,然后选择 Register。
- 在 Overview 页面上,复制 Application (client) ID。对于单租户应用程序,还要复制 Directory (tenant) ID。
- 在 Manage 下打开 Authentication,选择 Add Redirect URI,选择 Web 平台,输入下面的重定向 URI,然后选择 Configure。
- 打开 Certificates & secrets › Client secrets,然后选择 New client secret。添加说明,选择有效期,然后选择 Add。请立即复制密钥的 Value:离开该页面后,Microsoft 不会再次显示它。
重定向 URI(平台:Web)http://auth.localtonet.com/auth/callback客户端密钥会过期。Microsoft 把它的有效期限制为 24 个月。过期后,登录将停止工作,直到你创建新的密钥并将其保存到 Localtonet 的提供商中。
-
在 Localtonet 中添加提供商 #
打开我的隧道 › HTTP,选择页面顶部的 SSO。在 SSO 提供商对话框中,选择添加提供商。
字段 值 提供商名称 任意名称,例如 Company Microsoft。你会在隧道设置中看到它。提供商类型 Microsoft。更改已保存提供商的类型会清空客户端 ID,因此请重新输入客户端 ID 和客户端密钥。 已启用 开 客户端 ID 来自 Microsoft Entra 的 Application (client) ID。 客户端密钥 密钥的 Value,而不是 Secret ID。保存后不会再显示。 打开端点与回调。这些值会自动填入:
字段 自动填入的值 是否需要更改? 授权端点 https://login.microsoftonline.com/common/oauth2/v2.0/authorize请根据下一节的表格替换 common。令牌端点 https://login.microsoftonline.com/common/oauth2/v2.0/token把 common替换为与上面相同的值。用户信息端点 https://graph.microsoft.com/oidc/userinfo不需要。它不包含租户。 回调路径 /auth/callback/microsoft不需要。 可选择填写邮箱访问规则,然后选择保存提供商。
-
为隧道开启它 #
在你的隧道下,选择隧道上的设置,然后选择SSO 提供商旁边的管理。在单点登录对话框中,开启要求登录和你的 Microsoft 提供商的开关。选择保存。
谁可以登录下的列表和登录路径是可选的。它们在概览中有说明。
-
测试 #
在无痕浏览器窗口中打开隧道 URL。Localtonet 会显示 Sign in to continue,并带有你的提供商的按钮。在 Microsoft 登录后,你会被送回隧道,你的服务随即加载。
账户类型与端点 #
Microsoft 地址中 login.microsoftonline.com/ 之后的部分决定谁可以登录。它必须与你的应用程序的 Supported account types 相符。授权端点和令牌端点始终取相同的值。用户信息端点永远不变。
| Microsoft Entra 中的 Supported account types | 替代 common 使用 | 谁可以登录 |
|---|---|---|
| Single tenant only | 你的 Directory (tenant) ID | 你自己租户的用户和来宾。 |
| Multiple Entra ID tenants | organizations | 任何组织的工作或学校账户。 |
| Any Entra ID Tenant + Personal Microsoft accounts | 保留 common | 工作或学校账户以及个人 Microsoft 账户。 |
| Personal accounts only | consumers | 个人 Microsoft 账户。 |
单租户应用程序的示例。请把 <TENANT_ID> 替换为你的 Directory (tenant) ID:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfo单租户应用程序不能使用 common。Microsoft 会返回错误 AADSTS50194。要么把你的租户 ID 填入两个端点,要么把应用程序改为多租户账户类型。
使用多租户或个人账户类型时,组织以外的人也可以在 Microsoft 登录。请在提供商上使用允许的邮箱域名,或在隧道上使用谁可以登录,只允许你想要的人。
Localtonet 从 Microsoft 读取什么 #
Microsoft 的用户信息端点只有在账户关联了邮箱地址时才会返回邮箱地址,因此没有邮箱地址的账户可能无法通过基于邮箱的规则。
故障排查 #
AADSTS50011:回复 URL 不匹配
请求中的重定向 URI 没有在该应用程序中注册。消息会显示发送的地址。它必须与应用注册的 Authentication 页面上、Web 平台下的某个重定向 URI 完全相同,包括大小写。请准确注册 http://auth.localtonet.com/auth/callback。
AADSTS50194:应用程序未配置为多租户应用程序
应用程序是单租户的,但端点中仍然包含 common。请在授权端点和令牌端点中把 common 替换为你的 Directory (tenant) ID,然后选择保存提供商。
AADSTS700016:在目录中找不到该应用程序
客户端 ID 有误,或者端点指向了一个不存在该应用程序的租户。请检查 Application (client) ID 以及端点中的租户 ID。
AADSTS7000215 或 AADSTS7000222:客户端密钥无效或已过期
在 Certificates & secrets 下创建新的客户端密钥,把它的 Value 粘贴到 Localtonet 的客户端密钥中,然后选择保存提供商。
Microsoft 要求管理员批准
你的租户不允许用户自行同意应用程序。租户的管理员必须在 Microsoft Entra 管理中心为该应用程序授予同意。
Microsoft 登录成功后出现“403 - Access Denied”
Localtonet 的某条规则拒绝了该账户。请检查提供商上的邮箱访问规则和隧道上的谁可以登录,以及该账户是否有邮箱地址。更正规则后,请等待一分钟再重新加载。