Skip to main content

Register a service principal in Azure AD

In order to integrate with the IGNOS API using a service principal, you need to create an app registration in your Azure AD.

  1. Sign in to the Azure Portal as an admin.

  2. Search for and select Azure Active Directory.

  3. Under Manage, select App registrations > New registration.

  4. In the Register an application window, enter the app name, and then select Register.
    new app registration

  5. Copy and make a note of the Application (client) ID. This value is required for authentication.

  6. Under Manage, select Certificates & secrets > New client secret. new client secret

  7. Enter a client secret description and an expiry time, and then select Add.

  8. Copy and make a note of the client secret in the Value field.

NOTE

Make sure you copy this value now. This value will be hidden after you leave this page.

  1. Configure API permissions:
  • Select API permissions. The Microsoft Graph User.Read permission should already be selected.
  • Select Add a permission and in the next screen, under APIs my organization uses, find Ignos. find permissions
  • For Application permissions, select Integration.
  • Select Add permissions. add integration permission
  • The API permissions should like this: grant integration consent
  • Select Grant admin consent for... and confirm that you want to make the new list of permissions active.

Client Credentials

After this process, you should have all you need to obtain valid access tokens for the IGNOS API.

ParameterExample ValueDescription
Base URLhttps://api.ignos.io/Root URL for the IGNOS API
Client IDea521e5b-fc15-4273-bb48-50a7de8311f2Obtained in step 5
Client secret7ny9Q~AyJgL.3ml-sK12Of2qh1MQqSzUY0NxcObtained in step 8
Scopeapi://a8b02577-baee-4b5e-987b-ee1fa3483013/.defaultTo be used when acquiring access tokens
Tenant ID925f5fc3-4e18-49fd-8264-0bdcb14d56a0Your Azure AD tenant ID