GitLab

本文将介绍 TOPIAM 与 GitLab 集成步骤详细指南。

应用简介

GitLab是一个功能全面的DevOps平台，它集成了Git仓库管理、持续集成与持续部署（CI/CD）、项目管理、代码审查、包管理以及发布等一系列功能。该平台为软件开发团队提供了一套从项目规划直至交付和监控的完整生命周期管理工具，极大地促进了开发流程的顺畅与高效。

说明

GitLab 支持多种协议，TOPIAM 都可以很好的与其进行集成，本篇文章 TOPIAM 使用OIDC协议与其对接。

TOPIAM 侧配置

新建OIDC协议应用

配置应用基础信息

完善应用基本信息，如应用图标、应用分组等
授权范围：改为全员可访问，手动授权请参考应用授权进行配置。

信息

默认情况下，授权范围设定为“手动授权”，这需要前往“访问授权”进行具体的权限分配；如果选择“全员可访问”，那么便无需再进行访问授权的分配。

协议配置

配置登录 Redirect URI，格式为：https://{GitLab domain}/users/auth/openid_connect/callback 。

GitLab 侧配置

修改GitLab配置文件并保存。

GitLab配置文件位于的工作目录中的etc/gitlab/gitlab.rb。

gitlab_rails['omniauth_enabled'] = true
gitlab_rails['omniauth_allow_single_sign_on'] = ['openid_connect']
gitlab_rails['omniauth_block_auto_created_users'] = false
gitlab_rails['omniauth_providers'] = [
  {
    name:"openid_connect",
	  label:"TOPIAM 登录",
	  args: {
	      name: "openid_connect",
	      scope: ["openid","email"],
		    strategy_class: "OmniAuth::Strategies::OpenIDConnect",
	      response_type: "code",
	      discovery: false,
	      client_auth_method: "basic",
	      send_scope_to_token_endpoint: "false",
	      client_options: {
			    port: <TOPIAM 部署的端口号>,
			    scheme: "<TOPIAM 部署的协议>",
			    host: "<TOPIAM 部署的主机地址>",
	        identifier: "<客户端ID>",
	        secret: "<客户端秘钥>",
			    authorization_endpoint: "<授权端点>",
			    token_endpoint: "<令牌端点>",
			    userinfo_endpoint: "<用户信息端点>",
			    jwks_uri: "<验签公钥端点>",
	        redirect_uri: "<GitLab domain>/users/auth/openid_connect/callback"
	      }
	    }
     }
]