Skip to main content

Connect ServiceNow to Anzenna

This guide walks you through setting up an OAuth application in ServiceNow and connecting it to Anzenna. The integration enables Anzenna to access your ServiceNow service catalog and catalog item requests.

Prerequisites​

  • ServiceNow administrator access
  • Access to the Anzenna platform
  • Ability to run terminal commands to generate an OAuth access token

Step-by-Step Instructions​

Part 1: Initiate the Connection in Anzenna​

  1. Sign in to Anzenna.
Sign in
  1. Click on Configurations.
Click on Configurations
  1. Click on Connect Apps.
Click on Connect Apps
  1. Click on Connect to ServiceNow.
Click on Connect to Service Now
  1. You will be prompted to provide a Base URL and Access Token. Keep this dialog open while you complete the ServiceNow setup steps below.
You will be prompted to provide base URL and access token

Part 2: Create an OAuth App in ServiceNow​

  1. In ServiceNow, search for Application Registry and click on it.
Search for Application Registry, and then click on Application Registry
  1. Click New.
Click on New
  1. Click on Create an OAuth API endpoint for external clients.
Click on Create an OAuth API endpoint for external clients
  1. Type Anzenna in the Name field.
Type Anzenna in the Name field
  1. Type 259200000 in the Access Token Lifespan field, then click Submit. This sets the token to expire after ~3000 days, avoiding the need to provide credentials for token refresh.
Type 259200000 in Access Token Lifespan and then Submit
  1. Go back to the Application Registry and click the app you just created to retrieve the client secret.
Go back to the Application Registry and click the app you have just created again
  1. Copy the Client ID and Client Secret. The client secret is visible when you click the lock button.
Copy the client ID and client secret

Part 3: Generate an Access Token via Terminal​

Open a terminal and run the following curl command, substituting your client ID, client secret, ServiceNow username, password, and instance name:

curl -d "grant_type=password" --data-urlencode "client_id=<client_id>" --data-urlencode "client_secret=<client_secret>" --data-urlencode "username=<username>" --data-urlencode "password=<password>" -X POST https://<instance_name>.service-now.com/oauth_token.do

The response will include an access_token field. Copy that value.

Part 4: Complete the Connection in Anzenna​

  1. Return to Anzenna and enter your instance name as the Base URL in the format: https://<instance_name>.service-now.com/
Put your instance name into Base URL
  1. Paste the access token into the second field.
Put access token in 2nd field
  1. Click Save.
Click on Save

Part 5: Configure the Integration​

  1. Once the connection is set up (indicated by a green light), you will be prompted with a configuration dialog.
With the connection setup (green light), you will be prompt with a configuration dialog
  1. Choose the service catalog to be fetched.
You can choose the service catalog to be fetched
  1. Select the catalog item requests to be included.
And also the catalog item request to be included
  1. Click Save.
Click on Save
success

ServiceNow is now connected to Anzenna. The integration will begin syncing your service catalog and catalog item requests.