使用 Google 单点登录
需要余额 HTTP 隧道
本页内容 4 个章节
让访问者先用自己的 Google 账户登录,才能打开 HTTP 隧道。你需要在 Google Cloud 中创建一个 OAuth 客户端,把它作为提供商添加到 Localtonet,然后为隧道开启它。
开始之前 #
- 一个 HTTP 隧道,并且你的账户有余额。参见单点登录概述。
- 一个可以访问 Google Cloud 控制台的 Google 账户,以及其中的一个项目。
步骤 #
-
在 Google Cloud 中创建 OAuth 客户端 #
Google 会不时更改它的控制台。它自己的指南是 Manage OAuth Clients。简要步骤如下:
- 在 Google Cloud 控制台中,为你的项目打开 Google Auth Platform。如果项目是新的,控制台会要求你先设置应用:应用名称、支持邮箱、受众和联系信息。
- 在 Audience 下,选择谁可以登录。参见下表。
- 打开 Clients,选择 Create client。
- 把 Application type 设为 Web application,并为客户端命名。
- 在 Authorized redirect URIs 下,添加下面的重定向 URI。Authorized JavaScript origins 可以留空。
- 选择 Create,然后复制 Client ID 和 Client secret。Google 只会在这一刻显示完整的密钥。
Authorized redirect URIhttp://auth.localtonet.com/auth/callbackGoogle 中的受众 谁可以登录 Internal 只有你的 Google Cloud 组织的成员。 External,发布状态为 Testing 你在 Google 中列出的测试用户,最多 100 个。对于只请求用户姓名、邮箱地址和个人资料的应用,Google 有一个例外:此时用户不必在名单中。不要依赖测试用户名单来阻止他人;请使用 Localtonet 的访问规则。 External,发布状态为 In production 任何拥有 Google 账户的人。请使用 Localtonet 的访问规则来缩小范围。 登录请求会申请
openid、email和profile这几个范围(scope)。如果 Google 要求你为应用选择范围,这三个就足够了。Google 表示,对客户端的更改可能需要 5 分钟到几个小时才会生效。
-
在 Localtonet 中添加提供商 #
打开 我的隧道 › HTTP,选择页面顶部的 SSO。在 SSO 提供商对话框中,选择添加提供商。
字段 值 提供商名称 任意名称,例如 Company Google。你会在隧道设置中看到它。提供商类型 Google。更改已保存提供商的类型会清空客户端 ID,因此请重新输入客户端 ID 和客户端密钥。 已启用 开 客户端 ID 来自 Google 的客户端 ID。 客户端密钥 来自 Google 的客户端密钥。保存后不会再显示。 在端点与回调下,标准的 Google 地址会自动填入。请保持原样:
字段 自动填入的值 授权端点 https://accounts.google.com/o/oauth2/v2/auth令牌端点 https://oauth2.googleapis.com/token用户信息端点 https://openidconnect.googleapis.com/v1/userinfo回调路径 /auth/callback/google可选:填写邮箱访问规则。若只允许你的公司,请在允许的邮箱域名下输入它的域名,例如
example.com。然后选择保存提供商。 -
为隧道开启它 #
在你的隧道下,选择该隧道的设置,然后选择 SSO 提供商旁边的管理。在单点登录对话框中,开启要求登录以及你的 Google 提供商的开关。选择保存。
谁可以登录下的列表和登录路径是可选的。它们在概述中有说明。
-
测试 #
在浏览器的隐私窗口中打开隧道 URL。Localtonet 会显示 Sign in to continue,并带有你的提供商的按钮。在 Google 登录后,你会被送回隧道,你的服务随即加载。
故障排除 #
Google 报告 redirect_uri_mismatch
请求中的重定向 URI 不是该客户端的 Authorized redirect URIs 之一。请把 http://auth.localtonet.com/auth/callback 原样添加到 Google 中的客户端,并留出一些时间让更改生效。
Google 控制台不接受该重定向 URI
Google 会按照它的验证规则检查重定向 URI。字段旁边的消息会指出未通过的规则。
Google 拒绝该账户,例如返回 org_internal
Google 在 Localtonet 看到账户之前就拒绝了它。受众为 Internal 时,只有你组织的成员可以登录,对其他所有人 Google 都会报告 org_internal。如果是处于 Testing 状态的 External,请检查 Google 中的测试用户名单。
Google 报告 invalid_client
Google 不接受该客户端。请检查 Localtonet 中保存的客户端 ID和客户端密钥,并确认该客户端在 Google 中仍然存在。请重新粘贴两者,然后选择保存提供商。如果你已不再保存密钥,请在 Google 中创建一个新的。
Google 登录成功后出现 “403 - Access Denied”
某条 Localtonet 规则拒绝了该账户。请把访问者登录所用的地址,与该提供商的允许的邮箱域名、阻止的邮箱域名和阻止的邮箱地址,以及隧道上的谁可以登录进行比对。
登录页面上没有 Google 按钮
该提供商没有为此隧道开启,或者被设置为未启用。请检查这两处。