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

# Okta Integration for Atonom

> Setting up SAML single sign-on (SSO) for the Atonom application using Okta as your identity provider.

This guide will walk you through the process of configuring SAML-based single sign-on (SSO) for the Atonom application within your Okta tenant. This process involves creating a new SAML application, configuring the necessary SAML parameters, and assigning users.

***

### **1. Create the SAML Application**

Since Atonom is not yet in the Okta Integration Network, you will need to create a new custom SAML application.

1. Sign in to your **Okta Admin Console**.
2. Navigate to **Applications** in the main menu.
   <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_applications.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=59172f19c22d1084bdabcc695482c89f" alt="Okta Applications" width="300" height="638" data-path="SAML/images/okta_applications.png" />
3. Click **Create App Integration**.
   <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_create_new_app.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=e41e9dfd03225da05c3b6e82cc074d7a" alt="Okta Create New App" width="1059" height="503" data-path="SAML/images/okta_create_new_app.png" />
4. Select **SAML 2.0** as the sign-in method.
   <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_saml_2_next.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=ee1caba778b5818b77d966738538cdd0" alt="Okta SAML 2.0 Next" width="954" height="549" data-path="SAML/images/okta_saml_2_next.png" />
5. Click **Next** to proceed to the configuration.
6. In the **General Settings** tab, fill out the form and click **Next**:
   <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_general_settings_new_app.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=942ab7b4b48025ced4015bc9a7d2f3d7" alt="Okta General Settings" width="1114" height="553" data-path="SAML/images/okta_general_settings_new_app.png" />
7. In the **Atonom** application, go to the bottom left and click on your profile picture. Click settings, Org Settings, Identity Management. **(This is placeholder text with no images until we have finalized the settings page ports)**.
8. Once there, copy the **Assertion Consumer Service (ACS) URL** and paste it into the **Single sign-on URL** field in the **General Settings** tab in Okta.
   <img src="https://mintcdn.com/signals-f5a9b760/B1RhO19sxBINjINu/SAML/images/okta_signals_login_url.png?fit=max&auto=format&n=B1RhO19sxBINjINu&q=85&s=4a10956c9aa0120018bb2544efc2d0a3" alt="Okta SAML Login URL" width="1390" height="635" data-path="SAML/images/okta_signals_login_url.png" />
9. Next, copy the **Entity ID / Issuer** from the **Atonom** app and paste it into the **Audience URI (SP Entity ID)** field in the **General Settings** tab in Okta.
10. On **Okta**, for **Name ID Format**, select `Unspecified`. This uses Okta's default.
11. For **Application username**, select `Email`.
    <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_create_saml_configure.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=bc611a14e88d8203bc2c941bc5e7762f" alt="Okta create saml integration" width="739" height="758" data-path="SAML/images/okta_create_saml_configure.png" />
12. Scroll down and click **Next**.
13. Now, check **Contact App Vendor** and click **Finish**.
    <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_help_support_create.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=0fbfd4f57a5bb63e17511b3ba5c4cc12" alt="Okta Finish" width="733" height="734" data-path="SAML/images/okta_help_support_create.png" />
14. After clicking **Finish**, you will be redirected to the **Atonom** application in Okta. Copy the **Metadata URL** as shown below.
    <img src="https://mintcdn.com/signals-f5a9b760/EbFEcafVPu0rzxFO/SAML/images/okta_copy_this_url.png?fit=max&auto=format&n=EbFEcafVPu0rzxFO&q=85&s=58a7df18ffbcf9adb1dce712962e9ace" alt="Okta Metadata URL" width="775" height="1076" data-path="SAML/images/okta_copy_this_url.png" />
15. Now, go back to the **Atonom** application Identity Management page and paste the **Metadata URL** into the **Metadata URL** field.

***