OneLogin

Updated 2 months ago by Jaala

Overview

Below is a step-by-step guide for connecting your OneLogin account to GitPrime with SSO. Here is a list of all other SSO hosts we support. 

Configuring Your OneLogin SSO Integration

Step 1: Start at your OneLogin home page and navigate to Apps and select Add Apps.

Navigate to APPS then select Add Apps.

Step 2: In the find applications bar, type 'SAML' and click search. 

Step 3: In this list select SAML Test Connector (IdP) w/NameID (Unspec).

Step 4: On this page click Save.

Step 5: You will get this confirmation and these additional fields will be added. 

Step 6: In the Info tab make sure you have Display Name and Tab filled out with the name of the company that will be associated with the GitPrime app.

Step 7: Leave this tab open and in a new browser go to your GitPrime homepage, navigate to Settings > SSO.

Step 8: Select New SAML Integration.

Step 9: In the Configure SAML integration modal, fill out these two fields: 

  1.  The Login URL link: in the empty box add the name of your company or organization 
  2.  Fill out FirstName, LastName and Email as seen below. 
You will need to leave this modal up and do not hit save yet. You will be gathering metadata from OneLogin after a few more steps.

Step 10: Next, copy the Login URL from the GitPrime modal in the previous step. 

Example: https://app.gitprime.com/accounts/saml/mycompany

Leave this GitPrime browser open and navigate back to where you left off in OneLogin, go to the Configuration tab, paste your URL link into these five fields

Step 11: Click Save.

Step 12: Once clicking Save you will see this message.

Step 13: Go to the Parameters tab, select Add parameter.

Step 14: In this section you will add four separate parameters. For each parameter make sure to check Include in SAML assertion

The four parameters to add

  1. (Field Name)Roles - (Value)User Roles
  2. (Field Name)FirstName - (Value)First Name
  3. (Field Name)LastName - (Value)Last Name 
  4. (Field Name)Email - (Value)Email 

After entering the Field Name and checking the Include in SAML assertion, you will be prompted to assign the respective Value from a drop down menu. The Value should match the Field Name. 

Step 15: Once you have added all four parameters, the end result will look like this: 

The NameID Field is automatically created. You do not need to do anything with this parameter.
For additional instruction, below is a video of adding parameters

Step 16: Click Save after you have added all of your parameters. 

Step 17: Under Users click Roles.

Step 18: Select New Role.

Step 19: In this section you will need to:

  1. Select your app, a little check mark will appear indicating you have successfully selected it. 
  2. Type Owner in the box.
  3. Click the check box next to Owner to save.
  4. Click Save.

Step 20: Select the Role you just created, which is Owner.

Step 21: Select Users from the top navigation.

Step 22: Search for the user you want to add the role of Owners.

Step 23: Select Add to Role to add to the Role of Owner. 

Step 24: Click Save.

Step 25: Go back to the top menu and select APPS.

Step 26: Select the GitPrime App you just created. 

Step 27: Within the app go to the drop down menu More Actions then select SAML Metadata.

Step 28: Open your metadata file and copy the information to your clipboard. 

Step 29: Go back to your GitPrime to the Configure SAML integration and paste the metadata in the Metadata box and then click Save.

Optional Settings

  1. Manage Roles within GitPrime: If you want GitPrime to manage your roles make sure to check to check this box.
  2. Merge New Users on Email: Check this box if you already have Users invited into your GitPrime account using non-SSO logins. This will automatically delete the previous logins and force all existing Users to login via your SSO platform.

Step 30: You have successfully connected GitPrime with your OneLogin account. Your users will now be able to use the login URL, i.e. https://app.gitprime.com/accounts/saml/mycompany to login to GitPrime.

Something went wrong

If you were not able to login to your GitPrime account using your SAML URL, and you receive an error like the one below, make sure to review the following configuration steps:

  • Does your sign on URL match the URL in GitPrime? (Step 10)
  • Review your Parameters. These Field Names are case sensitive and need to be mapped to their respective values.  (Steps 14-15)

Want someone from our team to walk you through adding a OneLogin integration to GitPrime? Email us at support@gitprime.com or click on the chat icon in the bottom right corner of your screen.


How did we do?