Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Limitations and 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 access ServiceNow endpoint.

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

Client ID*

String

N/A

Specify Provide 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 Provide 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 Provide the access token for the application , which that you obtain when setting up the account for the endpoint. 

Info

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 that you obtain when setting up the account for the endpoint.

Info

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.

Info

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-110

OAuth2 Endpoint*

String

N/A

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

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

OAuth2 Token*

String

N/A

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

Default Value: N/A
Example: https://ven02371.service-now/oauth_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.

  • 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 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

Auto-refresh token

Checkbox

N/A

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

Default Value: Deselected 

...