--- title: How do I connect to ServiceNow as an inventory source? description: Learn how to connect to your ServiceNow asset inventory to audit your protected and unprotected resources --- [Skip to content](https://help.bocada.com/knowledge/servicenow-inventory#main-content) English Show submenu for translations [Customer portal](https://help.bocada.com/tickets-view?hsLang=en) [![Bocada-Cloud-Logo-2023-1](https://help.bocada.com/hs-fs/hubfs/Bocada-Cloud-Logo-2023-1.png?width=300&height=74&name=Bocada-Cloud-Logo-2023-1.png)](https://help.bocada.com/knowledge?hsLang=en) - [Support Tickets](https://8890471.hs-sites.com/tickets-view) Open main navigation Close main navigation - [Support Tickets](https://8890471.hs-sites.com/tickets-view) - English Show submenu for translations - [Customer portal](https://help.bocada.com/tickets-view) Welcome to Bocada Cloud! How can we help? - There are no suggestions because the search field is empty. 1. [Bocada Cloud Support Portal](https://help.bocada.com/knowledge?hsLang=en) 2. [Connectors & Backup Applications](https://help.bocada.com/knowledge/connectors-backup-applications?hsLang=en) # How do I connect to ServiceNow as an inventory source? ## Learn how to connect to your ServiceNow asset inventory to audit your protected and unprotected resources The Bocada Cloud Inventory CMDB (Configuration Management Database) connector collects asset data from a variety of different inventory sources, including ServiceNow. By adding your asset inventory to Bocada Cloud, you can take advantage of [Unprotected Resource Audit reporting](https://help.bocada.com/knowledge/unprotected-resource-audit?hsLang=en). Follow the step-by-step instructions below to connect Bocada Cloud to your ServiceNow inventory.  ### ServiceNow User Credentials Bocada Cloud supports connectivity to the ServiceNow CMDB schema through a direct REST API integration. You will need to create a new user, or identify an existing user, in ServiceNow to use for the Bocada Cloud connection. Once you have done so, add the ODBC role to that user account. This will be a read-only user and you may use the ServiceNow security features to limit the access of this user to only the tables that you want to access such as cmdb\_ci\_server and/or cmdb\_ci\_computer tables.  ### Create the Connection in Bocada Cloud Log into Bocada Cloud and on the left navigation menu, select *Connections* \> *+Add* to add a new connection. Then*,* click the *Inventory (CMDB)* tile. *Note*: In Bocada Cloud, the configuration interface is unified across all CMDB connector types. All integration methods use the same configuration fields, with relevant fields displayed based on the selected connector type.  ### Download and Install the Bocada Cloud Data Collection Agent Next, you will need to download and install the [Bocada Cloud Data Collection Agent](https://help.bocada.com/knowledge/data-collection-agent?hsLang=en) in the private network where your ServiceNow instance resides. The agent will connect to it to collect data locally and send it to Bocada Cloud for [Resource Audit reporting](https://help.bocada.com/knowledge/unprotected-resource-audit?hsLang=en). Follow the prompts on the screen to: (1) give the agent a name, (2) download and install it, (3-4) copy a unique Authentication key and paste it into the agent to register it, and then (5) test that the connection between the agent and Bocada Cloud is working correctly.  *Note*: We recommend installing the agent on the same system (machine/server) where ServiceNow is installed to simplify the connection.   ### Add Connection Details After you have successfully installed the Bocada Cloud Data Collection agent, the next screen will ask you add configuration details for the connection.  #### 1 - Organization Select which Organization you want to associate the data from the ServiceNow inventory connection. If you have not set up more than one Organization, it will default to your main Organization (Billing Entity for your Bocada Cloud account). #### 2 - Connection Name Enter the name of the ServiceNow CMDB instance as the connector name. The name does not need to be an exact match to the instance, but we recommend naming the connector so that it is clear which instance the data belongs in the UI and reports.  #### 3 - Product Select *ServiceNow (REST API)* from the product dropdown menu.  #### 4 - Username & Password Enter the credentials for the user you set up in step 1 that can access the ServiceNow CMDB instance through REST API.  #### 5 - CMDB Instance Name (or full instance URL) Enter the name of the ServiceNow instance. For example, if your instance URL is: *https://dev12345.service-now.com/* then the instance name will be 'dev12345'. Only this short name is needed, but you can also enter the full instance URL.  #### 6 - CMDB Table (Class) Enter the CMDB table name from ServiceNow. The table (Class) name can be retrieved from the ServiceNow CMDB Workspace UI. Common tables include: cmdb\_ci\_computer, cmdb\_ci\_server.  #### 7 - Query Params Enter the query param string that will be used to filter the CMDB when gathering data. *Note*: you don't need to include sysparam\_query= in the field value since Bocada Cloud already adds it. For more information, you can check the [ServiceNow official API reference: Table API | ServiceNow Developers](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html). #### 8 - Field List Enter the fields that will be retrieved through the REST API, with matching fields in Bocada. The Bocada fields are: | **Type** | **Column Name** | **Display Name** | **Description** | | --- | --- | --- | --- | | **REQUIRED KEY** | clientfqname | CMDB: Client Name | Required name to cross match with client name in Bocada database, often the CI if ServiceNow | | KEY | clientname | CMDB: Alt Name | Additional backup client name, e.g. backup name or short name used to cross reference CMDB name with Bocada backup client name | | **REQUIRED** | clientrecordid | CMDB: Client Identifier | CMDB CI unique identifier, e.g. sys\_id | | INFO | contact | CMDB: Contact | Info | | INFO | contactemail | CMDB: Contact Email | Info | | INFO | backupproductname | CMDB: Backup Product | Info | | INFO | backupproductversion | CMDB: Backup Product Version | Info | | INFO | osname | CMDB: Operating System | Usually os in ServiceNow | | INFO | osversion | CMDB: Client OS Version | Usually os\_version in ServiceNow | | INFO | passexp | CMDB: Password Expiration | Info | | INFO | ipaddress | CMDB: IP Address | Usually ip\_address in ServiceNow | | INFO | ipaddressbackup | CMDB: IP Address2 | Info | | INFO | lastaccessdate | CMDB: Last Accessed Time | Usually sys\_updated\_on in ServiceNow | | INFO | commissioneddate | CMDB: Commissioned Date | Info | | INFO | decommissioneddate | CMDB: Decommissioned Date | Info | | INFO | backuprequired | CMDB: Backup Required | The default value is True. It's set to False for the following values: False, 0, N, No Any other value is set to True. | | INFO | tag | CMDB: Tag | Info | | INFO | cmdb\_ci\_name | CMDB: Configuration Item (CI) | Info | | INFO | cmdb\_company | Client info: CMDB Company | Usually dv\_company in ServiceNow | | INFO | cmdb\_account | Client info: CMDB Account | Info | | CUSTOM | custom1 | CMDB: Custom Field 1 | Custom informational field displayed in reports | | CUSTOM | custom2 | CMDB: Custom Field 2 | Custom informational field displayed in reports | **Syntax**:  \ AS \[\\], \ AS \[\\], ...  **Example**:  sys\_id AS \[clientrecordid\]  , name AS \[clientfqname\]  , sys\_created\_on AS \[commissioneddate\]  , u\_decommissioning\_date AS \[decommissioneddate\]  , it\_application\_owner.display\_value AS \[contact\]  *Notes*: Multiline values are supported. Also, the brackets \[ \] are optional if the Bocada field doesn't have spaces in the name. #### 9 - OAuth 2.0 Select Yes from the drop-down menu if your ServiceNow account has OAuth 2.0 authentication enabled. Otherwise, it will default to No. - **OAuth Client Id:** Enter your OAuth 2.0 Client Id defined in ServiceNow (if OAuth is enabled). - OAuth Client Secret: Enter your OAuth 2.0 Client Secret bound to your Client Id (if OAuth is enabled). #### 10 - Security Protocol Select the TLS/security protocol to use for the HTTPS connection. Use the most secure option supported by your environment (TLS 1.3, 1.2 or 1.1). This field will default to TLS 1.2.  #### 11 - Proxy Server Select whether your environment uses a Proxy Server to communicate to HTTP/S resources. - **No**: Will not use a proxy server to communicate to the ServiceNow REST API. This is the default selection. - **Yes**: It will display additional fields for the Proxy Server Host and Proxy Server Port for manual proxy configuration. #### 12 - Time Zone Enter the time zone where the ServiceNow instance resides.  ### Test the Connection Click the Next button to test the connection.  If the connection is successful, Bocada Cloud will begin collecting asset data from ServiceNow to populate the *Resource Audit* report.   If the connection is unsuccessful, you will be able to click the “Previous” button to edit your connection details and try again.  If you have issues connecting to your ServiceNow inventory after trying these steps, create a Support Ticket in Bocada Cloud, or [contact us](https://www.bocada.com/bc-contact/).     - [Getting Started](https://help.bocada.com/knowledge/getting-started?hsLang=en) - [Connectors & Backup Applications](https://help.bocada.com/knowledge/connectors-backup-applications?hsLang=en) - [Dashboards](https://help.bocada.com/knowledge/dashboards?hsLang=en) - [Reports](https://help.bocada.com/knowledge/reports?hsLang=en) - [Alerts & Notifications](https://help.bocada.com/knowledge/alerts-notifications?hsLang=en) - [Manage My Account & Profile](https://help.bocada.com/knowledge/manage-my-account-profile?hsLang=en) - [Users & Organizations](https://help.bocada.com/knowledge/users-organizations?hsLang=en) - [System Settings](https://help.bocada.com/knowledge/system-settings?hsLang=en) - [Help & Support](https://help.bocada.com/knowledge/help-support?hsLang=en) - [Technical Infrastructure](https://help.bocada.com/knowledge/technical-infrastructure?hsLang=en) - [Other & Miscellaneous](https://help.bocada.com/knowledge/other-miscellaneous?hsLang=en) - [Privacy & Security](https://help.bocada.com/knowledge/privacy-security?hsLang=en) - [Billing & Payment](https://help.bocada.com/knowledge/billing-payment?hsLang=en) - [Bocada.com](https://www.bocada.com/) - [Terms & Conditions](https://www.bocada.com/bocada-cloud-terms-conditions/) - [Privacy Policy](https://www.bocada.com/privacy-policy/) Copyright © 2026, Bocada