Set up an OAuth 2.0 connection to ServiceNow

ServiceNow is a cloud computing platform that helps companies to manage digital workflows for enterprise operations.

ServiceNow documentation: API guide, Authentication

Contents

• A. Set up a ServiceNow connection
• B. Provide required ServiceNow application details
  • Retrieve your ServiceNow Client ID and Client secret
• C. Edit advanced ServiceNow settings
• D. Test the connection

A. Set up a ServiceNow connection

Start establishing a connection to ServiceNow in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select ServiceNow.

The Create connection panel opens with required and advanced settings.

B. Provide required ServiceNow application details

At this point, you’re presented with options for providing ServiceNow authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

Authentication type (required): Select OAuth 2.0 (the Basic option is described separately).

Subdomain (required): Enter your ServiceNow subdomain. To find your subdomain, log in to your ServiceNow account. For example, if https://test89098.service-now.com is the URL, then test89098 is your subdomain.

Username (required): Enter the username of your ServiceNow account.

Password (required): Enter the password of your ServiceNow account. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this value again; it is stored only when the connection is saved and never displayed as text.

IClient (required): Select the iClient that stores the client ID and client secret provided to you by ServiceNow. To add an iClient and configure your credentials, click the plus (+) button. Click the edit ( ) button to modify a selected iClient. Provide a clear and distinguishable name to use in any other connections. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s client secret safe. When editing the iClient at any point, you must enter the secret value again; it is stored only when the connection is saved and never displayed as text.

Retrieve your ServiceNow Client ID and Client secret

1. Sign in to your ServiceNow instance.
2. Navigate to System definition > Plugins. The All applications page appears.
3. Search for OAuth 2.0 and click Install.

4. In the Activate Plugin dialog box, select Activate for (com.snc.platform.security.oauth).

   Note: By default, this plugin is active for upgraded and new instances.

5. Navigate to System OAuth > Application registry and click New.

6. Click Create an OAuth API endpoint for external clients. The Application registries new record page appears.
7. Provide a Name and click Submit. The new registry gets added.

8. Click the registry and copy the Client ID and Client secret.

Note: If you already created an application registry, you can select the registry and copy the Client ID and Client secret.

 

Redirect URL (read-only): Copy this integrator.io redirect URL to provide directions to ServiceNow for where to go after authentication. (This URL should be whitelisted with the authorization server.)

C. Edit advanced ServiceNow settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the ServiceNow connection.

D. Test the connection

Once you have configured the ServiceNow connection, you have a few options for continuing:

• Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
• Save & close – click to test and save the connection and exit the Create connection panel
• Close – click to exit without saving any new changes
• Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.