GitLab支持多种 SSO 协议，本文档介绍如何在飞连通过 SAML 协议单点登录 GitLab。

GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。

本文以 Gitlab 配置文件操作为例，您也可以在 GitLab 群组的设置 > SAML SSO 页面配置相关参数。

1. 在部署环境中执行如下命令编辑 Gitlab 配置文件，详细步骤请参见GitLab官网文档。

# 若您使用 Omnibus 方式安装 Gitlab，请使用以下命令：
vim /etc/gitlab/gitlab.rb

# 若您使用独立安装 Gitlab，请参考以下命令：
cd /home/git/gitlab
sudo -u git -H editor config/gitlab.yml

2. 移动到最后一行，添加如下信息。

gitlab_rails['omniauth_enabled'] = true
gitlab_rails['omniauth_allow_single_sign_on'] = ['saml']
gitlab_rails['omniauth_block_auto_created_users'] = false
gitlab_rails['omniauth_auto_link_saml_user'] = true


gitlab_rails['omniauth_providers'] = [
  {
    name: "saml",
    label: "使用飞连登录",
    args: {
      assertion_consumer_service_url: "http(s)://{gitlab.example.com}/users/auth/saml/callback",
      idp_cert_fingerprint: "{fingerprint}",
      idp_sso_target_url: "https://feilian_host}:{portal_port}/api/idp/sso",
      issuer: "https://{gitlab.example.com}",
      name_identifier_format: "urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"
    }
  }
]

以上配置文件适用于使用 Omnibus 方式安装 Gitlab的场景，如果是独立安装 Gitlab，配置文件的格式不一样，但参数一样，具体请参见GitLab官网文档。
示例代码中的关键参数说明如下表所示。

3. 配置完成后，执行如下命令重新加载配置文件并重启 GitLab。

若您使用 Omnibus 方式安装 Gitlab，请使用如下命令重新加载配置文件并重启服务：
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

# 若您使用独立安装 Gitlab，请参考如下命令重启 GitLab：
# 对于运行 systemd 的系统
sudo systemctl restart gitlab.target
# 对于允许 SysV init 的系统
sudo service gitlab restart

1. 登录飞连管理后台。

2. 在左侧导航栏，单击应用接入。

3. 在应用接入页面，单击右上角的应用市场。

4. 在添加新应用页面的筛选条件区域，搜索 GitLab 应用模板卡片。

5. 在搜索结果区域，单击该应用模版卡片，并在所选模板卡片的右下角，单击添加应用。
   

6. 在填写应用信息页面，配置应用信息和应用功能并单击确定。
   
   关键参数说明如下表所示。

   配置项	说明
   应用名称	自定义应用的名称。
   应用访问地址	请填写 GitLab 的服务地址。
   协议类型	本示例中请选择 SAML。
   GitLab 唯一标识	GitLab 应用在飞连租户内的唯一标识，自定义，保证租户内所有应用唯一，格式为https://gitlab.com/groups/<enterprise_name>。 <enterprise_name>请替换为 GitLab 上对应的 Group Name。
   GitLab 单点登录地址	格式为https://gitlab.com/groups/<enterprise_name>/-/saml/callback。 <enterprise_name>请替换为 GitLab 上对应的 Group Name。
   应用网关	应用网关的配置项说明，请参见添加应用。

1. 登录飞连管理后台。

2. 在左侧导航栏，单击应用接入。

3. 在应用列表中，单击对应应用的应用名称。

4. 单击单点登录页签，单击映射关系右侧的编辑。
   

5. 单击添加映射，在字段下拉列表中单击底部的添加扩展字段。
   

6. 分别创建飞连字段和应用字段，字段的值如下表所示。
   

   配置项	飞连字段的值	应用字段的值
   字段 Key	gitlab_username	app_user_id
   字段名称	GitLab Username	NameID
   字段类型	字符串	字符串

7. 添加飞连字段和应用字段的映射关系。