> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threataware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lansweeper

> Connect ThreatAware to Lansweeper for asset discovery and inventory management

## Overview

The Lansweeper integration enables ThreatAware to collect read-only data from your Lansweeper platform, providing visibility into device inventory, asset details, and IT infrastructure.

<Info>
  **Connection Method**: API
  **Setup Time**: 15 minutes
  **Access Required**: Lansweeper Administrator account
</Info>

## Data collected

The Lansweeper integration provides:

* Device inventory and asset details
* Hardware and software information
* Network configuration data
* Asset discovery information

## Use cases

<CardGroup cols={2}>
  <Card title="Asset Discovery" icon="magnifying-glass">
    Discover and inventory devices across your IT infrastructure
  </Card>

  <Card title="Hardware Tracking" icon="microchip">
    Monitor hardware specifications and asset details
  </Card>

  <Card title="Inventory Management" icon="database">
    Maintain accurate inventory of all IT assets
  </Card>

  <Card title="Compliance Verification" icon="shield-halved">
    Verify asset management controls and configurations
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to Lansweeper Console">
    Access the [Lansweeper Console](https://your-lansweeper-url.com) with an administrator account.
  </Step>

  <Step title="Navigate to API Access">
    In the Lansweeper admin panel:

    * Go to **Configuration** > **API Access**
    * Review the available API options
  </Step>

  <Step title="Generate API Key">
    Create a new API key for ThreatAware:

    * Click **Generate API Key**
    * Provide a descriptive name (e.g., "ThreatAware Integration")
    * Set permissions to **Read-only** unless additional access is required
    * Click **Generate** to create the key
    * Copy the **API Key** (this is displayed only once)

    <Warning>
      Store the API Key securely. You will not see it again after this step.
    </Warning>
  </Step>

  <Step title="Identify Your Lansweeper URL">
    Determine your Lansweeper instance URL:

    * This is typically in the format `https://your-instance.lansweeper.com`
    * Copy this URL for use in ThreatAware
  </Step>

  <Step title="Configure in ThreatAware">
    In ThreatAware, go to **Integrations** and select **Lansweeper**:

    * Paste the **API Key**
    * Enter the **Lansweeper URL**
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting, verify the integration status:

    * Check that the **Integration Status** shows as **Active**
    * Wait for initial data synchronization
    * Verify asset data appears in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API Key" icon="key">
    **Field Name**: Lansweeper API Key
    **Type**: Password (encrypted)
    **Description**: The API key generated in Lansweeper's Configuration > API Access section

    Example: `abc123def456xyz789`

    <Tip>
      Store this credential securely in your password manager.
    </Tip>
  </Accordion>

  <Accordion title="Lansweeper URL" icon="globe">
    **Field Name**: Lansweeper URL
    **Type**: String
    **Description**: The base URL of your Lansweeper instance

    **Format**: `https://your-instance.lansweeper.com`

    **Examples**:

    * `https://demo.lansweeper.com`
    * `https://company-instance.lansweeper.com`
  </Accordion>
</AccordionGroup>

## Verification and testing

After setup, verify the integration is working correctly:

1. **Check Integration Status**
   * Navigate to **Integrations** in ThreatAware
   * Confirm the Lansweeper integration shows **Active** status

2. **Verify Data Collection**
   * Wait for initial data sync
   * Search for a known device in ThreatAware
   * Verify Lansweeper asset data appears in device details

3. **Test Queries**
   * Create a test query to filter devices with Lansweeper data
   * Verify the asset details match your Lansweeper inventory

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API Key Error" icon="triangle-exclamation">
    **Symptoms**: Integration status shows authentication failure

    **Solutions**:

    * Double-check that the **API Key** is entered correctly
    * Ensure the key was copied entirely without extra spaces
    * Verify the API key hasn't expired in Lansweeper
    * Generate a new API key if the current one is invalid
    * Confirm the key has read permissions in Lansweeper
  </Accordion>

  <Accordion title="Invalid Lansweeper URL" icon="ban">
    **Symptoms**: Connection timeout or "Cannot reach server" error

    **Solutions**:

    * Verify the **Lansweeper URL** is correct and accessible
    * Ensure the URL uses `https://` protocol
    * Test the URL in a browser to confirm accessibility
    * Check for firewall rules that might block the connection
    * Contact your Lansweeper administrator to verify the URL
  </Accordion>

  <Accordion title="Permission Issues" icon="shield-exclamation">
    **Symptoms**: Integration connects but no data appears or "Access Denied" errors

    **Solutions**:

    * Verify the API key has read permissions configured in Lansweeper
    * Check that the user who generated the API key is an administrator
    * Regenerate the API key with explicit read permissions
    * Review the [Lansweeper API Documentation](https://www.lansweeper.com/kb/) for required permissions
    * Contact Lansweeper support for permission issues
  </Accordion>

  <Accordion title="No Data After 15 Minutes" icon="database">
    **Symptoms**: Integration shows active but no asset data appears

    **Solutions**:

    * Wait up to 15 minutes for initial data synchronization
    * Verify there is asset data in Lansweeper to collect
    * Check API key permissions are set to read
    * Review integration logs in ThreatAware (contact support if needed)
    * Ensure devices exist in Lansweeper before testing
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Lansweeper Knowledge Base" icon="book" href="https://www.lansweeper.com/kb/">
    Official Lansweeper documentation and API guides
  </Card>

  <Card title="ThreatAware Support" icon="life-ring" href="mailto:help@threataware.com">
    Contact ThreatAware support for integration assistance
  </Card>
</CardGroup>

## Best practices

<Tip>
  **Credential Management**

  * Store the API Key securely in your organisation's password manager
  * Document your Lansweeper instance URL
  * Regenerate API keys periodically per your security policy
  * Monitor authentication failures in the integration logs
</Tip>

<Tip>
  **Integration Management**

  * Use read-only API keys for monitoring and compliance purposes
  * Test the connection immediately after setup
  * Verify asset data is syncing as expected
  * Check the integration status regularly
</Tip>