Step 2: Installation and Configuration of Alemba Discovery in AlH

Installing and configuring the Alemba Discovery Connector flows in Alemba Integration Hub (AIH)

The Alemba Integration hub flows provide a REST API proxy for retrieving software information from Lansweeper systems. It exposes HTTP(s) endpoints that allow client applications to query Lansweeper software inventory with various filtering and pagination options.

Prerequisities

• AIH Installation: Version 1.0 or higher

• PowerShell Script: C:\AlembaPS\azure\Get-Token.ps1 for Azure token retrieval

• Lansweeper API Access: Valid integration ID and API credentials

• Network Access: Ability to reach Lansweeper API endpoints

Configure Alemba Integration Hub (AIH) Flows

This is currently Draft documentation and may change before being published.

AIH uses a PowerShell script (C:\AlembaPS\azure\Get-Token.ps1) to retrieve Azure Vault tokens where applicable.

The Azure token retrieval script (C:\AlembaPS\azure\Get-Token.ps1) must be accessible to AIH and return JSON in the format {"token":"value"}

Set environment variables within the AIH flow - Set Cloud/OnPrem node:

Field	Description
vaultEnv	cloud | onprem
BASE_URL	AIH instance URL https://[ServerName].alembacloud.com:1880/
SITE_ID	Lansweeper Site ID
Integration ID	Lansweeper Integration ID
ASM_NR_LS_TOKEN	Lansweeper API token
ASM_NR_LS_BASIC_UID	Basic Auth username
ASM_NR_LS_BASIC_PWD	Basic Auth password

The AIH Flows use Basic Authentication as defined in the ASM Integration Platform Source and the AIH Authentication Nodes

Register and get a client token from your Lansweeper environment.

For cloud environments create below secrets in an Azure Vault to store the tokens.

For on-prem systems, create system environment variables

ASM_NR_LS_TOKEN = "YOUR LANSWEEPER API TOKEN"

ASM_NR_LS_BASIC_UID = "BASIC AUTH USERNAME"

ASM_NR_LS_BASIC_PWD = "BASIC AUTH PASSWORD"

Update Azure Token Script Path

Modify the exec node to point to the correct PowerShell script location. Powershell uses a pre-installed azure vault cli to retrieve secrets from vault

powershell.exe C:\[CustomerPath]\azure\Get-Token.ps1

Ensure the following ports and endpoints are accessible:

• AIH Port: 1880 (or configured port)

• Lansweeper API: https://api.lansweeper.com/api/v2/graphql

• Azure Services: For token retrieval (if applicable)

Powershell Script Requiremnts

The Azure token retrieval script (Get-Token.ps1) must:

1. Be accessible from the AIH server

2. Return JSON format: {"token": "your-token-here"}

3. Have appropriate execution permissions

API Endpoints

Asset Import

• GET /ls-all-assets – Retrieve all assets with optional filtering/pagination

• GET /ls-search-assets – Search assets by name

• GET /ls-get-asset/{assetId} – Retrieve details for a specific asset

Software Import

• GET /ls-all-software – Retrieve all software with pagination

• GET /ls-search-software – Search software by name

• GET /ls-get-software/{softwareId} – Retrieve details for specific software