This article describes how to integrate RSA with GitLab using SAML Relying Party.

Configure RSA Cloud Authentication Service

Perform these steps to configure RSA Cloud Authentication Service as Relying Party to GitLab.
Procedure

1. Sign in to RSA Cloud Administration Console. 
2. Navigate to the Authentication Clients menu and click Relying Parties.                                                                                                       
3. Click Add a Relying Party.      
4. On the Relying Party Catalog page, click Add corresponding to Service Provider SAML.                                                                          
5. On the Basic Information page, enter the name for the application in the Name field and click Next Step.                                           
6. On the Authentication page, select SecurID manages all authentication.
7. Select a Primary Authentication Method and Access Policy as required and click Next Step.                                                      
8. For providing Service Provider details:
   1. Click Import Metadata and click Choose File.
   2. Select the file that is downloaded from the Service Provider. 
      Refer to the Configure GitLab section to download the metadata file.                                                                                     
9. Review the ACS URL and Service Provider Entity ID values that are auto-filled.                                                                                       
10. In the SAML Response Protection section, select IdP signs entire SAML response.
11. Download the certificate by clicking Download Certificate.                                                                                                                     
12. Click Show Advanced Configuration.
13. Under the User Identity section, configure Identifier Type and Property. For example, Identifier Type: persistent and Property: mail.   
14. Click Save and Finish.
15. On the My Relying Parties page, click the Edit drop-down icon and select the Metadata option to download the metadata.             
16. Click Publish Changes. Your application is now enabled for SSO.                                                                                                         

Configure GitLab

Perform these steps to configure GitLab.
Procedure

1. Sign in to GitLab using administrator credentials - gitlab.com.
2. In the left pane, select Search or go to Groups and find your group.                                                                                                         
3. Click Settings > SAML SSO.                                                                                                                                                                       
4. Copy the GitLab metadata URL and download the metadata file.                                                                                                               
5. Provide the following details in Configuration.
   1. Identity provider single sign-on URL: Obtain from the metadata file downloaded from RSA.
   2. Certificate fingerprint: See the Notes section for the instructions on how to obtain certificate fingerprint.
   3. Default membership role: Select the role to assign to new users. The default role is Guest. 
      Group Owners can set a Default membership role other than Guest.
   4. Select the Enable SAML authentication for this group checkbox.
   5. Select the Enforce SSO-only authentication for web activity for this group checkbox (Optional).
   6. Select the Enforce SSO-only authentication for Git activity for this group checkbox (Optional).
6. Click Save changes.                                                                                                                                                                                 

Notes

To obtain the certificate fingerprint follow the steps:

1. Install the latest version of OpenSSL for Windows.
2. Open the Windows Command-line.
3. Navigate to the OpenSSL installation directory (the default directory is C:\OpenSSL-Win32\bin).
4. Run the following commands to view the certificate fingerprint/thumbprint: penssl x509 -noout -fingerprint -sha1 -inform pem -in <Certificate.pem>.                                                                                                                                                                                        

The configuration is complete.

Return to GitLab - RSA Ready Implementation Guide.