Lansweeper

Details

ID	`Lansweeper`
Provider	Insight Partners
Category	IT Services
From Version	6.0.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM

README

The Lansweeper integration allows users to retrieve the asset details.
This integration was integrated and tested with version 2.0 of Lansweeper

Configure Lansweeper in Cortex

Parameter	Description	Required
Application Identity Code	Identity code generated for the specific application.	True
Trust any certificate (not secure)		False
Use system proxy settings		False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

ls-site-list

Retrieve a list of all sites to which an application has access.

Base Command

ls-site-list

Input

There are no input arguments for this command.

Context Output

Path	Type	Description
Lansweeper.Site.id	String	Site ID.
Lansweeper.Site.name	String	Site name.

Command Example


#### Context Example

```json
{
    "Lansweeper": {
        "Site": [
            {
                "id": "401d153d-2a59-45eb-879a-c291390448ca",
                "name": "api-demo-data"
            },
            {
                "id": "56d4ed4f-b2ad-4587-91b5-07bd453c5c76",
                "name": "api-demo-data-v2"
            }
        ]
    }
}

Human Readable Output

Authorized Site(s)

Site ID Site Name

401d153d-2a59-45eb-879a-c291390448ca api-demo-data

56d4ed4f-b2ad-4587-91b5-07bd453c5c76 api-demo-data-v2

Site ID	Site Name
401d153d-2a59-45eb-879a-c291390448ca	api-demo-data
56d4ed4f-b2ad-4587-91b5-07bd453c5c76	api-demo-data-v2

ls-ip-hunt

Return a list of all assets associated with a given site and IP address.

Base Command

ls-ip-hunt

Input

Argument Name	Description	Required
site_id	Specify the site ID to retrieve the assets. Note: To get site ID, execute ls-site-list command.	Optional
ip	Specify the IP address to retrieve the specific asset. Note: Supports multiple comma separated values.	Required
limit	Number of records to retrieve in the response. Note: The minimum value supported is 1 and maximum value supported is 500. Default is 50.	Optional

Context Output

Path	Type	Description
Lansweeper.IP.assetId	String	Asset ID.
Lansweeper.IP.assetBasicInfo.name	String	Asset name.
Lansweeper.IP.assetBasicInfo.domain	String	Domain the asset belongs to.
Lansweeper.IP.assetBasicInfo.description	String	Description of the asset.
Lansweeper.IP.assetBasicInfo.firstSeen	Date	Date and time at which the asset was first scanned.
Lansweeper.IP.assetBasicInfo.fqdn	String	FQDN of the asset.
Lansweeper.IP.assetBasicInfo.ipAddress	String	IP address associated with the asset.
Lansweeper.IP.assetBasicInfo.lastSeen	Date	Date and time at which the asset was last scanned.
Lansweeper.IP.assetBasicInfo.mac	String	Asset’s main MAC address.
Lansweeper.IP.assetBasicInfo.userName	String	Name of the last logged on user.
Lansweeper.IP.assetBasicInfo.type	String	Type of the asset.
Lansweeper.IP.assetBasicInfo.userDomain	String	Domain of the last logged on user.
Lansweeper.IP.assetCustom.sku	String	Asset’s SKU.
Lansweeper.IP.assetCustom.model	String	Model of the asset.
Lansweeper.IP.assetCustom.firmwareVersion	String	Firmware version, retrieved from plug and play devices via the UPnP, DNS-SD or SSDP protocol.
Lansweeper.IP.assetCustom.purchaseDate	Date	When the asset was purchased.
Lansweeper.IP.assetCustom.warrantyDate	Date	When the asset’s warranty expires.
Lansweeper.IP.assetCustom.comment	String	Comment on the asset..
Lansweeper.IP.assetCustom.location	String	Location of the asset.
Lansweeper.IP.assetCustom.contact	String	Contact person of the asset.
Lansweeper.IP.assetCustom.manufacturer	String	Manufacturer of the asset.
Lansweeper.IP.assetCustom.serialNumber	String	Serial number of the asset.
Lansweeper.IP.assetCustom.dnsName	String	DNS name of the asset.
Lansweeper.IP.assetCustom.stateName	String	State name of the asset.
Lansweeper.IP.operatingSystem.caption	String	Short description of the object. The string includes the operating system version.
Lansweeper.IP.operatingSystem.productType	String	Type of the operating system.
Lansweeper.IP.url	String	URL to the summary of the asset.
Lansweeper.IP.siteId	String	The ID of the site to which the asset belongs.
Lansweeper.IP.siteName	String	The name of the site to which the asset belongs.

Command Example

!ls-ip-hunt ip="192.168.2.1"

Context Example

{
    "Lansweeper": {
        "IP": [
            {
                "assetBasicInfo": {
                    "firstSeen": "2018-06-15T12:03:34.917Z",
                    "ipAddress": "192.168.2.1",
                    "lastSeen": "2018-07-19T14:45:58.793Z",
                    "mac": "02:0C:29:FE:A6:64",
                    "name": "192.168.2.1",
                    "type": "Network device"
                },
                "assetCustom": {
                    "stateName": "Active"
                },
                "assetId": "608fa4d61be3044511e7239e",
                "siteId": "401d153d-2a59-45eb-879a-c291390448ca",
                "siteName": "api-demo-data",
                "url": "https://app.lansweeper.com/api-demo-data/asset/MTI3My1Bc3NldC0wZGYzZGRiYS0zNzA3LTQ0ZWUtOWI0My1jMTkxOTQ1NmZkYTE=/summary"
            },
            {
                "assetBasicInfo": {
                    "firstSeen": "2018-06-15T10:02:34.917Z",
                    "ipAddress": "192.168.2.1",
                    "lastSeen": "2018-07-19T12:44:58.793Z",
                    "mac": "02:0C:29:FE:A6:64",
                    "name": "192.168.2.1",
                    "type": "Network device"
                },
                "assetCustom": {
                    "stateName": "Active"
                },
                "assetId": "60eed3ba8a037f9341893701",
                "siteId": "56d4ed4f-b2ad-4587-91b5-07bd453c5c76",
                "siteName": "api-demo-data-v2",
                "url": "https://app.lansweeper.com/api-demo-data-v2/asset/MTI3My1Bc3NldC1mODdkZjg5MS1kNmVkLTQyYzgtYThmMS1jZDJmMTBlYmE1ZGU=/summary"
            }
        ]
    }
}

Human Readable Output

Asset(s)

Name Domain User Name User Domain FQDN Description Type IP Address Mac Address Model Manufacturer Serial Number SKU Site Name First Seen Last Seen

XLAN-897 Demo-domain John Doe Demo-domain Demo67.com Video / Image Editing APC 192.168.2.1 03:00:00:00:00:57 iMac18,3 Apple LAN897 LN001 api-demo-data 2018-02-12T16:04:02.733Z 2018-02-12T16:04:02.733Z

XLAN-897 Demo-domain John Doe Demo-domain Demo67.com Video / Image Editing APC 192.168.2.1 03:00:00:00:00:57 iMac18,3 Apple LAN897 LN001 api-demo-data-v2 2018-02-12T14:04:02.733Z 2021-08-10T14:18:20.913Z

Name	Domain	User Name	User Domain	FQDN	Description	Type	IP Address	Mac Address	Model	Manufacturer	Serial Number	SKU	Site Name	First Seen	Last Seen
XLAN-897	Demo-domain	John Doe	Demo-domain	Demo67.com	Video / Image Editing	APC	192.168.2.1	03:00:00:00:00:57	iMac18,3	Apple	LAN897	LN001	api-demo-data	2018-02-12T16:04:02.733Z	2018-02-12T16:04:02.733Z
XLAN-897	Demo-domain	John Doe	Demo-domain	Demo67.com	Video / Image Editing	APC	192.168.2.1	03:00:00:00:00:57	iMac18,3	Apple	LAN897	LN001	api-demo-data-v2	2018-02-12T14:04:02.733Z	2021-08-10T14:18:20.913Z

ls-mac-hunt

Return a list of all assets associated with a given site and MAC address.

Base Command

ls-mac-hunt

Input

Argument Name	Description	Required
site_id	Specify the site ID to retrieve the assets. Note: To get site ID, execute ls-site-list command.	Optional
mac_address	Specify the MAC address to retrieve the specific asset. Note: Supports multiple comma separated values.	Required
limit	Number of records to retrieve in the response. Note: The minimum value supported is 1 and maximum value supported is 500. Default is 50.	Optional

Context Output

Path	Type	Description
Lansweeper.Mac.assetId	String	Asset ID.
Lansweeper.Mac.assetBasicInfo.name	String	Asset name.
Lansweeper.Mac.assetBasicInfo.domain	String	Domain the asset belongs to.
Lansweeper.Mac.assetBasicInfo.description	String	Description of the asset.
Lansweeper.Mac.assetBasicInfo.firstSeen	Date	Date and time at which the asset was first scanned.
Lansweeper.Mac.assetBasicInfo.fqdn	String	FQDN of the asset.
Lansweeper.Mac.assetBasicInfo.ipAddress	String	IP address associated with the asset.
Lansweeper.Mac.assetBasicInfo.lastSeen	Date	Date and time at which the asset was last scanned.
Lansweeper.Mac.assetBasicInfo.mac	String	Asset’s main MAC address.
Lansweeper.Mac.assetBasicInfo.userName	String	Name of the last logged on user.
Lansweeper.Mac.assetBasicInfo.type	String	Type of the asset.
Lansweeper.Mac.assetBasicInfo.userDomain	String	Domain of the last logged on user.
Lansweeper.Mac.assetCustom.sku	String	Asset’s SKU.
Lansweeper.Mac.assetCustom.model	String	Model of the asset.
Lansweeper.Mac.assetCustom.firmwareVersion	String	Firmware version, retrieved from plug and play devices via the UPnP, DNS-SD or SSDP protocol.
Lansweeper.Mac.assetCustom.purchaseDate	Date	When the asset was purchased.
Lansweeper.Mac.assetCustom.warrantyDate	Date	When the asset’s warranty expires.
Lansweeper.Mac.assetCustom.comment	String	Comment on the asset..
Lansweeper.Mac.assetCustom.location	String	Location of the asset.
Lansweeper.Mac.assetCustom.contact	String	Contact person of the asset.
Lansweeper.Mac.assetCustom.manufacturer	String	Manufacturer of the asset.
Lansweeper.Mac.assetCustom.serialNumber	String	Serial number of the asset.
Lansweeper.Mac.assetCustom.dnsName	String	DNS name of the asset.
Lansweeper.Mac.assetCustom.stateName	String	State name of the asset.
Lansweeper.Mac.operatingSystem.caption	String	Short description of the object. The string includes the operating system version.
Lansweeper.Mac.operatingSystem.productType	String	Type of the operating system.
Lansweeper.Mac.url	String	URL to the summary of the asset.
Lansweeper.Mac.siteId	String	The ID of the site to which the asset belongs.
Lansweeper.Mac.siteName	String	The name of the site to which the asset belongs.

Command Example

!ls-mac-hunt mac_address="03:00:00:00:00:57"

Context Example

{
    "Lansweeper": {
        "Mac": [
            {
                "assetBasicInfo": {
                    "domain": "Demo-domain",
                    "firstSeen": "2018-02-12T16:04:02.733Z",
                    "fqdn": "Demo67.com",
                    "ipAddress": "10.10.11.104",
                    "lastSeen": "2018-02-12T16:04:02.733Z",
                    "mac": "03:00:00:00:00:57",
                    "name": "XLAN-897",
                    "type": "APC",
                    "userDomain": "Demo-domain"
                },
                "assetCustom": {
                    "location": "Main Branch",
                    "purchaseDate": "2018-02-02T00:00:00.000Z",
                    "serialNumber": "LAN897",
                    "stateName": "Active",
                    "warrantyDate": "2023-02-02T00:00:00.000Z"
                },
                "assetId": "608fa4c81be3044511e6d97f",
                "siteId": "401d153d-2a59-45eb-879a-c291390448ca",
                "siteName": "api-demo-data",
                "url": "https://app.lansweeper.com/api-demo-data/asset/ODk3LUFzc2V0LTBkZjNkZGJhLTM3MDctNDRlZS05YjQzLWMxOTE5NDU2ZmRhMQ==/summary"
            },
            {
                "assetBasicInfo": {
                    "domain": "Demo-domain",
                    "firstSeen": "2018-02-12T14:04:02.733Z",
                    "fqdn": "Demo67.com",
                    "ipAddress": "10.10.11.104",
                    "lastSeen": "2021-08-10T14:18:20.913Z",
                    "mac": "03:00:00:00:00:57",
                    "name": "XLAN-897",
                    "type": "APC",
                    "userDomain": "Demo-domain"
                },
                "assetCustom": {
                    "location": "Main Branch",
                    "purchaseDate": "2018-02-02T02:00:00.000Z",
                    "serialNumber": "LAN897",
                    "stateName": "Active",
                    "warrantyDate": "2023-02-02T02:00:00.000Z"
                },
                "assetId": "60eed3b78a037f934189271c",
                "siteId": "56d4ed4f-b2ad-4587-91b5-07bd453c5c76",
                "siteName": "api-demo-data-v2",
                "url": "https://app.lansweeper.com/api-demo-data-v2/asset/ODk3LUFzc2V0LWY4N2RmODkxLWQ2ZWQtNDJjOC1hOGYxLWNkMmYxMGViYTVkZQ==/summary"
            }
        ]
    }
}

Human Readable Output

Asset(s)

Name Domain User Name User Domain FQDN Description Type IP Address Mac Address Model Manufacturer Serial Number SKU Site Name First Seen Last Seen

XLAN-897 Demo-domain John Doe Demo-domain Demo67.com Video / Image Editing APC 10.10.11.104 03:00:00:00:00:57 iMac18,3 Apple LAN897 LN001 api-demo-data 2018-02-12T16:04:02.733Z 2018-02-12T16:04:02.733Z

XLAN-897 Demo-domain John Doe Demo-domain Demo67.com Video / Image Editing APC 10.10.11.104 03:00:00:00:00:57 iMac18,3 Apple LAN897 LN001 api-demo-data-v2 2018-02-12T14:04:02.733Z 2021-08-10T14:18:20.913Z

Name	Domain	User Name	User Domain	FQDN	Description	Type	IP Address	Mac Address	Model	Manufacturer	Serial Number	SKU	Site Name	First Seen	Last Seen
XLAN-897	Demo-domain	John Doe	Demo-domain	Demo67.com	Video / Image Editing	APC	10.10.11.104	03:00:00:00:00:57	iMac18,3	Apple	LAN897	LN001	api-demo-data	2018-02-12T16:04:02.733Z	2018-02-12T16:04:02.733Z
XLAN-897	Demo-domain	John Doe	Demo-domain	Demo67.com	Video / Image Editing	APC	10.10.11.104	03:00:00:00:00:57	iMac18,3	Apple	LAN897	LN001	api-demo-data-v2	2018-02-12T14:04:02.733Z	2021-08-10T14:18:20.913Z

Configuration parameters

identity_code — Application Identity Code (required)
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (3)

ls-ip-hunt
Return a list of all assets associated with a given site and IP address.
ls-mac-hunt
Return a list of all assets associated with a given site and MAC address.
ls-site-list
Retrieve a list of all sites to which an application has access.

Source

Lansweeper.py Lansweeper_test.py Lansweeper.yml Lansweeper_description.md

Download History Raw

category: IT Services
provider: Insight Partners
commonfields:
  id: Lansweeper
  version: -1
sectionorder:
  - Connect
  - Collect
configuration:
- additionalinfo: Identity code generated for the specific application.
  display: Application Identity Code
  name: identity_code
  required: true
  type: 4
  section: Connect
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
  section: Connect
description: The Lansweeper integration allows users to retrieve the asset details.
display: Lansweeper
name: Lansweeper
script:
  commands:
  - description: Retrieve a list of all sites to which an application has access.
    name: ls-site-list
    outputs:
    - contextPath: Lansweeper.Site.id
      description: Site ID.
      type: String
    - contextPath: Lansweeper.Site.name
      description: Site name.
      type: String
  - arguments:
    - description: |-
        Specify the site ID to retrieve the assets.

        Note: To get site ID, execute ls-site-list command.
      name: site_id
    - description: "Specify the IP address to retrieve the specific asset. \n\nNote: Supports multiple comma separated values."
      isArray: true
      name: ip
      required: true
    - defaultValue: '50'
      description: |-
        Number of records to retrieve in the response.

        Note: The minimum value supported is 1 and maximum value supported is 500.
      name: limit
    description: Return a list of all assets associated with a given site and IP address.
    name: ls-ip-hunt
    outputs:
    - contextPath: Lansweeper.IP.assetId
      description: Asset ID.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.name
      description: Asset name.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.domain
      description: Domain the asset belongs to.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.description
      description: Description of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.firstSeen
      description: Date and time at which the asset was first scanned.
      type: Date
    - contextPath: Lansweeper.IP.assetBasicInfo.fqdn
      description: FQDN of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.ipAddress
      description: IP address associated with the asset.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.lastSeen
      description: Date and time at which the asset was last scanned.
      type: Date
    - contextPath: Lansweeper.IP.assetBasicInfo.mac
      description: Asset's main MAC address.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.userName
      description: Name of the last logged on user.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.type
      description: Type of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetBasicInfo.userDomain
      description: Domain of the last logged on user.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.sku
      description: Asset's SKU.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.model
      description: Model of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.firmwareVersion
      description: Firmware version, retrieved from plug and play devices via the UPnP, DNS-SD or SSDP protocol.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.purchaseDate
      description: When the asset was purchased.
      type: Date
    - contextPath: Lansweeper.IP.assetCustom.warrantyDate
      description: When the asset's warranty expires.
      type: Date
    - contextPath: Lansweeper.IP.assetCustom.comment
      description: Comment on the asset..
      type: String
    - contextPath: Lansweeper.IP.assetCustom.location
      description: Location of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.contact
      description: Contact person of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.manufacturer
      description: Manufacturer of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.serialNumber
      description: Serial number of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.dnsName
      description: DNS name of the asset.
      type: String
    - contextPath: Lansweeper.IP.assetCustom.stateName
      description: State name of the asset.
      type: String
    - contextPath: Lansweeper.IP.operatingSystem.caption
      description: Short description of the object. The string includes the operating system version.
      type: String
    - contextPath: Lansweeper.IP.operatingSystem.productType
      description: Type of the operating system.
      type: String
    - contextPath: Lansweeper.IP.url
      description: URL to the summary of the asset.
      type: String
    - contextPath: Lansweeper.IP.siteId
      description: The ID of the site to which the asset belongs.
      type: String
    - contextPath: Lansweeper.IP.siteName
      description: The name of the site to which the asset belongs.
      type: String
  - arguments:
    - description: |-
        Specify the site ID to retrieve the assets.

        Note: To get site ID, execute ls-site-list command.
      name: site_id
    - description: "Specify the MAC address to retrieve the specific asset. \n\nNote: Supports multiple comma separated values."
      isArray: true
      name: mac_address
      required: true
    - defaultValue: '50'
      description: |-
        Number of records to retrieve in the response.

        Note: The minimum value supported is 1 and maximum value supported is 500.
      name: limit
    description: Return a list of all assets associated with a given site and MAC address.
    name: ls-mac-hunt
    outputs:
    - contextPath: Lansweeper.Mac.assetId
      description: Asset ID.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.name
      description: Asset name.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.domain
      description: Domain the asset belongs to.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.description
      description: Description of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.firstSeen
      description: Date and time at which the asset was first scanned.
      type: Date
    - contextPath: Lansweeper.Mac.assetBasicInfo.fqdn
      description: FQDN of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.ipAddress
      description: IP address associated with the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.lastSeen
      description: Date and time at which the asset was last scanned.
      type: Date
    - contextPath: Lansweeper.Mac.assetBasicInfo.mac
      description: Asset's main MAC address.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.userName
      description: Name of the last logged on user.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.type
      description: Type of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetBasicInfo.userDomain
      description: Domain of the last logged on user.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.sku
      description: Asset's SKU.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.model
      description: Model of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.firmwareVersion
      description: Firmware version, retrieved from plug and play devices via the UPnP, DNS-SD or SSDP protocol.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.purchaseDate
      description: When the asset was purchased.
      type: Date
    - contextPath: Lansweeper.Mac.assetCustom.warrantyDate
      description: When the asset's warranty expires.
      type: Date
    - contextPath: Lansweeper.Mac.assetCustom.comment
      description: Comment on the asset..
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.location
      description: Location of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.contact
      description: Contact person of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.manufacturer
      description: Manufacturer of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.serialNumber
      description: Serial number of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.dnsName
      description: DNS name of the asset.
      type: String
    - contextPath: Lansweeper.Mac.assetCustom.stateName
      description: State name of the asset.
      type: String
    - contextPath: Lansweeper.Mac.operatingSystem.caption
      description: Short description of the object. The string includes the operating system version.
      type: String
    - contextPath: Lansweeper.Mac.operatingSystem.productType
      description: Type of the operating system.
      type: String
    - contextPath: Lansweeper.Mac.url
      description: URL to the summary of the asset.
      type: String
    - contextPath: Lansweeper.Mac.siteId
      description: The ID of the site to which the asset belongs.
      type: String
    - contextPath: Lansweeper.Mac.siteName
      description: The name of the site to which the asset belongs.
      type: String
  dockerimage: demisto/python3:3.12.13.10116658
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- Lansweeper-Test
fromversion: 6.0.0