跳到内容
Localtonet Localtonet 控制台

使用 GitLab 的单点登录

需要余额 HTTP 隧道

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

让访问者先用自己的 GitLab 账户登录,才能打开 HTTP 隧道。它适用于 GitLab.com 和自托管的 GitLab 实例。你需要在 GitLab 中创建一个 OAuth 应用,把它作为提供商添加到 Localtonet,然后为隧道启用它。

开始之前 #

  • 一个 HTTP 隧道,以及你账户中的余额。参见单点登录概览。
  • GitLab.com 或你自己实例上的 GitLab 账户。
  • 对于自托管实例:它的地址必须能从互联网访问。你的访问者的浏览器会打开它的登录页面,而 Localtonet 的登录主机会直接调用它的令牌端点和用户端点。

步骤 #

  1. 在 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 URIhttp://auth.localtonet.com/auth/callback
    Confidential保持选中。
    Scopesread_user

    GitLab 随后会显示 Application ID 和 Secret。请立即复制两者:GitLab 只在应用刚创建完成时显示 Secret。

    read_user 范围通过 /api/v4/user 端点提供对已登录用户个人资料的读取权限,这个端点就是 Localtonet 填入的用户信息端点。它是登录请求的唯一范围,因此应用不需要其他范围。

  2. 在 Localtonet 中添加提供商 #

    打开我的隧道 › HTTP,并选择页面顶部的 SSO。在 SSO 提供商对话框中,选择添加提供商。

    字段值
    提供商名称任意名称,例如 Company GitLab。你会在隧道设置中看到它。
    提供商类型GitLab。更改已保存提供商的类型会清空客户端 ID,因此请重新输入客户端 ID 和客户端密钥。
    已启用开
    客户端 IDGitLab 中的 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 主机。

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

  3. 为隧道开启它 #

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

    在 GitLab.com 上,任何人都可以创建账户。如果没有规则,任何知道该地址的 GitLab.com 用户都可以打开隧道。请在隧道上填写谁可以登录,或在提供商上填写允许的邮箱域名。这些列表在概览中有说明。

  4. 测试 #

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

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

支持