ServiceNow

This document describes the Dataworkz connector configuration required to access Service Now.

To setup a connected app, refer to the following steps.

Steps to create ServiceNow Instance

Note: If instance already exists then leave this section and jump to "Steps to create Service Now connected app" section.

1. Go to developer.servicenow.com. Login through "Sign In" link.

   
2. Once login, click on "Request Instance" to Create New instance.

   
3. A new instance creation will be triggered that will take some time to initialise.

4. Once completed a new instance will be created with username and password assigned. Copy these credentials to be used while setting up configuration in Dataworkz. Also copy URL of created instance

   
5. Click on Instance Url to open private service now instance created.

   
6. Setup 2 factor authentication to login into private instance.

Steps to create Service Now connected app

Following are the steps required for setting up private connected app and to use it in Dataworkz.

1. Go to private Service Now instance created for e.g. https://dev188373.service-now.com and click on create “All” menu option. Search “Application Registry” and click on Application Registry.

1. On Application Registry page, click on "New" button (on right top corner), to create new connected app.

   

   
2. Select option "Create an Oauth API endpoint for external clients" (for old applications).

   1. If [Deprecated UI] Create an OAuth API endpoint for external clients is selected, it will open page to create connected app in following format.

      
   2. Select Client Type as "Integration as a Service" and Accessible from "All Application Scopes"

   3. Enter following redirect URL for private connected app. https://<Dataworkz application domain>/dataworkz-web/restApi/oauth/servicenow/get_oauth_token (alternatively you can get the same from Dataworkz Service Now configuration setup)

   4. Provide other details to create connected app. Once submitted, edit the created connected app to get client id and secret.

3. For new app setup, use "New Inbound Integration Experience".

   The New Inbound Integration Experience is the new recommended approach for:

   • Server-to-server integrations

   • Token generation (client_credentials flow)

   • Calling ServiceNow REST APIs (Incident, User, CMDB, etc.)

   

   1. When open click on "New Integration" button, available on top right corner.

      
   2. Select "OAuth - Authorization code grant"

   3. Enter connected App name, redirect Url. Select "This is public client" checkbox if client has to be used publicly i.e. client and server will generate verification code to generate access token.

      
   4. Save configuration to created connected app.

4. Copy client id, secret and private instance url that need to be used while configuring connected app in Dataworkz

Configure Service Now connector in Dataworkz

1. Login to Dataworkz Application

2. Goto Configuration -> SaaS Applications -> ServiceNow

3. Click the + icon to add a new configuration

4. Provide the following information to create ServiceNow configuration.

   1. Client Id - Client id of ServiceNow connected app

   2. Client Secret - Client secret of ServiceNow connected app

   3. Service now Instance Url - Url of ServiceNow private instance created

1. Custom App already created

   1. Select "Yes" if connected app has already been created.

   2. Select "No". Screen with the redirect URL would pop-up. Copy the redirect URL and goto setup Service Now connected app to complete the configuration.

2. Enter the Workspace name

3. Enter the Collection name

4. Select the appropriate Scope from the dropdown

5. Click on save button to save the configuration. System will prompt for Service Now credentials. Use username and password created under steps 3 of “Service Now instance setup”. Click on login after providing credentials.

System will prompt to allow connecting to private instance. Allow this setup to complete the Dataworkz configuration for service now.

Newly created connector would show up in the list of ServiceNow configurations