跳到内容
Localtonet Localtonet 控制台

使用 Google 单点登录

需要余额 HTTP 隧道

获取本页帮助
本页内容 4 个章节
  1. 开始之前
  2. 步骤
  3. 在 Google Cloud 中创建 OAuth 客户端
  4. 在 Localtonet 中添加提供商
  5. 为隧道开启它
  6. 测试
  7. 故障排除
  8. 相关页面

让访问者先用自己的 Google 账户登录,才能打开 HTTP 隧道。你需要在 Google Cloud 中创建一个 OAuth 客户端,把它作为提供商添加到 Localtonet,然后为隧道开启它。

开始之前 #

步骤 #

  1. 在 Google Cloud 中创建 OAuth 客户端 #

    Google 会不时更改它的控制台。它自己的指南是 Manage OAuth Clients。简要步骤如下:

    1. 在 Google Cloud 控制台中,为你的项目打开 Google Auth Platform。如果项目是新的,控制台会要求你先设置应用:应用名称、支持邮箱、受众和联系信息。
    2. 在 Audience 下,选择谁可以登录。参见下表。
    3. 打开 Clients,选择 Create client。
    4. 把 Application type 设为 Web application,并为客户端命名。
    5. 在 Authorized redirect URIs 下,添加下面的重定向 URI。Authorized JavaScript origins 可以留空。
    6. 选择 Create,然后复制 Client ID 和 Client secret。Google 只会在这一刻显示完整的密钥。
    Authorized redirect URI
    http://auth.localtonet.com/auth/callback
    Google 中的受众谁可以登录
    Internal只有你的 Google Cloud 组织的成员。
    External,发布状态为 Testing你在 Google 中列出的测试用户,最多 100 个。对于只请求用户姓名、邮箱地址和个人资料的应用,Google 有一个例外:此时用户不必在名单中。不要依赖测试用户名单来阻止他人;请使用 Localtonet 的访问规则。
    External,发布状态为 In production任何拥有 Google 账户的人。请使用 Localtonet 的访问规则来缩小范围。

    登录请求会申请 openid、email 和 profile 这几个范围(scope)。如果 Google 要求你为应用选择范围,这三个就足够了。

    Google 表示,对客户端的更改可能需要 5 分钟到几个小时才会生效。

  2. 在 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。然后选择保存提供商。

  3. 为隧道开启它 #

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

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

  4. 测试 #

    在浏览器的隐私窗口中打开隧道 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 按钮

该提供商没有为此隧道开启,或者被设置为未启用。请检查这两处。

支持