# Configure SSO with OneLogin

{% hint style="info" %}
You must have one project in your organization with the plan [Forest Admin Enterprise plan](https://www.forestadmin.com/pricing) to access this feature.
{% endhint %}

## Configuration

1. In your OneLogin admin dashboard, click **Add app**
2. Select **SAML Custom Connector (Advanced)** and follow the wizard.
3. In the **Configuration** section, enter all required parameters as shown in the tab bellow.
4. Navigate to **SSO** section, and copy the `Issuer URL` head to Forest Admin, select **XML file upload or XML file endpoint** and paste the `Issuer URL` to the Metadata XML endpoint.
5. You can perform some tests before enabling it for your whole company..

| Setting                      | Description                                                                                                                    | Value                                                                                   |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| ACS URL\*                    | Assertion Consumer Service URL is responsible for receiving the SAML response                                                  | `https://api.forestadmin.com/api/saml/callback`                                         |
| ACS Consumer URL Validator\* | URL Validator                                                                                                                  | `^https://(api\|app).forestadmin.com/.*$`                                               |
| Logout URL                   | Redirected to this location after logout                                                                                       | `https://app.forestadmin.com/login`                                                     |
| SAML nameID format           | Should be the **email address used on Forest Admin accounts**                                                                  | Select **Email**                                                                        |
| Audience (EntityID)          | A globally unique name                                                                                                         | `forestadmin-OrganizationName`                                                          |
| (Optional) RelayState        | Only useful for [IDP-initiated login](/user-guide/project-settings/organizations/organization-settings.md#idp-initiated-login) | `{"organizationName": "<OrganizationName>", "destinationUrl": "organization.projects"}` |

### IDP-initiated login

You can find more info on [IDP-initiated login here](/user-guide/project-settings/organizations/organization-settings.md#idp-initiated-login)

![](/files/5mF0zsratg64YvgROlER)

### Troubleshooting

Check the steps below this if you encounter an issue:

* Double check all information (endpoints, certificate expiration dates, etc..)
* Make sure the `nameID` configured on your Identity Provider is the **email address used on Forest Admin accounts**


---

# 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://docs.forestadmin.com/user-guide/project-settings/organizations/organization-settings/sso-with-one-login.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.