Integrating Okta SSO with Grip Security

Overview

This guide describes a step-by-step process to integrate Okta SSO with Grip Security, enabling secure authentication for users. We'll walk through the setup of a new SAML application in Okta, including the necessary configurations, and explore the optional creation of a Bookmark App for quicker access.

Integration Benefits

Integrating Okta SSO with Grip Security offers several benefits, including:

• Simplified access for users via Single Sign-On (SSO).

• Streamlined management of user authentication and provisioning.

Prerequisites

Access to the Okta administration panel.

Integration steps

Step 1 - Create a New SAML Application in Okta

• Open the Okta Administration Page and navigate to the Applications section from the left panel.

• To configure a new app integration, click Create App Integration, and select SAML 2.0 as the Sign-in method.

• To configure the application:

  • Enter "Grip Security SSO" as the application name.

  • Ensure that Do not display the app icon to users and Do not display application icon in the Okta Mobile app are selected.

  • Click Next

• Fill in the SAML Settings form as follows:

  • Single Sign-On URL- this is taken from the Grip portal (see Step 3 - Configure SAML in the Grip Portal below).

  • Audience URI (SP Entity ID) - this is taken from the Audience URI (SP Entity ID) field in Grip portal (see Step 3 - Configure SAML in the Grip Portal below).

  • Application Username - Select Custom and then enter String.toLowerCase(user.email)

  • Leave other settings unchanged and click Next.

• In the Attribute Statements window enter the following:

  • Name:  this is the Attributes Statement, Name taken from the Grip portal

  • (see Step 3 - Configure SAML in the Grip Portal below).

  • Value:  user.email

• To view the settings, click Preview the SAML Assertion.

• Click Next.

• To provide feedback to Okta support and complete setup, select This is an internal app that we have created, and click Finish. 

Step 2 - Retrieve and Save Identity Provider Metadata

1. Navigate to the Grip Application page in Okta and select the Sign On tab.

2. Under SAML 2.0, copy the Metadata URL and save it (this will be required when configuring SAML in the Grip portal). 

Step 3 - Configure SAML in the Grip Portal

1. Go to the Admin Panel in the Grip portal.

2. Click on the Plus symbol under SSO Provider.

3. Select Okta SSO.

4. Paste the metadata URL to the SAML Metadata XML ULR field at the bottom of the page.

5. Click Submit.

Step 4 (optional) - Create and Configure an Okta Portal Bookmark App

1. To open the Okta Administration page, navigate to the Applications section from the left panel.

2. Select Browse App Catalog.

3. Find and select Bookmark App, then click Add.

4. To configure the bookmark app, enter "Grip Security" as the application label.

5. Provide the Grip URL and ensure that the application is visible.

Tip

We recommend creating a security group for Grip users assigning it to both the Bookmark and the SSO app to streamline future user assignments.

Step 5 - Provision Users and Groups

Go to the Assignments tab to provision users and groups.Summary

After performing the steps described in this guide, you will have integrated Okta SSO with Grip Security and optionally set up a Bookmark app for easier user access. This integration streamlines secure authentication and simplifies user provisioning, providing a better overall user experience.