# ServiceNow ## ServiceNow Dropzone AI integrates with [ServiceNow](https://www.servicenow.com/now-platform.html), a cloud-based platform that provides digital workflow automation. Dropzone supports two methods of authentication for this integration: Basic and OAuth Inbound. {% hint style="info" %} If you wish to use Basic authentication, you may skip to the "Enable ServiceNow" section of this document. {% endhint %} ### Create an OAuth Application User To grant Dropzone access to [tables](https://www.servicenow.com/docs/r/washingtondc/api-reference/rest-apis/c_TableAPI.html) for use in analysis, you will need to add a user (either a dedicated Dropzone User or another user) to an [access control list](https://www.servicenow.com/docs/r/platform-security/access-control/exploring-access-control-list.html). Alternatively, you may use an administrative user as your OAuth Application User, which will allow Dropzone access to most organizational data and tables. {% hint style="info" %} If you choose to use an admin user, you may skip to the "Create an OAuth Inbound Integration" section of this document. {% endhint %} \### Create a New Role To create a new role, do so, do the following: * In the top bar of the ServiceNow home page, click "All" * In the search bar, navigate to System Security > Users and Groups > Roles

* Click "New"

* Name the role something memorable, such as "dz\_table\_read" * Click "Submit"

#### Create an Access Control List To create an ACL, do the following: * In the upper right corner, click your icon * Click "Elevate Role"

* Select security\_admin

{% hint style="info" %} For more information on elevated roles, see [ServiceNow's documentation](https://www.servicenow.com/docs/r/platform-security/c_ElevatedPrivilege.html#:~:text=to%20manually%20elevate-,The%20security_admin%20role,-In%20the%20base) {% endhint %} * Navigate to All > System Security > Access Control (ACL) * Click "New"

* Under "Operation," select "read" * Under "Name," input a table you want Dropzone to have read access to

* Under "Role," input the role you created earlier, e.g. dz\_table\_read

* Click "Submit"

Repeat for every table you want Dropzone to have access to #### Assign the ACL to the Role * Navigate back to Roles * Click on the role you just created * In the "Modules with Role" section, click "New"

* Name the record with the name of the table in question * Click "Link Type" * Under "Table," select your desired table

* Click "Submit" Repeat for every table you want Dropzone to have access to #### Create a Group * Navigate to All > System Security > Users and Groups > Groups

* Click "New"

* Name the role something memorable, such as "Dropzone AI" * Assign yourself (or a dedicated Dropzone User) as the manager * Click "Submit"

* Click "Group Members" * Click "Edit"

* In the search bar under "Collection," add yourself (or a dedicated Dropzone User) * Click the `>` then click "Save"

* In the "Roles" section, click "Edit"

* In the search bar under "Collection," add the role you created earlier * Click the `>` then click "Save"

The user associated with this group will be used as the OAuth Application User. ## Create an OAuth Inbound Integration ServiceNow requires a Client ID and Client Secret to enable. To manage OAuth integrations, you must have access to a user with one of the following roles: oauth\_admin mi\_admin admin To obtain a Client ID and Secret, do the following: * Navigate to All > System OAuth > Inbound Integrations

* In the upper right, click "New Integration" * Select "OAuth - Client Credentials Grant"

* Name the client something memorable, such as "Dropzone AI" * Under OAuth Application User, select the user you assigned earlier * In the "Auth Scopes" section, click "Create auth scope"

* Name the scope something memorable, such as "Dropzone" * Assign the integration the Table API scope

* Click "Submit" * Copy the Client ID and Client secret generated for use later in the Dropzone UI where they are called "Client ID" and "Client Secret" respectively ### Enable ServiceNow To enable the Data Source integration, you will need the following information: | Dropzone Field | Source | | -------------- | -------------------------------------------------------------------------------------- | | Instance URL | Your ServiceNow instance URL, e.g. yourcompany.service-now\.com | | Username | The username of the admin user you are using. Only used for basic authentication | | Password | The password for the aforementioned user's account. Only used for basic authentication | | Client ID | The Client ID value generated earlier | | Client Secret | The Client Secret value generated earlier | To enable the Data Source integration, do the following: * Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app * In the bottom left hand corner, navigate to Settings > Integrations

* Click "Available"

* In the Search bar, search ServiceNow, then click "Configure"

* Under the Data Source heading, input the Instance URL and select your method of authentication from the dropdown

The ServiceNow Data Source Configuration (pt 1)

* If you selected Basic, input the username and password

The ServiceNow Data Source Configuration (pt 2)

* If you selected OAuthInbound, input the Client ID and Secret

The ServiceNow Data Source Configuration (pt 3)

* In the "Table and Query Pairs" section, you must add the [ServiceNow tables](https://www.servicenow.com/docs/r/washingtondc/api-reference/rest-apis/c_TableAPI.html) you want Dropzone to access * To do so, input the name of the table (such as "incident" or "asset") in the Table Name section * Under "Encoded Query," input a ServiceNow [encoded query string](https://www.servicenow.com/docs/r/platform-user-interface/c_EncodedQueryStrings.html) * Click "Add Item" to add more tables

The ServiceNow Data Source Configuration (pt 4)

* Click "Test & Save" to finish If you have any errors or questions, engage your Dropzone AI support representative. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.dropzone.ai/integrations/data/servicenow_data.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.