This article describes how to integrate GitLab with RSA Cloud Authentication Service using My Page SSO.

Configure RSA Cloud Authentication Service

Perform these steps to configure RSA Cloud Authentication Service using My Page SSO.
Procedure

1. Sign in to the RSA Cloud Administration Console with administrator credentials.
2. Enable My Page SSO by accessing the RSA Cloud Administration Console > Access > My Page > Single Sign-On (SSO).                            Ensure it is enabled and protected using two-factor authentication - Password and Access Policy.                                                                   
3. On the Applications > Application Catalog page, click Create From Template.                                                                                          
4. Click Select for SAML Direct.                                                                                                                                                                        
5. On the Basic Information page, enter a name for the configuration in the Name field and click Next Step.                                          
6. On the Connection Profile page, click the IdP-initiated option.                                                                                                                      
7. 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.                                                                                            
8. Review the ACS URL and Service Provider Entity ID values that are auto-filled.                                                                                          
9. In the SAML Response Protection section, select IdP signs entire SAML response.
10. Download the certificate by clicking Download Certificate.                                                                                                                            
11. Click Show Advanced Configuration.
12.  Under the User Identity section, configure Identifier Type and Property. For example, Identifier Type: persistent and Property: mail. 
13. Click Next Step.
14. Choose your desired Access Policy for this application and click Next Step > Save and Finish.                                                             
15. On the My Applications page click the Edit drop-down icon and select Export Metadata 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. On 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. (Optional) Select the Enforce SSO-only authentication for web activity for this group checkbox.
   6. (Optional) Select the Enforce SSO-only authentication for Git activity for this group checkbox.
6. Click Save changes.                                                                                                                                                                                      

Notes

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: openssl x509 -noout -fingerprint -sha1 -inform pem -in <Certificate.pem>.                                                                                                                                                                                       

Return to the GitLab - RSA Ready Implementation Guide.