(Example) How to Get the Access Token Credentials from ServiceNow

Prerequisites

• A ServiceNow Developer account.

Good to Know

• This example uses Paris release for ServiceNow.
• OAuth 2.0 access tokens require a 2-way exchange of credentials between AgilePoint NX and the external service. This means that you must get the credentials from the third-party service to paste in the AgilePoint NX access token, and get the redirect URI from AgilePoint NX to paste in the external service. This requires you to open both the AgilePoint NX access token and the third-party service at the same time, so you can copy and paste from one screen to the other.

  This topic shows the suggested procedure for ServiceNow. The exact procedure for your access token depends on whether you already have a connection (usually called an app) configured in the external service.

• This topic gives one example. The procedure may vary depending on your configuration and account settings in the third-party service.
• Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

First, create a new access token in AgilePoint NX for ServiceNow.

How to Start

• There is more than one way to create an access token.

  For more information, refer to Access Token for ServiceNow.

Procedure

1. In AgilePoint NX, open the access token configuration screen for ServiceNow.

   
   
   

2. Select OAuth 2.0 Authentication.

   
   
   

   Do not configure the access token credentials.

   Keep the access token configuration screen open in AgilePoint NX, but do not save it.

Next, create an instance in ServiceNow.

How to Start

1. In a new web browser tab, sign in to your ServiceNow Developer account:
   • https://developer.servicenow.com/.

Procedure

1. In ServiceNow, on the right pane, click Request Instance.

   
   
   

2. On the Request an Instance screen, in the Choose your release section, select your release.

   
   
   

3. Click Request.

   
   
   

   The Your instance is ready! screen shows the Instance URL and the login credentials for your Instance.

   
   
   

Next, copy an instance name in ServiceNow.

How to Start

1. In one web browser tab, open the Your instance is ready! screen.

   For more information, refer to Create an Instance in ServiceNow.

2. In a different web browser tab, in AgilePoint NX, open the ServiceNow access token configuration screen.

Procedure

1. In ServiceNow, on the Your instance is ready! screen, copy the instance name in your instance URL.

   
   
   

2. In AgilePoint NX, on the ServiceNow Access Token Configuration screen, in the Instance Name field, paste the instance name value from ServiceNow.

   
   
   

3. In ServiceNow, on the Your instance is ready! screen, click Return to the Developer Site.

   
   
   

   The ServiceNow screen shows.

Next, create an app in ServiceNow.

How to Start

1. On the ServiceNow screen, in the left pane, click your instance URL.

   
   
   

   A new tab or window opens in your web browser.

2. In a new web browser tab, sign in to your ServiceNow Instance.

Procedure

1. In ServiceNow, on the left pane, in the Filter navigator field, enter OAuth.

   
   
   

2. In the System OAuth tab, click Application Registry.

   
   
   

3. In the Application Registries screen, click New.

   
   
   

4. On the OAuth application screen, in the What kind of OAuth Authentication? section, click Create an OAuth API endpoint for external clients.

   
   
   

5. On the Application Registries - New Record screen, in the Name field, enter an app name.

   AgilePoint recommends you use an app name associated with your AgilePoint NX app or the way you want to use the app in AgilePoint NX.

   
   
   

6. Click Submit.

   
   
   

   The Application Registries screen shows.

   
   
   

Next, copy the ServiceNow app credentials to your AgilePoint NX access token.

How to Start

1. In one web browser tab, on the Application Registries screen, open the app you created in ServiceNow.

   For more information, refer to Create an App in ServiceNow.

2. In a different web browser tab, in AgilePoint NX, open the ServiceNow access token configuration screen.

Procedure

1. In ServiceNow, on the Application Registries - AgilePoint NX Sales Invoice App screen, in the Client ID field, copy the Client ID value.

   
   
   

2. In AgilePoint NX, on the ServiceNow Access Token Configuration screen, in the Client ID field, paste the Client ID value from ServiceNow.

   
   
   

3. In ServiceNow, to view the client secret, on the Application Registries - AgilePoint NX Sales Invoice App screen, in the Client Secret field, click Toggle Password Visibility.

   
   
   

4. Copy the Client Secret value.

   
   
   

5. In AgilePoint NX, on the ServiceNow Access Token Configuration screen, in the Client Secret ID field, paste the Client Secret value from ServiceNow.

   
   
   

Next, configure the Redirect URL in the ServiceNow app that connects your AgilePoint NX app.

How to Start

1. In one web browser tab, in AgilePoint NX, open the ServiceNow access token configuration screen.
2. In a different web browser tab, open the Application Registries - AgilePoint NX Sales Invoice App screen.

   For more information, refer to Copy the ServiceNow App Credentials.

Procedure

1. In AgilePoint NX, on the ServiceNow Access Token Configuration screen, in the Redirect URL field, copy the Redirect URL value.

   This is an example value. In a production environment, copy the actual Redirect URL from AgilePoint NX.

   
   
   

2. In ServiceNow, on the Application Registries - AgilePoint NX Sales Invoice App screen, in the Redirect URL field, click Edit this URL.

   
   
   

3. Paste the Redirect URL value from AgilePoint NX.

   
   
   

4. Click Update.

   
   
   

Next, complete the AgilePoint NX access token configuration for ServiceNow.

How to Start

1. In AgilePoint NX, open the ServiceNow access token configuration screen.

Procedure

1. In AgilePoint NX, on the ServiceNow Access Token Configuration screen, in the Token Name field, enter a name for the access token.

   
   
   

2. Click Get OAuth 2.0 Access Token.

   
   
   

   A new tab or window opens in your web browser.

3. On the new tab, in the ServiceNow screen, click Allow.

   
   
   

   The new tab or window closes in your web browser, and the ServiceNow access token screen shows the OAuth 2.0 access token in the OAuth 2.0 Access Token field.

   
   
   

4. Click Done.