Okta

Updated 1 month ago by Jaala

Overview

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

Okta Configuration

Step 1: Sign into Okta and navigate to the top right corner and click Admin.

Step 2: Click Add Applications.

Step 3: Click Create New App.

Step 4: Select the Web for Platform and SAML 2.0 for Sign on method. Then click Create.

Step 5: Fill out App name. It can be anything (i.e. GitPrime). Then click Next.

Step 6: In another tab, open your GitPrime App, starting on your GitPrime Home page go to the left navigation bar. At the bottom go to Settings then select SSO.

Step 7: Select New SAML Integration.

Step 8: In the Configure SML integration modal fill in the “Login URL” field with your organization name. This is the URL you will use for logging in with after you configure your integration. You can use your organization name or something else. It just needs to be unique. You will use this same URL in Step 10 below. 

Step 9: Navigate back to where you left off in Okta and fill in the following information under the General settings:

A. Single sign on URL: This is the full URL from the screen above in GitPrime; i.e. https://app.gitprime/accounts/saml/mycompany

B. Audience URI (SP Entity ID): This is the same URL as in step A, above. 

C. Application username: Select “Email” from the drop down menu. 

Step 10: On the same screen, under Attribute Statements,  click Add Another to add two more rows so you can map the following fields:

C. FirstName

D. LastName

E. Email

These fields are case sensitive.

Step 11: Using the drop down menu under Value, map the values appropriately to the fields you just created.

Step 12: Under Group Attribute Statements, map your current roles in Okta to their respective role in GitPrime. "Owners" and "Members" are roles created by default for your organization, but you can go into GitPrime with your initial / setup account and create any roles and associated permissions you'd like.

These fields are case sensitive. Make sure your roles are spelled exactly the same in GitPrime and Okta.

In this example: “Managers” and “Developers” in the screenshot above are roles that your organization already has in Okta. The “Managers” Okta Group will be mapped to the GitPrime “Owners” Role and the “Developers” Okta Group to the “Members” GitPrime Role.

The end result for this step looks something like this:

Step 13: Click Next.

Step 14: Select I am an Okta customer adding an Internal app.

Step 15: Then click Finish.

Step 16: After clicking Finish, you will be redirected to the screen below. Click Identity Provider metadata. This will download a file that you can open in a text editor.  Copy the meta data to your clipboard.

Step 17: In your GitPrime *tab, paste the metadata in the metadata field.

If you lost your GitPrime tab, go here and click New SAML Integration.

Step 18: After pasting your metadata, type all the fields that map to your SAML fields. These fields are case senstive so make sure they match exactly what you used in Okta. 

If you want GitPrime to manage your roles make sure to check the box next to “Manage Roles within GitPrime.” Any new user will be given all default roles.

Step 19: Click Save.

Step 20: Once you click Save, your Okta Integration is complete in GitPrime.

Step 21: You will need to go back to Okta and add users to the GitPrime application.

Click Admin.

Step 22: Click Assign Applications.

Step 23: Click the application you just created for GitPrime and then the user you want to add to the application. 

If you don't see a user in Okta that you would like added to GitPrime, please reach out to your IT team to have them added.

Step 24: Click Next.

Step 25: Click Confirm Assignments.

Step 26: You have successfully connected GitPrime with your Okta 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 to match the URL in GitPrime? (Step 10)
  • Review  your “Attribute Statements” and “Group Attribute Statements”. These fields are case sensitive and need to be identical to their respective GitPrime Role and Okta Group. (Step 11-13)

Want someone from our team to walk you through adding an Okta SSO 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?