# Liongard

## Domotz Liongard Integration

Domotz [network monitoring and management software](https://www.domotz.com/) includes integration with [Liongard IT Automation software](https://docs.liongard.com/docs/domotz-inspector).

This integration allows you to show the devices you monitor with Domotz in the Liongard customer facing portal. This is beneficial because it instantly shows your customers all the technology you are managing on a network.

In addition, the Liongard integration uses the Domotz API to provide you with a view of your client’s devices in your Liongard account. Domotz can pass network information directly into a client’s infrastructure tab in Liongard. This data is available under the Network tab under Infrastructure.

When using the _Selection Mode (per device plan)_, only devices listed as _Managed_ will be pushed and kept in sync.

Learn more about the[Domotz integration with Liongard IT Automation software](https://www.domotz.com/integrations/software/documentation/it-automation-liongard.php).

Learn more about [how to set-up the Domotz and Liongard integration](https://docs.liongard.com/docs/domotz-inspector) on the Liongard help center.

## How to set up the Domotz Liongard Integration

### In Domotz

#### Step 1: In the [Domotz portal](https://portal.domotz.com/), click on the Settings tab:

Accessing the Settings Menu in Domotz

1. Navigate to the top-right corner of the Domotz interface.
2. Click on "Settings" next to the "Account" option to adjust your account settings or preferences.

#### Step 2: On the Settings page, click on the API Keys tab:

API Keys Tab in Domotz Settings

1. Navigate to the "Settings" section in the top menu.
2. Select the "API Keys" tab to manage API settings.
3. The page displays two services: "DOMOTZ DAILY ALERT DIGEST" and "D-TOOLS."
4. Each service shows its current status as "Disabled."
5. For each service, a description is provided, explaining its functionalities.
6. To configure a service, click on the "Configure" button beneath it.

#### Step 3: Click on create a new API Key:

API Key Creation Interface

1. Navigate to the "API Keys" section under the "Services" menu.
2. Review the API key description, which explains the function and the endpoint URL: `https://api-us-east-1-cell-1.domotz.com/public-api/v1/`.
3. Monitor your "API Usage" to see the total API calls made in the last 24 hours.
4. Click "Create an API Key" to generate a new API key for integrating third-party applications.
5. Alternatively, select "Create an Agent Activation Key" for agent-specific access.

#### Step 4: Enter your password and click Unlock:

Unlock API Key Management Screen Instructions.

1. Enter your Domotz account password in the "Enter your Password" field.
2. Click the "Unlock" button to proceed with creating a Public API Key.
3. Choose "Cancel" if you do not wish to continue.

#### Step 5: Enter a Friendly Name for the API Key (Suggested Naming: Liongard) and click Create:

Enter an API Key Friendly Name.

1. In the text field labeled "API Key Friendly Name," type a desired name for the API key.
2. To finalize, click the "Create" button.
3. If you wish to cancel the operation, click the "Cancel" button.

#### Step 6: Save the API Key and Endpoint URL for use when you configure the Inspector in Liongard:

API Key Creation Confirmation

1. A message confirms that the API Key has been created.
2. Notes that for security, the information will not be shown again after closing the message.
3. Displays the generated API Key with an option to copy it.
4. Provides the Endpoint URL for API access.
5. Shows the API Name for reference.
6. Press the "Done" button to close the window after recording necessary details.

### In Liongard:

#### Step 1: Parent Inspector Setup

Set up a single "Parent" Inspector that will then auto-discover "Child" Inspectors for each Environment.
In Liongard, navigate to Admin > Inspectors > Navigate to the Domotz Inspector > Select Add System and fill in the following information:

- Environment: Select your MSP's Environment
- Friendly Name: Suggested Naming: [MSP Name] Domotz Parent
- Agent: Select On-Demand Agent
- Inspector Version: Latest (Auto-Update)
- Endpoint URL: Enter the Endpoint URL saved from the Inspector Setup Preparation above
- API Key: Enter the API Key saved from the Inspector Setup Preparation above
- Scheduling: The Inspector will default to run once a day at the time the Inspector is set up. Here you can adjust the schedule

After you select elect Save, the Inspector will be triggered to run within the minute.

#### Step 2: Child Inspector Setup

After the first run of the Parent Inspector, your Domotz organizations will be auto-discovered and surfaced on the Discovered Systems page.

Navigate to the Discovered Systems tab in your Inspectors > Domotz page and take the following actions:

- Activate your Discovered Systems by ensuring they're mapped to the correct Environment > Select the checkbox to the left of Inspector(s) > Select the Actions drop-down menu > Activate Launchpoints.
- Users may also Archive Discovered Systems by Selecting the checkbox to the left of the Inspector(s) > Select the Actions drop-down menu > Archive Launchpoints.

**Note**: Turning on Flexible Asset/Configuration Auto-Updating is optional.

Looking for more Integrations with Domotz? Check out the articles on [PSA & Ticketing Systems](https://help.domotz.com/category/admin-global-features/) for tools like [Zendesk](https://help.domotz.com/user-guide/zendesk/), [Syncro](https://help.domotz.com/user-guide/syncro-psa/), [Freshservice](https://help.domotz.com/user-guide/freshservice/), [Autotask](https://help.domotz.com/user-guide/autotask-psa/), and more. Or view or a [full list of Integrations](https://www.domotz.com/integrations.php/).