Requirements

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

• Installed and properly configured Open iT Core Server connected to the Open iT Shared Software Assets Directory (SSAD)

  • Coordinate with your Open iT Account Manager or the Open iT Support Team at support@openit.com to get your SSAD access credentials.
  • The Core Server requires an internet connection to access the SSAD.
  note

  SSAD access can be configured during Core Server installation or manually set up and activated after installation.

• Open iT Core Client(s) connected to an Open iT Core Server or a coexistent Open iT Core setup

• Installed and properly configured Open iT Analysis Server

  warning

  The ServiceNow Adapter must be installed on the server running the Analysis Server.

  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.

• Available and properly loaded on Open iT data types on the Analysis Server:

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

• Open iT license with a valid SERVICENOW key

• 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 to show the plain-text version of the client secret. Copy and save it together with the Client ID.