App Registrations

An App Registration is required to establish a trust relationship to enable API integrations, between a supported Ivanti-hosted cloud application and the Ivanti Neurons Platform.

The authentication method used is OAuth 2.0 Client Credentials grant flow, which allows inbound authentication from the registered application.

A unique app registration is required for each application you want to register. Each time you create an app registration, unique authentication settings are generated. These settings will need to be entered in the application you are registering; this validates and creates the trust relationship, completing the registration. To learn more about this, refer to the Help for the application you want to register. The applications that are currently supported can be found in the Supported Applications section.

App Registrations table

To access App Registrations within the Ivanti Neurons Platform, navigate to Admin > App Registrations. All existing app registrations are listed in the table, with the following details:

Application: The name of the registered application.

Description: The description entered when the app registration was created.

Last authenticated: The last time the registered app was authenticated using the client secret. If no date displays, the application has never been authenticated.

Created by: The name of the person that created the app registration.

Created: The date and time when the app registration was created.

Supported Applications

The following Ivanti-hosted cloud applications are currently supported:

  • Cherwell Service Management (CSM)
  • Ivanti Neurons APIs

Create an App Registration

Select the applicable supported application for details on how to create an App Registration.

Cherwell Service Management

Deploying the Neurons for Discovery CMDB mApp Solution (part of the One-Step Action configuration) requires authentication configuration to your Ivanti Neurons tenant. To learn more, see the Ivanti Neurons for Discovery Integration mApp Solution 1.0 documentation.

To complete the Ivanti Neurons side of the configuration, you need to create a new Cherwell Service Management App Registration.

New Registration

  1. In Ivanti Neurons, navigate to Admin > App Registrations.
  2. Select New registration to open the New app registration panel.
  3. From the drop-down, select Cherwell Service Management.
  4. Click Continue.
  5. In the Cherwell Service Management panel, optionally enter a Description for the registration.
  6. Click Register to generate the authentication settings.
  7. In the Complete this registration panel, the authentication settings, required to complete the registration, are provided:
    • Neurons Auth Url
    • Client ID
    • Client Secret
  8. Copy or record all of the registration settings. You need to enter these settings in Cherwell Service Management to validate the authentication.
  9. Warning: For security reasons, the Client Secret will not be visible again once you close this panel, so make sure you copy it before clicking Finish and close.

  1. Once you have made a copy of the settings click Finish and close.

Custom

Using an Ivanti Neurons API requires authentication configuration to your Ivanti Neurons tenant. To learn more, see the Ivanti Neurons API documentation.

To complete the Ivanti Neurons side of the configuration, you need to create a new Custom Action App Registration.

New Registration

  1. In Ivanti Neurons, navigate to Admin > App Registrations.
  2. Select New registration to open the New app registration panel.
  3. From the drop-down, select Custom App.
  4. Click Continue.
  5. In the Custom App panel, optionally enter a Description for the registration.
  6. Click Register to generate the authentication settings.
  7. In the Complete this registration panel, the authentication settings, required to complete the registration, are provided:
    • Neurons Auth Url
    • Client ID
    • Client secret
  8. Copy or record all of the registration settings. You need to enter these settings in the Get Neurons Token API to validate the authentication.
  9. Warning: For security reasons, the Client Secret will not be visible again once you close this panel, so make sure you copy it before clicking Finish and close.

  1. Once you have made a copy of the settings click Finish and close.

Delete an App Registration

If you need to update the Client Secret or any of the registration details, you must delete the app registration and create a new one.

  1. In Ivanti Neurons, navigate to Admin > App Registrations.
  2. From the App Registrations table, select the check box next to the app registration you want to delete.
  3. From the Actions menu, select Delete. A confirmation dialog displays.
  4. From the confirmation dialog, select Delete to confirm the action.
    Deleting an app registration cannot be undone and the application will no longer be able to authenticate with the Ivanti Neurons Platform unless another app registration is created.