# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://faq.liquidandgrit.com/development/okta-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.