跳到内容
Localtonet Localtonet 控制台

使用 Microsoft 单点登录

需要余额 HTTP 隧道

获取本页帮助
本页内容 6 个章节
  1. 开始之前
  2. 步骤
  3. 在 Microsoft Entra 中注册应用程序
  4. 在 Localtonet 中添加提供商
  5. 为隧道开启它
  6. 测试
  7. 账户类型与端点
  8. Localtonet 从 Microsoft 读取什么
  9. 故障排查
  10. 相关页面

让访问者在打开 HTTP 隧道之前,先使用 Microsoft Entra ID 工作或学校账户,或个人 Microsoft 账户登录。你需要在 Microsoft Entra 中注册一个应用程序,把它作为提供商添加到 Localtonet,然后为隧道开启它。

开始之前 #

  • 一条 HTTP 隧道,以及你账户中的余额。参见单点登录概览。
  • 能够访问 Microsoft Entra 管理中心,并拥有可以注册应用程序的角色。Microsoft 给出的最低角色是 Application Developer。
  • 确定谁可以登录:仅你的组织、任何组织,或者也包括个人账户。这会决定你在 Localtonet 中填写的其中两个地址。参见账户类型与端点。

步骤 #

  1. 在 Microsoft Entra 中注册应用程序 #

    Microsoft 自己的指南有 Register an app in Microsoft Entra ID、Add a redirect URI 和 Add app credentials。简要步骤如下:

    1. 在 Microsoft Entra 管理中心,依次进入 Entra ID › App registrations,然后选择 New registration。
    2. 输入 Name。访问者登录时会看到它。
    3. 在 Supported account types 下选择谁可以使用该应用程序,然后选择 Register。
    4. 在 Overview 页面上,复制 Application (client) ID。对于单租户应用程序,还要复制 Directory (tenant) ID。
    5. 在 Manage 下打开 Authentication,选择 Add Redirect URI,选择 Web 平台,输入下面的重定向 URI,然后选择 Configure。
    6. 打开 Certificates & secrets › Client secrets,然后选择 New client secret。添加说明,选择有效期,然后选择 Add。请立即复制密钥的 Value:离开该页面后,Microsoft 不会再次显示它。
    重定向 URI(平台:Web)
    http://auth.localtonet.com/auth/callback

    客户端密钥会过期。Microsoft 把它的有效期限制为 24 个月。过期后,登录将停止工作,直到你创建新的密钥并将其保存到 Localtonet 的提供商中。

  2. 在 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不需要。

    可选择填写邮箱访问规则,然后选择保存提供商。

  3. 为隧道开启它 #

    在你的隧道下,选择隧道上的设置,然后选择SSO 提供商旁边的管理。在单点登录对话框中,开启要求登录和你的 Microsoft 提供商的开关。选择保存。

    谁可以登录下的列表和登录路径是可选的。它们在概览中有说明。

  4. 测试 #

    在无痕浏览器窗口中打开隧道 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 tenantsorganizations任何组织的工作或学校账户。
Any Entra ID Tenant + Personal Microsoft accounts保留 common工作或学校账户以及个人 Microsoft 账户。
Personal accounts onlyconsumers个人 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 的某条规则拒绝了该账户。请检查提供商上的邮箱访问规则和隧道上的谁可以登录,以及该账户是否有邮箱地址。更正规则后,请等待一分钟再重新加载。

支持