Lansweeper Lansweeper

Integrate Lansweeper to retrieve complete IT asset inventory

The Lansweeper connector allows you to retrieve the complete inventory of your IT assets including hardware, software, users, and network equipment directly into OverSOC.

Objective

The Lansweeper connector retrieves the following information:

  • Complete hardware inventory (servers, workstations, network equipment)
  • Software inventory and licenses
  • Active users and domain accounts
  • Network equipment and configuration

Prerequisites

  • Access to your Lansweeper instance
  • Administrator or audit permissions
  • Ability to generate API tokens

Information to Provide in OverSOC

FieldDescription
Authentication TypePersonal Access Token (PAT) or OAuth
Token/Client IDPersonal Access Token or OAuth Client ID
GraphQL Endpointhttps://api.lansweeper.com/api/v2/graphql

Procedure

Option 1: Generate a Personal Access Token (PAT)

  1. Sign in to your Lansweeper instance.
  2. Navigate to Settings > Developer tools.
  3. Click Add new API client.
  4. Select Personal Access Token.
  5. Provide a token name (e.g., "OverSOC Integration").
  6. Click Generate.
  7. Copy the token immediately (it will not be retrievable later).
  8. Store the token securely for OverSOC configuration.

Option 2: Create an OAuth Client

  1. Sign in to your Lansweeper instance.
  2. Navigate to Settings > Developer tools.
  3. Click Add new API client.
  4. Select OAuth.
  5. Fill in the application details:
    • Name: OverSOC Integration
    • Callback URL: Your OverSOC instance callback URL
  6. Click Create.
  7. Download the credentials (Client ID and Client Secret).
  8. Store the credentials securely for OverSOC configuration.

Configure the Connector in OverSOC

  1. In OverSOC, go to Data Sources Settings > Sources.
  2. Select Lansweeper and click Configure.
  3. Fill in the required fields:
    • Authentication Type: Choose "Personal Access Token" or "OAuth"
    • Token (for PAT): Paste your Personal Access Token
    • Client ID (for OAuth): Your OAuth Client ID
    • Client Secret (for OAuth): Your OAuth Client Secret
    • GraphQL Endpoint: https://api.lansweeper.com/api/v2/graphql
  4. Click Save Configuration.

Reference: Lansweeper API Documentation

Required Permissions

The API token must have the following permissions:

  • Read access to device inventory (Device Inventory)
  • Read access to software and applications
  • Read access to users and accounts
  • Read access to network equipment
  • Read access to reports and status
Previous← ZabbixNextNmap →