> For the complete documentation index, see [llms.txt](https://docs.platform9.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.platform9.com/managed-openstack/authentication-and-authorization/authentication-saml-onelogin.md).

# Single Sign-on with OneLogin

Platform9 supports Single Sign-on with OneLogin. This tutorial describes the procedure for configuring the Platform9 application within OneLogin.

### Step 1. Add Platform9 app from OneLogin App Catalog

Login to OneLogin as an administrator. Click **Add App**, and search for "Platform9." Then click the app to import it into your company's app catalog.

<figure><img src="https://1553994354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFKnLSEoXJl99ahgFggb%2Fuploads%2Fgit-blob-f366a2645374eb5370571075e8876cfdb82c90e9%2F1605285422.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 2. Configure Platform9 app

After importing the app you will be automatically redirected to the application configuration section.

1. Adjust any desired settings on the Portal configuration page, and click Save.
2. Click Configuration in the top menu bar, and enter your Platform9 account FQDN.

<figure><img src="https://1553994354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFKnLSEoXJl99ahgFggb%2Fuploads%2Fgit-blob-82244c3d883fcb15daf877e0373e9ac3b2ea4eea%2F1605285449.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Click SSO and copy the Issuer URL by clicking the clipboard icon to the right of the text field. *You will need to provide this URL to Platform9.*

<figure><img src="https://1553994354-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFKnLSEoXJl99ahgFggb%2Fuploads%2Fgit-blob-3a3903b3680ca9571ab183b51d912316ea52db7c%2F1605285464.png?alt=media" alt=""><figcaption></figcaption></figure>

4. Click Access and select the roles you want to grant access to Platform9.
5. Optionally, click Parameters and add an additional SAML attribute which will serve as group classifier within Platform9 (*more info on this in the link below).*

That is it! Once you grant permissions to SSO users as described [here](/managed-openstack/authentication-and-authorization/single-sign-on-sso.md), they can start using Platform9 Managed OpenStack cloud right away.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.platform9.com/managed-openstack/authentication-and-authorization/authentication-saml-onelogin.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
