ServiceNow OAuth2 Account

In this article

Overview

You can use this account type to connect ServiceNow Snaps with data sources that use the ServiceNow OAuth2 account.

Prerequisites

Create an app in ServiceNow portal for your ServiceNow instance.

Limitations and Known Issues

None.

Account Settings

servicenow-oauth2-account-overview.png

 

Field Name

Field Type

Field Dependency

Description

Field Name

Field Type

Field Dependency

Description

Label*

String

N/A

Specify a unique label for the account.

Default Value: None
Example: ServiceNow OAuth2 Account

Instance*

String/Expression

N/A

Specify the instance to access ServiceNow endpoint.
If your ServiceNow URL is https://abc.service-now.com, then the instance name is abc.

Default Value: N/A
Example: https://abc.service-now.com

Client ID*

String

N/A

Provide the client ID to use for authorization. Learn more: Application configuration in ServiceNow portal to use in ServiceNow OAuth2 Account.

Default Value: N/A
Example: 45b546f46b004d10d275c2b553bc7g44

Client Secret

String

N/A

Provide the client secret for authorization of OAuth2 account.

Default Value: N/A
Example: zcvfc098adfdb343s

Access Token*

String

N/A

Auto-generated upon account authorization. The access token for the application that is generated when setting up the account for the endpoint. 

Access tokens have limited lifetimes; you must get a new access token after it expires.

Default Value: N/A
Example: npo98yh

Refresh token

String

N/A

Auto-generated upon account authorization. The refresh token for the application that is generated when setting up the account for the endpoint.

To access the API beyond the lifetime of a single access token, your application can obtain a refresh token. The application stores the refresh token for future use and automatically refreshes the access token before it expires.

Default Value: N/A
Example: N/A

Access Token Expiration

Integer

N/A

The time (in seconds) until which the access token must be valid. It represents the number of refresh tokens per user account per client.

If there is no date of expiration, -1 is the default value. In such cases, the access token is refreshed on a regular interval, for instance, every hour.

Default Value: N/A
Example: 10

OAuth2 Endpoint*

String

N/A

Specify the OAuth2 endpoint in the following format to authorize the application.

https://<servicenow instance name>.service-now.com/oauth_auth.do

Default Value: N/A
Example: https://myinstance.service-now.com/oauth_auth.do

OAuth2 Token*

String

N/A

Specify the value for OAuth2 token in the following format to get the access token.
https://<servicenow instance name>.service-now.com/oauth_token.do

Default Value: N/A
Example: https://myinstance.service-now.com/oauth_token.do

Grant Type

Dropdown list

Enables Username and Password fields for password grant type.

Choose an authentication grant type for your ServiceNow instance. Available options are:

  • authorization_code: This grant type is used to obtain access tokens and refresh tokens from the authorization server.

  • password: Exchanges your credentials for an access token. This grant type involves the traditional username and password login to obtain the user's credentials and makes a POST request to the server to exchange the password for an access token.

Default Value: authorization_code
Example: password

Username

String

Enabled on selecting password for Grant Type.

Specify the username to connect to ServiceNow.

Default Value: N/A
Example: admin

Password

String

Enabled on selecting password for Grant Type.

Specify the password connect to ServiceNow.

Default Value: N/A
Example: p@$$w019

Auto-refresh Token

Checkbox

N/A

Select this checkbox to enable auto-refresh of the access token before it expires.

Default Value: Deselected 

Snap Pack History


Related Content:

Application Configuration in ServiceNow Portal for OAuth2 Account to use in ServiceNow

https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1438341/Getting+Started