Configure ServiceNow Integration

1. Select All in the upper-left to open the ServiceNow search navigator.

   

2. Enter sys_properties.list in the search bar, then press Enter.

3. Search for the following property:

   Copy Code

   glide.oauth.inbound.client.credential.grant_type.enabled

4. If the property exists, confirm the Value is set to true, and Type is set to true | false.
   1. If the property does not exist:
      1. Select New and enter the following values:
      2. Name: glide.oauth.inbound.client.credential.grant_type.enabled.
      3. Type: true | false.
      4. Value: true.
   2. Select Save.

1. In the ServiceNow navigator, go to User Administration > Users.

   

2. Select New and enter the following values:
   1. UserID: Vasion Integration, or unique name.
   2. First Name: Vasion.
   3. Last Name: Integration.
   4. Identity Type: Machine.
   5. Active: Selected.
   6. Internal Integration User: Selected.
3. Select Submit.
4. Scroll to the Roles related list at the bottom of the user record and select Edit.

5. Search for and add the following roles:

   1. asset: CMDB read and write access.
   2. itil: Required for the Identification & Reconciliation (I&R) API.
   3. oauth_user: Allows the user to authenticate using OAuth.

   

6. Select Save.

1. In the ServiceNow navigator, search for and select Inbound Integrations.

   

2. Select New Integration.
3. In the Select your application connection type modal, select OAuth - Client credentials grant.
4. Enter the following values:
   1. Name: Vasion Integration, or unique name.
   2. Provider Name: Vasion.
   3. OAuth Application User: UserID from the integration user created in step 2.
   4. Active: Selected.
5. Scroll to the Auth scope section and confirm Allow access only to APIs in selected scope is selected.
6. Select Create auth scope and name it vasion_print_integration, then select Save.

7. In the Configure auth scopes section, select the Limit authorization to the following APIs field and:

   1. Type and select Table API. This API queries manufacturers and models.
   2. Type and select Identification and Reconciliation API. This API pushes printer data into the CMDB.

   

   If Allow access only to APIs in selected scope is selected with no scopes configured, all API calls are blocked.

8. (Optional) In Advanced Options, confirm or adjust the following:

   1. Access Token Lifespan: 1800 (30 minutes, the default)
   2. Token Format: Opaque

   Vasion Print automatically requests a new token when the current one expires, so any lifespan value works.

9. Select Save.

1. In the ServiceNow navigator, search for and select CI Identifiers.

   

2. Select New, and give the new record a name.
3. Search for and select Printers in the Applies to dropdown.
4. Confirm the Active and Independent options enabled, then select Submit.
5. Search for and select your identifier app again.

6. In the Identifier Entries tab, select New and:

   1. In the Search on table dropdown, search for and select Printer.
   2. Select Criterion attributes.
   3. Move Serial number to the Selected column.
   4. Set the priority to 100.
   5. Select Active.
   6. Select Submit.

   

7. Use the New button in the Identifier Entries tab to add any additional validation identifiers.

   Vasion recommends adding at least Serial number and Asset Tag. If neither field matches an existing record, ServiceNow creates a new cmdb_ci_printer entry.

8. After adding your Identifier Entries, select the Related Entries tab.
9. Select New, then:
   1. Search for and select Key Value in the Related table dropdown.
   2. Select Configuration item in the Referenced Field dropdown.
   3. Adjust the priority as needed, then select Submit.

1. Search for and select Printers.

   

2. Select the desired printer.

3. From the side menu, select Configure, then Related Lists.

   

4. Locate the desired tags, select, and use the arrows to move them to the Selected column.
5. Select Save when finished.

1. In the Vasion Print Admin Console, go to Admin Integrations .
2. Select the ServiceNow integration.

3. Enter the following values:

   1. ServiceNow Instance URL: e.g., https://your-instance.service-now.com.
   2. Description (Optional): A label for your reference.
   3. Client ID: The Client ID from step 3.
   4. Client Secret: The Client Secret from step 3.
   5. Data Source Name: Vasion_Print (recommended)

   The Data Source Name must exactly match the value you registered in step 4, including capitalization.

4. Select Connect to connect and proceed.

5. In the Add Fields tab, select the Identifier Field(s). Serial Number or Custom field.

   

   If you want to use a different field for the identifier, it must be a custom printer field with a value for each printer object.

6. Use the Additional Fields (Optional) to add more fields to sync.
7. Select Next to proceed.

8. On the Transfer Data tab, adjust the Manual Sync options as needed.

   1. Transfer only changes: Transfer only data that has changed since the last sync.
   2. Transfer all data: Transfer all data regardless of whether it has changed since the last sync.

   

9. Select Sync Now, or Test, to test the sync first.
10. Select Save.

To manually sync printers:

1. In the Vasion Admin Console, go to Admin Integrations .
2. Select the more icon for the ServiceNow integration, then select Settings.
3. Select the Transfer Data tab.
4. Select Sync Now.

Allow time for printers to sync. Beneath the Sync Now button, the sync history displays.