Requirements

Before installing the ServiceNow Adapter, make sure the following requirements are met:

• Installed and properly configured Open iT Core Server version 10.1 or later

• Installed and properly configured Open iT Analysis Server version 10.1 or later

  note

  We recommend configuring the User Properties mapping in the Analysis Server's Mapping Sources page to make sure that the report displays the user information.

• Open iT license with a valid SERVICENOW key

• The following Open iT data types must be available and properly loaded on the Analysis Server:

  • (143) Normalized License Total Concurrency
  • (144) Normalized License User Host Concurrency
  • (145) Normalized License Maxed Out

• ServiceNow login credentials with the following roles:

  • sam_eng_app_integrator
  • x_opeit_openit_la.openit_integrator

• ServiceNow instance valid URI

  warning

  Determine the compatible Authentication Method for connecting to the ServiceNow instance. If using OAuth2.0, follow the instructions in the Configuring Application Registry in the ServiceNow Instance section.

Configuring Application Registry in the ServiceNow Instance

When using the OAuth2.0 authentication method for API communication, you need to create an application registry in the ServiceNow instance.

1. Log in to the ServiceNow instance with an Administrator account.

2. In the upper-left corner of the page, click All.

3. In the filter option, type Application Registry to filter the displayed items.

4. Go to System OAuth > Application Registry to open the list of application registries.

   

   Navigate to Application Registries

   
   

5. In the upper-right corner of the page, click New.

6. Click Create an OAuth API endpoint for external clients.

7. Set a unique Name, for example, LicenseAnalyzer Registry.

8. Starting version Zurich, you also need to set the Scope Restriction to Broadly scoped.

9. Leave all other default values, then click Submit.

   This will redirect you to the list of application registries.

10. Click on the name of the newly added application registry to open its details page.

11. Take note of the Client ID and Client Secret that will be used upon installation of the ServiceNow Adapter.

To copy the Client Secret, click the Toggle Password Visibility button (lock icon) to show the plain-text version of the Client Secret. Copy and save it together with the Client ID.