> For the complete documentation index, see [llms.txt](https://docs.siit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siit.io/guides/workspace/saml-okta.md).

# Set up SSO with Okta

Set up SAML single sign-on for the Siit admin console with Okta: add the Siit app from the Okta catalog, set the Audience URI and email username, then finish setup in Siit

**Requirements**

In order to proceed with configuring login with SSO through Okta, you must:

* Have access to an **Okta tenant**
* Be an Okta **administrator** to that tenant

### Step 1️⃣ - Add the Siit App to Okta

* Log in to your organization’s Okta tenant.
* Navigate to **Applications** > **Applications** > **Browse App Catalog**, search for **Siit**, and then click **Add Integration**. The word "Applications" appears twice in this path; that is not a typo.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-5b2822afaef4b1cc25b9e4e4ed23e2aeb8fe9ed1%2FNzB_noY2SgHqC8Bhd0VdmKbGfdBLD-3U_7EoABF8oMRjbNhcw3OWcO_m7A0E3GO8pMx7zdDE46335.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-c0e90814c43d01da2ade7cd006fab55ef8b8386b%2FxtxWhg6HiAQfwsdYy_o79KhKqrVgC4ekNBIJNYiuka1ITXXK6zSx29x6HKtYFnVTj-wmAx2ob8b0IK.png?alt=media" alt="Browse app Integration Catalog on Okta"><figcaption></figcaption></figure>

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-e581a15ed277d19874283341de22e588e8cf426f%2FTiDfH2WYf4pj5zbLrNDRvpLnVaAQDWv5U4ezlJYo4AET7sEtAQPBt-f8YUZvvDA9FtycTvF8b_Ij14.png?alt=media" alt="Add Siit integration on Okta"><figcaption></figcaption></figure>

* Enter an Application Label in **General Settings.** This is the name under which the Siit app will appear in your Okta dashboard.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-7adbabb5a4a661455e681fc5260ea44fb0ae7f10%2FXTYv7bIsuZ-xLfVC3gask36jcMiu6_VWX6YsNysZojfsVXFytdH7PHJ_kaFPCUvlAU1I-pW5QJpu2U.png?alt=media" alt="Add Siit on Okta"><figcaption></figcaption></figure>

* Go to the tab **Sign On** and click on **Edit**.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-a1755769976cc0ed2d80b8d91e1e473215bb76fc%2FvQqo-a_wtE-YrYOPRUs6eiOV3T88o7-RFRlH7xhY5qUIqzbXi4JHuFqu_L0SlQp-P9fzhrqKY2z5EX.png?alt=media" alt=""><figcaption></figcaption></figure>

* In the **Advanced Sign-on Settings**, insert your **Audience URI** and change the **Application username format** to **Email**.
* To find your **Audience URI**, login to Siit, go to *Settings > Workspace > Security > Configuring SAML SSO for Okta*, and copy the value for Audience URI.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-51eb7aa2aed10b55a3863f24e98cdbf62e09de6b%2FKwSBf4vJUbbrNYcH3YdSB1PgmX8FZtnXzjFOwKO6eIeOgRsH3ZL5eb8LJfu4w65-JHQZoH58JH7rh8.png?alt=media" alt=""><figcaption></figcaption></figure>

* Click on **Save**.
* In the **Metadata details** section, you will find the credentials to configure Okta SSO on Siit.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-04a3ec6cc0f04faab7c011d174776781914def9f%2Fr7PDXdws-WtMy_hYZcc4ZTKdzB2Lq_weslU-jizhV455MuxwlBPU4VMbZPeDKd5e8vQwckdeOdY0-.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 2️⃣ - Configure SSO in Siit

**Go back to your Siit Admin. Click onSettings > Workspace > Security.**

Provide the following information for Okta integration:

* SSO Service URL
* Identity Provider Issuer
* Public Certificate

Click on **Save**.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-ebbf2f217952724c06ff8d3c0c25744b6f8ad179%2Fimage-93-.png?alt=media" alt="Siit Workspace Security settings with SSO Service URL, Issuer and Certificate fields"><figcaption></figcaption></figure>

### Step 3️⃣ - Assign Users

* Open your Okta Dashboard and go to Applications.
* Click on your new Siit SAML app.
* Switch to the Assignments tab, click Assign, and select Assign to Groups.
* In the Assign Siit to Users dialog, click Assign on Everyone to enable Siit Admin SAML app to all users in your organization, and click Done. Alternatively, you can assign separate groups or individual users.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-a9f91f5620b4655cf5c4d3fc7395793d415244bd%2FuUcjpDWITdVvnlZ4wzhfTfhLAHUCQT_EuVWI2-hMxx-qOkXWL7hOUXeMNKPzzUajadMz3CjgeWR2Au.png?alt=media" alt=""><figcaption></figcaption></figure>

### Step 4️⃣ - Testing Okta SSO

* Once everything is set up, navigate to your Siit login page.
* Test the Okta Single Sign-On functionality to ensure a smooth and secure login experience.

<figure><img src="https://2274035325-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlWFhpq2ia6gdHet0opKx%2Fuploads%2Fgit-blob-507620c6f44d9377baae2399cbd32d67e6fc784c%2FA9xcswlwOC9_NOCgLP6p8AlHoSkRjD4BdqHO-zRbVPEYeDqlr84A5pwEHfOth9KveOTg6uJ_Ug2DVy.png?alt=media" alt="Siit admin console login page"><figcaption></figcaption></figure>

If you encounter any challenges during the setup or have questions about the functionalities, our support team is ready to assist you. Contact us at <support@siit.io> for personalized guidance and assistance.


---

# 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.siit.io/guides/workspace/saml-okta.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.
