Connect to ServiceNow
You can connect Harness to ServiceNow using a Harness ServiceNow connector. This connector allows you to approve and reject pipeline steps.
Important notes
- Your ServiceNow account should ideally have the
admin
role. If this is not possible, it should have at least theitil_admin
oritil
role to create and modify tickets. - Your account should also have the
import_admin
orimport_transformer
role to manage import set transform maps. For details, see ServiceNow's Base System Roles documentation. - Your ServiceNow REST API account must have permission to view tickets.
Add a ServiceNow connector
This topic assumes you have a Harness Project set up. If not, see Create Organizations and Projects.
You can add a Connector from any module in your project in project setup, or in your organization, or account resources.
This topic shows you how to add a ServiceNow connector to your project.
In Project Setup, click Connectors.
Click New Connector, and then click ServiceNow. The ServiceNow connector settings appear.
Enter Name for this connector.
You can choose to update the Id or let it be the same as your ServiceNow connector's name. For more information, see Entity Identifier Reference.
Enter a Description and Tags for your connector.
Click Continue.
Add details for the ServiceNow connector
In ServiceNow URL, enter the base URL by which your users will access ServiceNow. For example:
https://example.service-now.com
.In Authentication, select one of the following:
- Username and Password
- ADFS Client Credentials with Certificate
- Username and Password
- ADFS Client Credentials with Certificate
To use a username and password for authentication, do the following:
- Enter Username.
- In Password/API Key, create a new password or API key or enter an existing one. For API Key, use a Harness Text Secret.
- For information on client credentials with certificates, go to the AD FS OpenID Connect/OAuth flows and Application Scenarios.
- Harness supports private keys encoded in RSA (in PKCS8 format).
- Harness supports certificates in
X509
format. - Permissions granted to this connector in ServiceNow depend on the configuration of the client application group.
To use ADFS credentials for authentication:
- Select an existing secret or create one that has the resource identifier of ServiceNow configured in ADFS as its value for the Resource ID field.
- Select an existing secret or create one that has the application (client) id assigned to your application by AD FS for the Client ID field.
- Select an existing encrypted file or create one that has the certificate for the Certificate field. This is a
X509
format certificate used for signing JWT tokens by your application. - In Private Key, create a new secret or choose an existing one that has the AD FS private key as the value. This key is the private RSA key corresponding to certificate uploaded in the Certificate field.
- In ADFS URL, enter the base AD FS URL.
- Click Continue.
Set up delegates
Select the Harness delegate(s) to use when making a connection to ServiceNow using this connector.
Click Save and Continue.
Harness tests the connection.
Click Finish.
The ServiceNow connector is listed in Connectors.