Lansweeper Extension 

Lansweeper is an IT discovery & inventory management application that helps organizations manage their IT infrastructure from a central location.

The Lansweeper extension helps the IT team link assets managed in Lansweeper with requests tracked from ServiceDesk Plus Cloud.

Role Required: SDOrgAdmin

Benefits 

• Suggest assets based on incident request details.
• Search & associate assets to incident request.
• View associated asset vulnerability and warranty details.
• View incidents related to the associated asset.
• Copy asset details to the clipboard.

Prerequisites 

• ServiceDesk Plus Cloud must be operating in Enterprise edition.
• Create a API key in Lansweeper as explained here.

Generate API Token 

Create a personal application in Lansweeper as explained in the screenshot.

Edit the application and click Authorize.

Choose the token expiration time and select the site where the token provides access. Click Allow.

An identity code is generated. This is the token used for requesting API information. Copy the token and store it in a secure location.

Configure Site ID 

Copy the following API and place a POST API call from any API tool. Paste the generated token to authorize the API call:

API Endpoint: https://api.lansweeper.com/api/v2/graphql
Type: POST
Headers: Content-Type : application/json
Authorization: Token <Generated-Token-Here>
Body (GraphQL):

{

authorizedSites {

sites {

id

name

}

}

}

The following sample response will be generated. Copy the Site ID generated in the response and store it in a secure location:

{

"data": {

"authorizedSites": {

"sites": [

{

"id": "<SITE-ID>",

"name": "api-demo-data-site"

}

]

}

}

}

Configure Permissions for Technicians

The Lansweeper extension will be accessible only to technicians with View, Add, and Delete permissions for Lansweeper Asset Mapping module.

Go to Setup > Users & Permissions > Roles and configure the permissions with technician roles. Alternatively, you can also create a dedicated role with the relevant permissions and assign the role to technicians.

Set Up the Lansweeper Extension 

In ServiceDesk Plus Cloud, go to Setup > Apps & Add-ons > Extensions and install the Lansweeper extension. Alternatively, you can also install the extension directly from ManageEngine Marketplace.

Go to Installed Extensions and select the extension.

Hover over the extension connection and click Connect.

In the pop-up window, enter the authorization token in the following format: Token<insert space> and paste your API token. Example: Token 1234xxxxxxxxxxx.

Associate Assets to Requests 

After the extension is configured, the Lansweeper extension will be added as a widget to the right pane in request details page.

Technicians with permissions configured for the extension can perform the following actions using the Lansweeper widget:

Search and Associate Assets - Click Search and Associate Assets.

1. Select the search criteria
2. Enter the keyword.
3. Select the assets.
4. Click Associate.

View Suggested Assets - Assets are suggested based on the IP address or Mac address details present in the request.

1. Click Suggested Assets to view the assets suggested for association.
2. Select the asset and click Associate.

View Asset Details or Detach Asset - On the associated assets card, click to view the asset details in Lansweeper or detach it from the request.

View Associated Asset Details - Select the associated asset to view the following details:

• The general and association details of the assets will be listed.
• Under Asset Insights, details such as vulnerabilities, software, warranty, and the number of open requests associated with the asset will be displayed.
• Under Linked requests, you view all requests linked with the asset.

Copy Asset Details - Click the associated asset name to view the asset details. On the top right corner, click . The asset details will be copied to the clipboard in key value format.

Generate Report - The details of Lansweeper assets mapped with requests are added under a custom configuration titled Lansweeper Asset Mapping. These details can be obtained as a report.

1. Go to Reports tab and click New Custom Report.
2. Provide a report name.
3. In the Module drop-down, select Lansweeper Asset Mapping under custom modules.
4. Click Proceed to Report Wizard.
5. Select the columns to be displayed on the report. Configure other advanced settings if needed.
6. Click Run Report.

While selecting fields to be added in the report, the following report fields provide details as explained below:

• Created by & Last updated by - User who associated an asset to the request.
• Created time & Last updated time - Time of association between the asset and request.