---
title: Okta Authentication (SAML)
slug: neurons/help/en_us/2051
createdAt: 2026-11-05T08:02:10.200Z
---

Ivanti Neurons currently offers the option to choose Okta as the external authentication provider for your tenant. Okta centralizes the end user log on experience, reduces the occurrence of password related calls to the help desk, and produces granular controls over policies and audit trails.

:::hint{type="info"}
Auto provisioning for users and groups is now managed through SCIM Provisioning. To configure SCIM Provisioning, refer to [SCIM Provisioning - Okta](docId\:cIyNtcG5AuKMSZ3TjhYUD).
If you have already set up auto provisioning without SCIM, the existing setup will work as expected. You can continue to edit the default access control roles and disable auto provisioning.
Disabling auto-provisioning will not affect members already provisioned. Once disabled, Once disabled, you must set up auto-provisioning using SCIM Provisioning.
:::

## Configure & Enable External Authentication

:::ExpandableHeading
## Step 1 - Configure & Enable External Authentication (Ivanti Neurons Platform)

1. In Ivanti Neurons Platform navigate to **Admin&#x20;**> **Authentication**.
   The **Authentication** page appears.
2. In the External Authentication (SSO) section, click **Configure & Enable**.
   The **Enable External Authentication (SSO)** page appears.
3. From the **Provider** drop-down list select **Okta**.
4. From the **Sign-In Method** drop-down, select **Saml 2.0**.
   **Okta Saml 2.0 Configuration Settings** appears. It is recommended to leave this tab open for future reference when configuring the details in **Okta** console.
:::

::::ExpandableHeading
## Step 2 - Okta Application Setup (Okta Console)

1. Log in to Okta.
2. Select **Applications&#x20;**>**&#x20;Applications&#x20;**>**&#x20;Create App Integration**.
   The **Create a new app integration** screen appears.
3. Select **SAML 2.0** and click **Next**.
   The **Create SAML Integration** page appears.
4. In **General Settings**, enter the App name and click **Next**.
5. In **Configure SAML**, enter the values in the following fields:
   1\.
   1.  In **General**, enter the values available in the Ivanti Neurons tab that was open:
      1. **Single sign-on URL**: Assertion Consumer Service URL.
      2. **Audience URI (SP Entity ID)**: EntityId.
   2.
      2. Click **Next**.
6. In **Feedback**, select the check box ‘**This is an internal app that we have created**’ and click **Finish**.

   :::hint{type="info"}
   Administrators can opt out of selecting the checkbox and instead provide details in the comment boxes.
   :::

   Go to **Sign on** tab, in **Attribute Statements**, update the attributes as follows:

   1. Name: 'email', **Value**: 'user.profile.email'. Click Add Another.
   2. Name: 'given\_name', **Value**: 'user.profile.firstName'. Click Add Another.
   3. Name: 'family\_name', **Value**: 'user.profile.lastName'.

      :::hint{type="info"}
      The data in the above fields is case-sensitive.
      :::
7. Click **Assignments** > **Assign&#x20;**> **Assign to People**.
8. Select your name and click **Assign** > **Save and Go Back** > **Done**.

   :::hint{type="info"}
   The **Assignments&#x20;**&#x70;age allows you to specify who can access the Ivanti Neurons application. You can grant access to individuals or groups.
   :::

   :::hint{type="success"}
   Remember to assign it to the person setting up the integration, as they will need permissions to access the application.
   :::

   Select **Sign On** tab, copy the Metadata URL, and paste it into the Identity Provider Metadata Endpoint URL field in the Neurons Platform that was open.
9. Click **Continue**.
::::

::::ExpandableHeading
## Step 3 - Validate Connection Settings (Ivanti Neurons Platform)

You must connect with your Okta credentials to validate your connection settings.

1. On the **Validate Connection Settings&#x20;**&#x70;age, click **Validate Settings**.
   The validation takes place automatically. You will receive a confirmation screen if login is successful.
2. Return to the **Validate Connection Settings** page and select the check box to confirm login success.
   Okta is now configured, but it is not enabled. To enable, you need to convert your Ivanti Neurons Platform accounts to Okta.
3. Click **Continue** to proceed to the **Convert your Ivanti Neurons platform account**page.

:::ExpandableHeading
## Validation Troubleshooting

- **E2018 Authentication failed**: User failed to authenticate with Okta. Check that the
  username and password are correct, and that the user has permission on the Okta Application Registration.
- **E2019 Missing optional claims**: Validation step failed because the additional optional claims were not present in the token returned to Ivanti Neurons Platform from Okta.
- **E2020 Unable to link to Neurons Platform user account**: The Okta user login does not match with the Ivanti Neurons Platform user. The Ivanti Neurons Platform user account email address must match the email address used to login into Okta.
:::
::::

:::ExpandableHeading
## Step 4 - Enable Ivanti Neurons Platform accounts (Ivanti Neurons Platform)

1. On the **Convert your Ivanti Neurons platform account** page, click **Sign Out & Enable**. Ivanti Neurons is signed-out.
2. Click **click here** > **Sign in with Okta** to complete the process.
3. You can now view Okta application in **Admin** > **Authentication** with an **Enabled** status.
4. Click **Signout** from the Neurons platform.
   Now, when you sign back in, you are routed to Okta to choose the account and sign in with Okta credentials.
:::

## (Optional) Delete Authentication Method (Ivanti Neurons Platform)

1. In the Ivanti Neurons Platform, navigate to **Admin** > **Authentication**.
   The **Authentication** page appears.
2. In the **External Authentication (SSO)** section, click **Actions&#x20;**>**Delete authentication method**.
   The **Delete External Authentication&#x20;**&#x73;creen appears.
3. Click **Sign Out & Re-authenticate**.
   Ivanti Neurons is signed-out.
4. Click **Sign in with email and password**.
5. Enter the credentials and click **Sign In**.
6. Navigate to **Admin** > **Authentication&#x20;**> **External Authentication**, then click **Actions&#x20;**>**Delete authentication method**.
   **Delete External Authentication** screen appears.
7. Click **Delete Authentication Method**.
   The existing authentication method is now deleted.
