将您的服务器与 GitLab.com 集成
从 JihuLab.com 导入项目并使用您的 JihuLab.com 账户登录到您的极狐GitLab 实例。
要启用 JihuLab.com OmniAuth provider,您必须向 JihuLab.com 注册您的应用程序。JihuLab.com 会生成一个应用程序 ID 和密钥供您使用。
- 登录 JihuLab.com。
- 在右上角,选择您的头像。
- 选择 编辑个人资料。
- 在左侧边栏中,选择 应用程序。
- 提供 添加新应用程序 所需的详细信息。
- 名称:任意填写。考虑类似
<Organization>'s GitLab
或<Your Name>'s GitLab
或其它描述性的内容。 - 重定向 URI:
http://your-gitlab.example.com/import/gitlab/callback http://your-gitlab.example.com/users/auth/gitlab/callback
导入器需要第一个链接,身份验证需要第二个链接。
如果您:
- 计划使用导入器,您可以保持原样。
- 只想使用此应用程序进行身份验证,我们建议使用更小的范围集。
read_user
即可。
- 名称:任意填写。考虑类似
- 选择 保存应用。
- 您现在应该会看到一个 Application ID 和 Secret。在继续配置时保持此页面打开。
-
在您的极狐GitLab 服务器上,打开配置文件。
Linux 软件包安装实例:
sudo editor /etc/gitlab/gitlab.rb
源代码编译安装实例:
cd /home/git/gitlab sudo -u git -H editor config/gitlab.yml
-
配置通用设置将
alicloud
添加为单点登录提供商。这为没有现有极狐GitLab 账户的用户启用了即时账户配置功能。 -
添加 provider 配置:
针对 JihuLab.com 进行身份验证的 Linux 软件包安装实例:
gitlab_rails['omniauth_providers'] = [ { name: "gitlab", # label: "Provider name", # optional label for login button, defaults to "GitLab.com" app_id: "YOUR_APP_ID", app_secret: "YOUR_APP_SECRET", args: { scope: "read_user" } # optional: defaults to the scopes of the application } ]
或者,针对另一个不同的实例进行身份验证的 Linux 软件包安装实例:
gitlab_rails['omniauth_providers'] = [ { name: "gitlab", label: "Provider name", # optional label for login button, defaults to "GitLab.com" app_id: "YOUR_APP_ID", app_secret: "YOUR_APP_SECRET", args: { scope: "read_user" # optional: defaults to the scopes of the application , client_options: { site: "https://gitlab.example.com" } } } ]
针对 JihuLab.com 进行身份验证的源代码编译安装实例:
- { name: 'gitlab', # label: 'Provider name', # optional label for login button, defaults to "GitLab.com" app_id: 'YOUR_APP_ID', app_secret: 'YOUR_APP_SECRET',
或者,针对另一个不同的实例进行身份验证的源代码编译安装实例:
- { name: 'gitlab', label: 'Provider name', # optional label for login button, defaults to "GitLab.com" app_id: 'YOUR_APP_ID', app_secret: 'YOUR_APP_SECRET', args: { "client_options": { "site": 'https://gitlab.example.com' } }
在 15.1 及更早版本中,site
参数需要/api/v4
后缀。我们建议您在升级到 15.2 或更高版本后删除此后缀。 - 将
YOUR_APP_ID
更改为 GitLab.com 应用程序页面中的 Application ID。 - 将
YOUR_APP_SECRET
更改为 GitLab.com 应用程序页面中的 secret。 - 保存配置文件。
- 根据极狐GitLab 的安装方式,使用适当的方法应用以上更改:
- Linux 软件包安装实例:重新配置极狐GitLab。
- 源代码编译安装实例:重启极狐GitLab。
在登录页面上,现在应该在常规登录表单后面有一个 JihuLab.com 图标。选择图标来开始身份验证过程。 JihuLab.com 要求用户登录并授权应用程序。如果一切顺利,用户将返回到您的极狐GitLab 实例并登录。
减少登录时的访问权限
- 引入于 14.8 版本,功能标志为
omniauth_login_minimal_scopes
。默认禁用。- 在 SaaS 上启用于 14.9 版本。
- 功能标志
omniauth_login_minimal_scopes
删除于 15.2 版本。
如果您使用极狐GitLab 实例进行身份验证,则可以在使用 OAuth 应用程序登录时减少访问权限。
任何 OAuth 应用程序都可以使用授权参数:gl_auth_type=login
,宣称应用程序的用途。如果应用程序配置了 api
或 read_api
,则使用 read_user
发出访问令牌来进行登录,因为不需要更高的权限。
极狐GitLab OAuth 客户端配置为传递此参数,但其它应用程序也可以传递它。