integration-service
latest
false
UiPath logo, featuring letters U and I in white
Integration Service User Guide
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated Nov 7, 2024

ServiceNow authentication

Prerequisites

To establish the connection, you need to give the connector the ability to retrieve the OAuth access token and enable the activities to successfully send requests to the ServiceNow API.

Multi-authentication

You can read more on multi-authentication here.

To create a multi-authentication connection, you must:
  1. Complete the Setup OAuth steps in the ServiceNow documentation.
  2. Select Integration Service from Automation CloudTM Public Sector.

  3. From the Connectors list, select ServiceNow. You can also use the search bar to narrow down the connector.
  4. Select the Add connection button.
  5. You are now redirected to the connection page.
  6. Click the ⚙ icon to change your Authentication type.
  7. Select the appropriate authentication mechanism.
  8. Enter the required information and click Connect.

Setup OAuth

Complete the Setup OAuth steps in the ServiceNow documentation.

While the documented steps are likely the same across all ServiceNow platform regions, it's recommended that you follow the steps for your specific region in case there are differences (e.g., Madrid, New York, etc.)

For reference, below is how we setup OAuth for our examples.

  1. Sign in to your ServiceNow instance (e.g., https://<span>dev74293.service-now.com/login</span>)
  2. Go to System Definitions > Plugins and verify the OAuth plug-in Status is set to Active.



  3. Go to System OAuth > Application Registry and click New.

    • When asked What kind of OAuth application?, click Create an OAuth API endpoint for external clients.



  4. Enter a Name for your application (e.g. UiPathQuickstart) and click Submit (if successful, you're redirected back to your Application Registries list).


  5. In the Application Registries list, find your new application and click on its Name to open the details page.
  6. Click on the lock icon next to Client Secret to show the value.
  7. Take note of the Client Id and Client Secret values.
  8. Type the following redirect URL in its corresponding field: https://govcloud.uipath.us/provisioning_/callback.



Add the ServiceNow connection

To create a connection to your ServiceNow instance, you need to perform the following steps:

  1. Select Integration Service from Automation CloudTM Public Sector.

  2. From the Connectors list, select ServiceNow. You can also use the search bar to narrow down the connector.
  3. Select the Connect to ServiceNow button.
  4. Select the Add connection button.
  5. You are now redirected to the connection page. Enter the Site URL,Client ID, and Client secret and click Connect.


  6. Next, enter your ServiceNow username and password. The app asks for your permission to connect to your ServiceNow account and to interact with records. Click Allow.
  7. Your connection has been added.

For more information on creating connections with ServiceNow, refer to ServiceNow Product Documentation.

ServiceNow roles and permissions

ServiceNow TableOperationAccess reason
Tables (sys_db_object) read
The Tables module/table functions as a repository that holds a row corresponding to each table in your ServiceNow instance. It is utilized to compile a list of tables for the purpose of executing actions or triggering events. This is required to load all your tables when you click on the Select Object dropdown for you CRUD activities.
docs image
Dictionary (sys_dictionary) readThis table encompasses data about respective columns of a particular table within your ServiceNow instance. This table is required to load input and output fields when you select a table for carrying out an action.
Choices (sys_choice) readThe Choice table contains values for options that appear in choice lists and also for look ups in our curated activities. Without this the design time look ups in our activities will fail to load.
User(sys_user)readThe Choice table contains translated text for options that appear in choice lists and also for look ups in our curated activities. Without this the design time user related look ups in our activities will fail to load.
Furthermore, the user must also possess the requisite access control for the tables essential to the integration scenario. For instance, if you intend to establish an integration user capable of executing typical ITIL help desk actions (e.g., opening, updating, and closing incidents, problems, changes, and configuration management items), you should assign the itil role.

Creating custom roles

Certain Base system roles, such as admin already encompass access control for these tables. But, if you don't want to assign base system roles and aim to provide only the essential access control required for using the ServiceNow connector, you may consider crafting a custom role with the necessary access permissions.

To grant access exclusively to specific tables or tables not covered by the default base system roles, so we recommend the creation of custom roles and the assignment of the appropriate access control as needed.

After the previously mentioned steps have been carried out, it is imperative to provide your new role with the following access controls in order to utilize the ServiceNow connector/activities.

TableTypeOperation
Tables (sys_db_object) recordread
Dictionary (sys_dictionary) recordread
Choices (sys_choice) recordread
User (sys_user)recordread
Note:
Editing or creating access control is a capability exclusive to a user possessing the security_admin role. If you have any uncertainties, it is advisable to consult your ServiceNow administrator. You can find additional information in elevated privilege roles.

On top of the above, for carrying out activity or trigger executions, you need to provide other access controls as well.

For instance, if your specific scenario involves initiating a workflow with a ServiceNow incident or creating a ServiceNow incident, the following access controls need to be granted.

TableTypeOperation
Incidentrecordread
Incidentrecordwrite

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.