# Okta Integration

## Quick Setup Information for Okta

* You can find our app here: <https://www.okta.com/integrations/liquid-grit/>
* Information needed for the integration:
  1. Okta Login ID
  2. Okta Domain
  3. Okta Client ID
  4. Okta Client Secret
* Email <Support@liquidandgrit.com> or <brett.nowak@liquidandgrit.com> for more information

## Setup Okta SSO for Liquid & Grit

In this guide, we'll show you how to setup Okta SSO for the Liquid & Grit application. You can use Okta and OpenID to sign in to Liquid & Grit, conveniently managing your organization's users in one place.

### Prerequisites

* A Liquid and Grit account
* Admin access to Okta

### Supported Features

\- Identity Provider initiated Single Sign On - when logging in from Okta\
\- Service Provider initiated Single Sign On - when logging in from Liquid and Grit (Users can login via **<https://my.liquidandgrit.com/okta?login=YourTenantID>** - replace YourTenantID with the Tenant ID you receive in step 1 below)\
\- Users will be automatically created in Liquid and Grit when Single Sign On is initiated

### Step 1: Request an Okta Tenant ID

The first step for enabling SSO with Okta is to request a unique Okta Tenant ID from our support team. [Contact us](mailto:support@liquidandgrit.com) to request a unique tenant ID. This will be needed to complete the setup.

### Step 2: Add the Liquid & Grit integration to your Okta account

1. Log into Okta. Make sure that you are an administor on the Okta account.
2. Go to **Applications** > **Applications**.
3. Select **Browse App Catalog**.
4. Search for "**Liquid & Grit**" in the search bar.
5. Select **+ Add Integration**.
6. Click **Done**

### Step 3: Enter your unique Tenant ID

1. Go to **Applications** > **Applications**.
2. Navigate to the **Sign On** tab.
3. Under **Advanced Sign-on Settings**, enter your unique Tenant ID that you received during Step 1 to the **TenantID** fields.
4. Click **Save**.

### Step 4: Assign users

You can now create groups and assign users to the Liquid & Grit appliation inside Okta.

### Step 5: Send details to our support team

You will need to [send us](mailto:support@liquidandgrit.com) the following details:

* **Okta Domain Name** (find this in your browser URL bar)
* **Client ID** (find this under the Sign On tab in the Liquid & Grit application)
* **Client Secret** (find this under the Sign On tab in the Liquid & Grit application)

Once we have the details, we will update our sytem and we will communicate to you once Okta SSO has been enabled on your account.