Skip to main content

Lansweeper Connection

This guide walks you through configuring the connection between Lansweeper and ZenGRC, enabling secure data synchronization between the two platforms.

Prerequisites

  • Administrator access to your Lansweeper instance

  • Administrator access to your ZenGRC instance

Configuration Steps

Creating the OAuth Client in Lansweeper

Start by setting up the OAuth client that will handle authentication between Lansweeper and ZenGRC.

  1. Navigate to the Lansweeper Settings page

  2. Go to Developer Tools → API Clients → OAuth Clients

  3. Click Add new API client

  4. Fill in the basic information:

    • Name: Provide a descriptive name for the client

    • Description: Add details about the integration purpose

  5. Configure the callback URL:

  6. Set the developer information:

    • Developed by: ZenGRC

  7. Select integration type:

    • Integration: Other

    • Custom Integration Name: ZenGRC

  8. Click Continue

  9. Important: Copy and securely save the Client ID and Client Secret — you'll need these for the ZenGRC configuration

Configuring Site Access

Each OAuth client should be configured for a single Lansweeper site to maintain security and proper access control.

  1. Navigate to the OAuth client details page

  2. Add the specific Site you want the token to access

    • Note: Only add one site per OAuth client. If you need data from multiple sites, create separate OAuth clients for each site.

Authorizing the Connection

Now you'll generate the authorization code needed to complete the integration from ZenGRC.

  1. In the OAuth Token details section, locate the Authorization URL

  2. Click the Authorize button next to the Authorization URL

  3. You'll be redirected to your ZenGRC application, which will display an Authorization Code

    • Important: Save this code — it's required for creating the connection in ZenGRC

    • Note that this code is single-use only

Completing the Setup in ZenGRC

  1. In ZenGRC, click Create Connection

  2. You'll be taken to the Lansweeper connection modal with the authorization code pre-populated

    • Important: Each authorization code works for only one connection. If you need multiple connections, repeat the authorization process for each one.

  3. Enter the Client ID and Client Secret you saved earlier

  4. Click Next

  5. Provide a name and description for the connection

Next Steps

Your Lansweeper-ZenGRC integration is now configured and ready to use. You can now create Fetchers in ZenGRC to pull data from Lansweeper based on your organization's needs.

Troubleshooting Tips

  • Authorization code expired: Authorization codes are single-use. If you encounter an error, generate a new code by repeating the authorization steps.

  • Multiple sites needed: Remember to create separate OAuth clients for each Lansweeper site you need to access.

  • Callback URL errors: Double-check that your callback URL exactly matches your ZenGRC instance URL with /auth/lansweeper appended.

If you need further assistance, contact your technical support team or refer to the Lansweeper and ZenGRC documentation for additional details.

Did this answer your question?