> For the complete documentation index, see [llms.txt](https://faq.liquidandgrit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faq.liquidandgrit.com/development/okta-integration.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.