Integrate the ServiceNow instance with your UiPath account using OAuth to authenticate ServiceNow requests.
Before you begin
Role required: admin
Note:
This authentication is available from UiPath spoke v2.2.1.
You can't use MID Server if you set up the spoke using OAuth authentication.
Procedure
Register an application in your UiPath account.
Log in to your UiPath account as an admin.
Navigate to Admin > External Applications.
Click + Add Application.
On the form, fill these values.
Field
Description
Application Name
Name of the OAuth application.
Application Type
Type of OAuth application. Select Confidential application.
Resources
Required resource and scopes.1. Click + Add Scopes. 2. Select Orchestrator API Access from the Resource list. 3. Select these application scopes: - OR.Robots.Read - OR.Robots.Write - OR.Jobs.Read - OR.Jobs.Write - OR.Machines.Read - OR.Execution.Read - OR.Queues.Read - OR.Queues.Write - OR.Folders.Read 4. Click Save.
Redirect URL
ServiceNow instance redirect URL in this format: `https://.service-now.com/oauth_redirect.do`
5. Click **Add**.
The application is registered and values of App ID and App Secret are displayed.
6. Copy and record the values of app ID and app secret.
In your ServiceNow instance, configure the required connection and credential alias.
Log in to your ServiceNow instance as an admin.
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
Click the Create New Connection & Credential related link.
On the form, fill these fields.
Field
Description
Connection information
Name
Name to identify the OAuth application registry record.
Connection URL
Connection URL in this format: https://{base_url}/{organization_name}/{tenant-name}/orchestrator_. This URL depends on the type of UiPath deployment.
Credential information
Name
Name to identify the credential record.
Token URL
Location of the token endpoint that the instance uses to retrieve and refresh tokens. This URL depends on the type of UiPath deployment.
OAuth Client ID
App ID you had copied after registering application in your UiPath account.
OAuth Client Secret
App secret you had copied after registering application in your UiPath account.
OAuth Redirect URL
ServiceNow instance redirect URL in this format: https://<ServiceNow-instance>.service-now.com/oauth_redirect.do.
Click Create.
Click Submit.
Connection and credential records are created.
Open the UiPath Connection record, from the Connections tab.
Select a value for the Orchestrator Feature Enabled field.
Result
The Connection and Credential alias is configured and the UiPath spoke is set up using OAuth authentication.
Option 2: Using API key
Integrate the ServiceNow instance with your UiPath account using API key to authenticate ServiceNow requests.
Before you begin
Role required: admin
Procedure
From your UiPath cloud account, obtain the values of the required API refresh tokens.
Note: These steps are applicable to UiPath cloud account.
Log in to your UiPath account as an admin.
Navigate to Preferences > Privacy & Security.
For the required tenant, click View API access.
The values of User Key, Organization ID, Tenant Name, and Client ID are displayed.
Copy and record these values.
In your ServiceNow instance, configure the required connection and credential alias.
Log in to your ServiceNow instance as an admin.
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
Open the record for UiPath.
For Configuration Template, select UiPath Configuration Template - UiPath Cloud or UiPath Configuration Template - Private/Public Cloud as per your requirement.
Click the Create New Connection & Credential related link.
On the form, fill these fields.
If you have selected UiPath Configuration Template - UiPath Cloud for Configuration Template, fill these fields.
Note: This option is applicable if you are using UiPath cloud account.
Field
Description
Connection Name
Name to identify the connection record. For example, UiPath Connection.
Connection URL
Connection URL in this format: https://platform.uipath.com/<account-logical-name>/<instance-logical-name>
Credential Name
Name to identify the credential record. For example, UiPath Credential.
Token URL
Location of the token endpoint that the instance uses to retrieve and refresh tokens. For example, https://account.uipath.com/oauth/token.
Client Id
Value of client ID you had copied from the UiPath Orchestrator application.
Account Logical Name
Organization ID you had copied from the UiPath Orchestrator application.
Tenant Logical Name
Tenant name you had copied from the UiPath Orchestrator application.
User Key
User key you had copied from the UiPath Orchestrator application.
If you have selected UiPath Configuration Template - Private/Public Cloud for Configuration Template, fill these fields.
Field
Description
Connection Name
Name to identify the connection record. For example, UiPath Connection.
Connection URL
UiPath instance URL.
Credential Name
Name to identify the credential record. For example, UiPath Credential.
Token URL
Location of the token endpoint that the instance uses to retrieve and refresh tokens in this format: http://<instance-URL>/api/account/authenticate
Tenant Name
Tenant logical name.
Username or email
Username or email address to authenticate the UiPath Orchestrator API.
Password
Associated password.
Note:
You must enable Use MID server option in the connection record and create a SSL certificate from a trusted authority for on-prem support.
The MID Server users must have the sn_uipath_spoke.uipath_admin role.
Click Create.
Click Submit.
Connection and credential records are created.
Open the UiPath Connection record, from the Connections tab.
Select a value for the Orchestrator Feature Enabled field.
Result
The Connection and Credential alias is configured and the UiPath spoke is set up using API key.