> ## Documentation Index
> Fetch the complete documentation index at: https://forest-chore-open-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta SSO

> Configure SSO with Okta

## Configuration

1. In your Okta admin dashboard, click **Create a new app integration**
2. Select **SAML 2.0** and follow the wizard
3. Configure the app with these settings:

| Setting                        | Value                                                                                     |
| ------------------------------ | ----------------------------------------------------------------------------------------- |
| ACS URL                        | `https://api.forestadmin.com/api/saml/callback`                                           |
| Audience URI (EntityID)        | `forestadmin-YourOrganizationName`                                                        |
| Name ID format                 | **EmailAddress**                                                                          |
| Application username           | **Email**                                                                                 |
| Update application username on | **Create and update**                                                                     |
| Relay State (optional)         | `{"organizationName": "YourOrganizationName", "destinationUrl": "organization.projects"}` |

4. Go to the **Sign On** tab → **Metadata details** and copy the **Metadata URL**
5. In Forest Organization settings, select **XML file endpoint** and paste the Metadata URL

## Troubleshooting

* Double-check all endpoints and certificate expiration dates
* Ensure `Name ID format` is set to **EmailAddress** and matches the email used on Forest accounts