Skip to end of banner
Go to start of banner

ServiceNow OAuth2 Account

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

In this article

Overview

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

Prerequisites

None.

Limitations

  • ServiceNow does not support Client Credentials grant type.

  • It supports only Authorization Code and Password grant types.

Known Issues

None.

Account Settings

Field names marked with an asterisk ( * ) are mandatory.

Field Name

Field Type

Field Dependency

Description

Label*

String

N/A

Specify a unique label for the account.

Default Value: [None]
ExampleServiceNow OAuth2 Account

Instance

String/Expression

N/A

Specify the instance to be used to access ServiceNow endpoint.

Default Value: N/A
Examplehttps://abc.servicenow.com

Client ID*

String

N/A

Specify the client ID that you obtain after configuring the app in ServiceNow. For more information, see Application configuration in ServiceNow portal to use in ServiceNow OAuth2 Account.

Default Value: N/A
Exampleabcd12345xyz567

Client secret

String

N/A

Specify the value for user authentication that you obtain after configuring the app in ServiceNow.

Default Value: N/A
Examplezcvfc098adfdb343s

Access token*

String

N/A

Specify the access token for the application, which you obtain 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
Examplenpo98yh

Refresh token

String

N/A

Specify the refresh token for the application, which you obtain 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

Specify the expiry value for the access token. 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-1

Header authenticated

Checkbox

N/A

Select this checkbox to enable the endpoint's bearer header authentication.

Default Value: Deselected
Example: N/A

OAuth2 Endpoint*

String

N/A

Specify the endpoint to authorize the application in the following format:
https://<service now instance name>.service-now.com/token.do

Default Value: N/A
Example: https://ven02371.service-now.com/endpoint.do

OAuth2 Token*

String

N/A

Specify the endpoint to get the access token in the following format:
https://<service now instance name>.service-now.com/token.do

Default Value: N/A
Example: https://ven02371.service-now/token.do

Grant Type

Dropdown list

Enables Username and Password fields for password grant type.

Choose the grant type for authentication to the endpoint. Available options are:

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

  • client_credentials: This grant type allows the client to use its own credentials, instead of impersonating a user to authenticate when calling another web service.

  • password: This grant type exchanges your credentials for an access token. It is one of the simplest OAuth2 grants and 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.

ServiceNow supports only and authorization_code and password grant types; it does not support client_credentials grant type.

Default Value: authorization_code
Example: password

Username

String

Enabled on selecting password for Grant Type.

Specify the username for the resource owner.

Default Value: N/A
Example: admin

Password

String

Enabled on selecting password for Grant Type.

Specify the password of the resource owner.

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

Token endpoint config

Use this field set to define custom properties for the OAuth2 token endpoint. This field set contains the following fields:

  • Token endpoint parameter

  • Token endpoint parameter value

Token endpoint parameter

String

N/A

Optional. Specify the parameter for the token endpoint.

Default Value: N/A
Examplescope

Token endpoint parameter value

Integer

N/A

Optional. Specify the value for the token endpoint parameter.

Default Value: N/A
Exampleread, write

Auth endpoint config

Use this field set to define custom properties for the OAuth2 authentication endpoint. This field set contains the following fields:

  • Authentication parameter

  • Authentication parameter value

Authentication parameter

String

N/A

Optional. Specify the parameter for OAuth2 authentication.

Default Value: N/A

Authentication parameter value

Integer

N/A

Optional. Specify the value for the OAuth2 authentication parameter.

Default Value: N/A

Auto-refresh token

Checkbox

N/A

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

Default Value: Deselected 

Troubleshooting

Error

Reason

Resolution

401 authentication error.

The Header authentication checkbox must be selected, if the endpoint uses bearer header authentication.

Select the Header authenticated checkbox.

Snap Pack History


See Also

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

https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary

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

  • No labels