# Configuration guide: Device assignment verification

## Introduction <a href="#configurationguide-deviceassignmentverification-introduction" id="configurationguide-deviceassignmentverification-introduction"></a>

If the ServiceNow Hardware Asset Management database isn’t kept current, it can lead to a range of operational challenges. Inaccurate documentation of a device’s current user can disrupt resource retrieval processes, causing delays and confusion when devices need to be collected for maintenance or upgrades. This discrepancy can also result in applications being installed incorrectly or not at all. Thus, maintaining up-to-date assignee information is crucial for the efficiency of resource retrieval and the security of the overall IT asset management system.

This page will guide you through the structure of the content.

## Content list and dependency <a href="#configurationguide-deviceassignmentverification-contentlistanddependency" id="configurationguide-deviceassignmentverification-contentlistanddependency"></a>

| Type                                                              | Name                                             | Description                                             | Dependencies                                |
| ----------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------- | ------------------------------------------- |
| [Workflows](https://nexthink.gitbook.io/opd/user-guide/workflows) | Device assignment verification                   | Verification and update of device assignee information. |                                             |
| [Campaigns](https://nexthink.gitbook.io/opd/user-guide/campaigns) | Device assignment verification - Workflow invoke | Ask if user is primary owner of the device.             | Workflow parameter activates this campaign. |

## Configuration guide <a href="#configurationguide-deviceassignmentverification-configurationguide" id="configurationguide-deviceassignmentverification-configurationguide"></a>

To effectively use this library pack, the content must be installed and configured appropriately. Below are some suggested steps to install and configure the content properly before use.

#### **Step 1) Install library pack content**

Go to the [Nexthink Library](https://nexthink.gitbook.io/opd/user-guide/nexthink-library) and install all required content.

#### **Step 2) Edit campaigns**

Navigate to the [manage campaigns](https://nexthink.gitbook.io/opd/user-guide/campaigns/managing-campaigns) administration page to review and edit your campaigns.

For each installed campaign, please ensure to:

* Customize the sender name and image.
* Review and adjust questions.
* Publish the campaign when you are ready to use it.

We recommend the following configurations for these campaigns:

| Name                           | Trigger | Priority |
| ------------------------------ | ------- | -------- |
| Device assignment verification | API     | Urgent   |

#### **Step 3) Configure ServiceNow integration**

The configuration of connector credentials is essential for enabling API calls. See detailed information at <https://nexthink.gitbook.io/opd/integrations/outbound-connectors/connector-credentials>. Each Service/API thinklet has a dropdown field for credentials that needs to be filled out. When the workflow is installed or copied from the Library, this field will be blank as it is a local setup of each environment and is not included in the Library.

<div data-full-width="false"><figure><img src="/files/4eCvN5Dj6V66LVulVgjk" alt=""><figcaption></figcaption></figure></div>

#### **Step 4) Check workflow parameters**

The parameters for the workflow are provided below. There is no need for adjustments as the preset values are already optimized for use.

* **Ask for permission?**: This parameter controls the option of updating the assignee with or without user consent. It has two possible values: "Yes", which means that a campaign should be triggered to obtain user consent, or "No", which means that the changes of device assignment will be done without user consent.
* **Event trigger AD user name**: This parameter is essential for the workflow’s integration with the event trigger. In the subsequent “Maintain workflow trigger” step, this parameter will be associated with the user AD name field in the event trigger’s NQL query.
* **Event trigger device name:** This parameter is essential for the workflow’s integration with the event trigger. In the subsequent “Maintain workflow trigger” step, this parameter will be associated with the device name field in the event trigger’s NQL query.

#### **Step 5) Maintain API thinklets locally defined credentials**

Each Service/API thinklet requires locally maintained credentials. In this step review all relevant thinklets and maintain credentials.

<div data-full-width="false"><figure><img src="/files/mqljL41cpfgcvauz9Clt" alt="image-20240322-102209.png"><figcaption></figcaption></figure></div>

#### **Step 6) Maintain workflow trigger**

This workflow is designed to run automatically using an event trigger.

The following query can be used to trigger a workflow event. It selects all non-virtual devices. If necessary, manual custom fields can be included in the query to exclude specific devices, such as “kiosk” or “training” devices, or to exclude service desk agent users who frequently log in to other users’ devices.

<div data-full-width="true"><figure><img src="/files/c15uSOEcXElwuNNMj3gq" alt="image-20240321-161708.png"><figcaption></figcaption></figure></div>

```
Code
1 session.logins
2 | where device.hardware.type != virtual
3 | list device.name, user.ad.username
```

## Usage guide <a href="#configurationguide-deviceassignmentverification-usageguide" id="configurationguide-deviceassignmentverification-usageguide"></a>

Your content is now configured and ready to be used. For usage overview and recommendations, you can visit the usage guide:

[Usage guide: Device assignment verification](/platform/library-packs/device-landscape/workflow_-device-assignment-verification/usage-guide_-device-assignment-verification.md)

***

RELATED TOPICS

* [Manage Workflows](https://nexthink.gitbook.io/opd/user-guide/workflows/managing-workflows)
* [Manage Campaigns](https://nexthink.gitbook.io/opd/user-guide/campaigns/managing-campaigns)


---

# 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.nexthink.com/platform/library-packs/device-landscape/workflow_-device-assignment-verification/configuration-guide_-device-assignment-verification.md?ask=<question>
```

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.