ServiceNow – Setup

Introduction

ServiceNow is a workflow-driven platform that unifies sales, order management, customer service and field service.

This guide gives details on how to obtain authentication details from ServiceNow, create as well as how to install a ServiceNow Connector.

Setup & Authentication

The Cyclr ServiceNow Connector provides the following authentication types, allowing you to decide which is appropriate for your use-cases:

OAuth 2.0 Password Credentials

Remote Setup in ServiceNow – performed by your customer

Configure an “OAuth 2.0 Password Credentials” application to obtain a Client ID and Client Secret.
See this ServiceNow Community article on how to do this.

Partner Setup in Cyclr Console

As the OAuth application is created by each of your customers within their ServiceNow instances, you would typically leave your Cyclr Console’s ServiceNow Connector entry in Connectors > Application Connector Library blank so that all the values are provided each time the Connector is installed.

Cyclr Connector Installation

When installing a ServiceNow Connector, the following values are used:

PropertyDescription
Client IDThe Client ID of the ServiceNow application.
Client SecretThe Client Secret of the ServiceNow application.
UsernameThe ServiceNow username to connect as.
PasswordThe password of that user.
ServiceNow InstanceThe domain of the ServiceNow Instance.
For example, if the ServiceNow instance URL is this:
https://myInstance.service-now.com
Only enter this:
myInstance

OAuth 2.0 Client Credentials

Note: To use the “OAuth 2.0 Client Credentials” authentication type, the ServiceNow instance must be using the “Washington DC” release or later.

Remote Setup in ServiceNow – performed by your customer

Configure an OAuth 2.0 Client Credentials application to obtain a Client ID and Client Secret.
See ServiceNow’s documentation on how to do this.

Partner Setup in Cyclr Console

As the OAuth application is created by each of your customers within their ServiceNow instances, you would typically leave your Cyclr Console’s ServiceNow Connector entry in Connectors > Application Connector Library blank so that all the values are provided each time the Connector is installed.

Having configured an OAuth 2.0 Client Credentials application within ServiceNow to obtain a Client ID and a Client Secret, go into your Cyclr Partner Console:

Cyclr Connector Installation

When installing a ServiceNow Connector, the following values are used:

PropertyDescription
Client IDThe Client ID of the ServiceNow application.
Client SecretThe Client Secret of the ServiceNow application.
ServiceNow InstanceThe domain of the ServiceNow Instance.
For example, if the ServiceNow instance URL is this:
https://myInstance.service-now.com
Only enter this:
myInstance

Basic

Cyclr Connector Installation

When installing a ServiceNow Connector, the following values are used:

PropertyDescription
UsernameThe ServiceNow username to connect as.
PasswordThat user’s password.
ServiceNow InstanceThe domain of the ServiceNow Instance.
For example, if the ServiceNow instance URL is this:
https://myInstance.service-now.com
Only enter this:
myInstance