Prerequisites
ServiceNow Prerequisites
Version
ServiceNow Integration supports all versions supported by Service Now.
Authentication
The following data is necessary to connect your ServiceNow instance to HOPEX:
• URL of your ServiceNow instance
• User Name
• Password
Bear in mind that the user needs to have access to both REST APIs and the objects to synchronize.
*Authentication is done by "Basic Auth".
HOPEX Prerequisites
Version
You can access ServiceNow Integration using the following HOPEX versions:
• HOPEX V5 CP6
*From hotfix 27
• HOPEX V5 CP7
*From hotfix 10
Module installation
Module installation is for on-premise deployment solutions only: this step is not required if you are using a SaaS solution.
ServiceNow Integration module must have been imported into HOPEX:
*Download the ServiceNow Integration module labeled "1.x.x".
Extra User
In order to ensure performance, you need to use 2 different users:
• Your regular user to access HOPEX
• Another user to create an API Key and set up the connection between HOPEX and ServiceNow (on-prem solution only)
It is therefore recommended that you create a new user to set up your API key.
API key
An API key must be created to set up the connection between HOPEX and ServiceNow (on-prem solution only).
To create an API key:
1. Connect to HOPEX Application Server - Console.
2. Select Modules > Authentication.
3. Select Api keys, then click Create.
• Enter a key Name.
4. Configure the Roles:
• Select Custom
• Leave the fields below blank
5. Configure Hopex session:
• Select Open session
• Enter a valid HOPEX login
*Remember that the HOPEX login used to create the API key must be different than the HOPEX login used to access ServiceNow Integration. See Extra User.
• Select the EnvironmentId
• Select the Repository if applicable
*You need to create one API key per repository.
• Select the Profile if applicable
*Bear in mind that the profile you use must have sufficient CRUD rights on the objects that will be synched.
6. Configure Session mode:
• Multi (recommended)
• Single (slower and requires more memory)
7. Configure Connection Mode field:
• Read/write (recommended)
• Read only (can be used only if you synchronize data from HOPEX to ServiceNow)
8. Click Submit.
9. Copy the key.
*Save the key somewhere: you will not be able to access it at a later stage.
*If you have lost the API key, you can simply create a new one. This will not impact ServiceNow Integration.