This documentation explains how to integrate Lansweeper with Autom Mate to automate IT asset management workflows. It includes details about the application, credential setup, and step-by-step guidance on using Lansweeper actions within Autom Mate.
What is Lansweeper?
Lansweeper is a leading IT asset management tool that provides a comprehensive view of your network. It discovers devices, software, and hardware, helping organizations manage their IT infrastructure effectively and gain actionable insights.
Autom Mate Integration with Lansweeper
Autom Mate enables seamless integration with Lansweeper’s APIs, allowing users to automate asset discovery, reporting, and management tasks. With Autom Mate, you can interact with Lansweeper’s rich data capabilities to streamline IT operations and improve efficiency.
Credentials
To enable the Lansweeper integration, users must add their credentials to the Autom Mate Vault. Lansweeper supports two authentication methods: Personal Access Token (PAT) and OAuth 2.0.
1. Personal Access Token (PAT) Authentication
Steps to Add Credential:
Navigate to the Vault Page and click Add New Credential.
Fill in the required fields:
Connector Name: Provide a friendly and globally recognizable name.
Personal Access Token (PAT): Enter your personal access token.
Save the credential.
2. OAuth 2.0 Authentication
Steps to Add Credential:
Navigate to the Vault Page and click Add New Credential.
Fill in the required fields:
Connector Name: Provide a friendly and globally recognizable name.
Authentication Type: Select oauth20.
Client ID: Enter your OAuth Client ID.
Client Secret: Enter the OAuth Client Secret.
Save the credential.
These credentials ensure secure and authorized communication between Autom Mate and Lansweeper’s APIs.
How to Use Actions
Delete Asset
Description and Purpose
The Delete Asset action allows users to remove an asset from Lansweeper. This action is useful for keeping your inventory accurate by removing decommissioned or unnecessary devices.
Usage Stepper
1
Select Lansweeper credentials to Autom Mate’s Vault.
2
Select the Delete Asset action.
3
Provide the required inputs, including Site ID and Asset Key.
4
Execute the action to delete the specified asset.
Inputs
Site ID (Required): The unique identifier of the site containing the asset.
Asset Key (Required): The unique key identifying the asset to be deleted. Or select from the list.
Sample Output
{"application_id":"3a354946-2048-4c68-8269-81188c727cd9","name":"Lansweeper Delete an Asset","fetch_fields": {"inputs": [],"field_steps": [],"excludes": [],"only_last_children":true },"static_fields": [],"display_names": {},"input_value_options": {"site_id": {"type":"string","option_fill_type":"dynamic","option_configuration": {"path":"/api/v2/graphql","type":"select","method":"POST","field_map": {"path":"data.me.profiles","value":"*.site.id","display_name":"*.site.name" },"body_param": {"data": {"query":"query { me { id profiles { id site { id name } } } }" },"content_type":"application/json" },"field_path":"","query_param": {} } } },"outsource_field_map": {},"sample_response": {"key":"output","value": {"data": {"site": {"deleteAssets": ["035769fe-c54d-404a-b285-5a3430acb45a" ] } } } }}
Edit an Asset
Description and Purpose
The Edit an Asset action enables users to modify the properties of an existing asset. This is useful for keeping asset data current and accurate.
Usage Stepper
1
Add Lansweeper credentials to Autom Mate’s Vault.
2
Select the Edit an Asset action.
3
Provide the Site ID, Asset Key, and fields to be updated.
4
Execute the action to update the asset’s information.
Inputs
Site ID (Required): The unique identifier of the site containing the asset.
Asset Key (Required): The unique key identifying the asset.
The Get Sources of a Site action retrieves all data sources associated with a specific site, providing visibility into the site’s configuration.
Usage Stepper
1
Add Lansweeper credentials to Autom Mate’s Vault.
2
Select the Get Sources of a Site action.
3
Provide the required Site ID.
4
Execute the action to retrieve the sources for the specified site.
Inputs
Site ID (Required): The unique identifier of the site.
Sample Output
{"application_id":"3a354946-2048-4c68-8269-81188c727cd9","name":"Lansweeper Get Sources of a Site","fetch_fields": {"inputs": [],"field_steps": [],"excludes": [],"only_last_children":true },"static_fields": [],"display_names": {},"input_value_options": {"site_id": {"type":"string","option_fill_type":"dynamic","option_configuration": {"path":"/api/v2/graphql","type":"select","method":"POST","field_map": {"path":"data.me.profiles","value":"*.site.id","display_name":"*.site.name" },"body_param": {"data": {"query":"query { me { id profiles { id site { id name } } } }" },"content_type":"application/json" },"field_path":"","query_param": {} } } },"outsource_field_map": {},"sample_response": {"key":"output","value": {"data": {"site": {"sources": {"total":1,"pagination": {"limit":500,"current":"c18377ad-b278-4967-80de-e105ed21a061","next":"c18377ad-b278-4967-80de-e105ed21a061","page":"FIRST" },"items": [ {"id":"c18377ad-b278-4967-80de-e105ed21a061","type":"IT","state": {"value":"SYNC","unlinkedOnDate":null,"deletedOnDate":null,"firstSyncCompletedOn":"2024-12-11T09:14:22.793Z" },"createdAt":"2024-12-11T09:08:28.426Z","externalId":null } ] } } } } }}
List All Vulnerabilities of a Site
Description and Purpose
The List All Vulnerabilities of a Site action generates a detailed report of vulnerabilities detected at a specified site, enabling IT teams to prioritize and address security risks.
Usage Stepper
1
Add Lansweeper credentials to Autom Mate’s Vault.
2
Provide the required Site ID.
3
Execute the action to retrieve the list of vulnerabilities.
Inputs
Site ID (Required): The unique identifier of the site.
Sample Output
List Assets of a Site
Description and Purpose
The List Assets of a Site action provides a comprehensive list of all assets associated with a particular site, simplifying inventory management and reporting.
Usage Stepper
1
Add Lansweeper credentials to Autom Mate’s Vault.
2
Select the List Assets of a Site action.
3
Provide the required Site ID.
4
Execute the action to retrieve the list of assets.
Inputs
Site ID (Required): The unique identifier of the site.
