> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taqtile.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAML Authentication integration with Manifest using Okta

> Manifest supports Single Sign-on (SSO) using Okta. To get started you need the following items:

## **Prerequisites**

Manifest supports Single Sign-on (SSO) using Okta. To get started you need the following items:

* An Okta account with an active subscription
* The following role to the client Okta account: Administrator
* The following role to the Manifest application: System administrator

## **SAML Authentication with Okta**

1. Sign in with Okta at [https://okta-devok12.okta.com/](https://okta-devok12.okta.com/) For instructions to set up an initial Okta registration please visit [here](/okta-single-sign-on-sso).
2. Once logged into Okta, go to Applications and Click on Create App Integration

<figure>
  <img src="https://mintcdn.com/taqtile/feM6mlfS0RfFdFJP/images/SAML1-1024x539-1.png?fit=max&auto=format&n=feM6mlfS0RfFdFJP&q=85&s=579a1cf7ae22cc47f6188c540ae27c0f" alt="Saml1 1024x539 1" width="1024" height="539" data-path="images/SAML1-1024x539-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

3. Select the radio button SAML 2.0 and hit Next

<figure>
  <img src="https://mintcdn.com/taqtile/feM6mlfS0RfFdFJP/images/SAML2.png?fit=max&auto=format&n=feM6mlfS0RfFdFJP&q=85&s=05789b0c83d5411e5f0e253d00c5365d" alt="Saml2" width="944" height="535" data-path="images/SAML2.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

4. Once you select “Next” a screen will open up prompting you to **Create SAML Integration** 

<figure>
  <img src="https://mintcdn.com/taqtile/feM6mlfS0RfFdFJP/images/SAML3-1024x511-1.png?fit=max&auto=format&n=feM6mlfS0RfFdFJP&q=85&s=5d1025b00b85f1359db3bac0e55956e6" alt="Saml3 1024x511 1" width="1024" height="511" data-path="images/SAML3-1024x511-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

5. Populate the App name field with your Application Name (ie: Domain Name) and hit Next 

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-4-1024x589-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=02fdc2593ad4ec2a1a7b9f2eb3200d3d" alt="Saml 4 1024x589 1" width="1024" height="589" data-path="images/SAML-4-1024x589-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

6. Populate the Create \[DOMAIN] Integration Page with the following information:
   * **Single sign on URL:** Enter in the Manifest domain URL (ie: [https://test.taqmanifest.com](https://test.taqmanifest.com)) and append the URL with the following **/rest/auth-with-okta-saml**.
   * Make sure that "Use this for Recipient URL and Destination URL is checked
   * **Audience URI (SP Entity ID):** Insert the same URL that was entered under Single Sign on URL
     * [https://test.taqmanifesttest.com/rest/auth-with-okta-saml](https://test.taqmanifesttest.com/rest/auth-with-okta-saml)
   * **Name ID Format:** Select EmailAddress from dropdown
   * **Application username:** Select Email from the dropdown

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-5-1024x679-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=624b6e40cbd8bf59c66868316513197b" alt="Saml 5 1024x679 1" width="1024" height="679" data-path="images/SAML-5-1024x679-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

7. Under Advanced Settings --> expand the Advanced Settings Options and scroll down to the Attribute Statements. Enter in:
   * **Name:** Email
   * **Value:** user.email

Hit Next

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-6.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=339a5f6f1b3121f3d83fa2c40bcee78b" alt="Saml 6" width="730" height="795" data-path="images/SAML-6.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

8. Under **"Are you a customer or partner"** select the **"I'm an Okta customer adding an internal app"** radio button and then select **Finish.**

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-7-1024x338-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=9d1f67e101acd1ae20da965b99f89111" alt="Saml 7 1024x338 1" width="1024" height="338" data-path="images/SAML-7-1024x338-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

9. Select **"View Set-up Instructions"**

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-8-1024x665-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=d34a6532093d48d280854927bb525dc8" alt="Saml 8 1024x665 1" width="1024" height="665" data-path="images/SAML-8-1024x665-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

10. Under **Identity Provider Single Sign-On URL** - copy that URL that is provided

<figure>
  <img src="https://mintcdn.com/taqtile/feM6mlfS0RfFdFJP/images/SAML-9-1024x266-1.png?fit=max&auto=format&n=feM6mlfS0RfFdFJP&q=85&s=a32aae2e14f94e606978d35b6488f1f5" alt="Saml 9 1024x266 1" width="1024" height="266" data-path="images/SAML-9-1024x266-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

11. Go to your Manifest Web Application that you are setting up SAML within:
    * Log in
    * Go to Client Settings
    * Click on Authentication Configurations
    * Click on + SAML OKTA
    * Under Resource URL --> Enter in the URL that you copied from Okta the Identity Provider Single-Sign on URL
    * Hit update and wait for the Success message

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-10-1024x397-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=e45b74c0a5e637a1ae28a937013b09ae" alt="Saml 10 1024x397 1" width="1024" height="397" data-path="images/SAML-10-1024x397-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

12. Go back into Authentication Configurations under Client Settings and notice now there is a **"Download Manifest Certification**" button. Click on that button and download the Manifest Certificate.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-11-1024x396-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=53d21fe75e02fdaa53686dc297572dc7" alt="Saml 11 1024x396 1" width="1024" height="396" data-path="images/SAML-11-1024x396-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

13. Go back to the Okta application and scroll down under X-509 Certificate and Download the Okta Certificate.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-12-1024x511-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=011df6912ee3765263c3d97434daeb92" alt="Saml 12 1024x511 1" width="1024" height="511" data-path="images/SAML-12-1024x511-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

14. Go back to the Manifest Web Application and under Authentication Configurations under Client Settings and select the Okta Certificate using the Browse functionality and upload the Okta Certificate and hit Update.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-13-1024x469-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=e6050abd5d87c21b74769766bf63d903" alt="Saml 13 1024x469 1" width="1024" height="469" data-path="images/SAML-13-1024x469-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

15. Go back into Okta --> Go to General --> Go to SAML Settings --> Go to Edit --> Hit Next --> Go to Show Advanced Settings --> Scroll Down to Assertion Encryption and select Encrypted --> Browse Files and update the Manifest Certificate and hit Next.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-14.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=939e2514f33bf7226305305c0c7b8655" alt="Saml 14" width="747" height="759" data-path="images/SAML-14.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-15.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=82cbf88ab40b12492806aa322be976dd" alt="Saml 15" width="794" height="599" data-path="images/SAML-15.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-16.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=43d1593c2e725b97f79f715aadc0937d" alt="Saml 16" width="728" height="627" data-path="images/SAML-16.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-17-1024x724-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=c8a9ac00b7457b89a42ececa47381a58" alt="Saml 17 1024x724 1" width="1024" height="724" data-path="images/SAML-17-1024x724-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-18.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=90904994a2ac30d9b9cf256420137c77" alt="Saml 18" width="756" height="447" data-path="images/SAML-18.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

16. Scroll down the page and hit Finish.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-19.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=15e11b18f961bade6df08a6ff005f7db" alt="Saml 19" width="843" height="520" data-path="images/SAML-19.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

17. Go back to the Manifest Web Application and Log Out. You will not see that the Sign In with SAML is now present as a Login Option. Select Sign in with SAML, accept the URL and hit Sign In.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-20-1024x482-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=eb5b030c47932dc7b162907d33ad29db" alt="Saml 20 1024x482 1" width="1024" height="482" data-path="images/SAML-20-1024x482-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

18. If you are presented with this 403 App Not Assigned Error it is because you have not set up the User Permissions in Okta.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-21-1024x693-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=8bd6f91ba1317e4f806e019d5d6e8d00" alt="Saml 21 1024x693 1" width="1024" height="693" data-path="images/SAML-21-1024x693-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

19. Click on "Go to Homepage" --> Directory on the left hand navigation --> People. Click on the Person & username you would like to give permissions to use SAML Sign-In. Click on Assign Applications --> Click on SAML --> Assign to People and Assign to those who you want to grant SAML Sign In access to.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-22-1024x579-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=b7883849f0b853f7d532b499bac9f15f" alt="Saml 22 1024x579 1" width="1024" height="579" data-path="images/SAML-22-1024x579-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-23.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=bbdb19b50ba5ef7fb52e74fa02c57317" alt="Saml 23" width="598" height="602" data-path="images/SAML-23.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-24.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=6f90d8678890699c261887766a965e80" alt="Saml 24" width="700" height="214" data-path="images/SAML-24.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>

20. Once completed, go to back to the Manifest Web Application and log in again using SAML Support and see that you will not be auto logged into the application.

<figure>
  <img src="https://mintcdn.com/taqtile/e9hhx9lXbvZj1bhZ/images/SAML-25-1024x483-1.png?fit=max&auto=format&n=e9hhx9lXbvZj1bhZ&q=85&s=ae80db3195d7876eaab9a1270f653155" alt="Saml 25 1024x483 1" width="1024" height="483" data-path="images/SAML-25-1024x483-1.png" />

  <figcaption>
    \#image\_title
  </figcaption>
</figure>
