使用 GitLab 的单点登录
需要余额 HTTP 隧道
本页内容 4 个章节
让访问者先用自己的 GitLab 账户登录,才能打开 HTTP 隧道。它适用于 GitLab.com 和自托管的 GitLab 实例。你需要在 GitLab 中创建一个 OAuth 应用,把它作为提供商添加到 Localtonet,然后为隧道启用它。
开始之前 #
- 一个 HTTP 隧道,以及你账户中的余额。参见单点登录概览。
- GitLab.com 或你自己实例上的 GitLab 账户。
- 对于自托管实例:它的地址必须能从互联网访问。你的访问者的浏览器会打开它的登录页面,而 Localtonet 的登录主机会直接调用它的令牌端点和用户端点。
步骤 #
-
在 GitLab 中创建 OAuth 应用 #
GitLab 自己的指南是 Configure GitLab as an OAuth 2.0 authentication identity provider。应用可以属于用户、群组或整个实例:
所有者 在哪里创建 你的用户 选择你的头像,然后依次选择 Edit profile、Access › Applications 和 Add new application。 群组 打开该群组,然后选择 Settings › Applications。 实例(自托管,仅限管理员) Admin › Applications 和 New application。 填写表单并选择 Save application:
GitLab 字段 值 Name 你的访问者能认出的名称。GitLab 在请求他们授权时会显示它。 Redirect URI http://auth.localtonet.com/auth/callbackConfidential 保持选中。 Scopes read_userGitLab 随后会显示 Application ID 和 Secret。请立即复制两者:GitLab 只在应用刚创建完成时显示 Secret。
read_user范围通过/api/v4/user端点提供对已登录用户个人资料的读取权限,这个端点就是 Localtonet 填入的用户信息端点。它是登录请求的唯一范围,因此应用不需要其他范围。 -
在 Localtonet 中添加提供商 #
打开我的隧道 › HTTP,并选择页面顶部的 SSO。在 SSO 提供商对话框中,选择添加提供商。
字段 值 提供商名称 任意名称,例如 Company GitLab。你会在隧道设置中看到它。提供商类型 GitLab。更改已保存提供商的类型会清空客户端 ID,因此请重新输入客户端 ID 和客户端密钥。 已启用 开 客户端 ID GitLab 中的 Application ID。 客户端密钥 GitLab 中的 Secret。保存后不会再显示。 打开端点与回调。GitLab.com 的地址会自动填入。对于自托管实例,请把前三个字段中的
gitlab.com替换为你实例的主机名。GitLab.com
字段 自动填入的值 授权端点 https://gitlab.com/oauth/authorize令牌端点 https://gitlab.com/oauth/token用户信息端点 https://gitlab.com/api/v4/user回调路径 /auth/callback/gitlab自托管
字段 要输入的值 授权端点 https://<YOUR_GITLAB_HOST>/oauth/authorize令牌端点 https://<YOUR_GITLAB_HOST>/oauth/token用户信息端点 https://<YOUR_GITLAB_HOST>/api/v4/user回调路径 /auth/callback/gitlab(不变)GitLab 应用中的 Redirect URI 仍然是第 1 步中的 Localtonet 地址。它不包含你的 GitLab 主机。
可选择填写邮箱访问规则,然后选择保存提供商。
-
为隧道开启它 #
在你的隧道下,选择该隧道的设置,然后选择 SSO 提供商旁边的管理。在单点登录对话框中,打开要求登录和你的 GitLab 提供商的开关。选择保存。
在 GitLab.com 上,任何人都可以创建账户。如果没有规则,任何知道该地址的 GitLab.com 用户都可以打开隧道。请在隧道上填写谁可以登录,或在提供商上填写允许的邮箱域名。这些列表在概览中有说明。
-
测试 #
在浏览器的隐私窗口中打开隧道 URL。Localtonet 会显示 Sign in to continue,以及你的提供商对应的按钮。GitLab 第一次会要求你授权该应用。之后你会被送回隧道,你的服务随即加载。
故障排除 #
GitLab 提示 the redirect URI included is not valid
GitLab 应用中没有任何 Redirect URI 与发送的地址匹配。请把 http://auth.localtonet.com/auth/callback 原样输入为该应用的 Redirect URI。
GitLab 提示 the requested scope is invalid, unknown, or malformed
请求的某个范围没有在 GitLab 应用中选中。请编辑该应用并选择 read_user。
GitLab 提示 the client authentication failed
保存在 Localtonet 中的客户端 ID 或客户端密钥与 GitLab 应用不匹配。请重新粘贴 Application ID 和 Secret,并选择保存提供商。如果你在 GitLab 中更新了 Secret,在你把新的 Secret 保存到 Localtonet 之前,该应用都无法工作。
使用自托管实例登录始终无法完成
请检查这三个端点有没有拼写错误,并确认实例能从互联网响应。如果它使用 HTTPS,则需要公共客户端信任的证书。只能在你的网络内部访问的实例无法使用。
GitLab 登录成功后出现“403 - Access Denied”
Localtonet 的某条规则拒绝了该账户。请检查提供商上的邮箱访问规则和隧道上的谁可以登录。更正规则后,请等待一分钟再重新加载。
登录页面上没有 GitLab 按钮
该提供商没有为此隧道启用,或者被设为未启用。请检查这两处。