This guide walks you through setting up and managing the CyberHoot–Hudu integration using the CyberHoot Autopilot Platform. Once connected, CyberHoot publishes a CyberHoot documentation asset to each mapped company in Hudu, showing that tenant’s training and compliance status, and refreshes it every night.
What the integration does:
- Documentation: on connect, CyberHoot creates a CyberHoot asset layout in Hudu. Each mapped company then receives one CyberHoot asset with these fields: Tenant, Tenant URL, Active Users, Compliant Users, Compliance Percent and Last Synced.
- One-way publishing: nothing is read into CyberHoot from Hudu. CyberHoot never touches any other documentation in your Hudu account.
- Schedule: publishing runs automatically once a day, around 12:30am in your deployment’s time zone. You can also run it on demand with Publish Now.
1. Create API credentials in Hudu:
CyberHoot needs API credentials to talk to your Hudu account. Create them in Hudu first, then bring them to CyberHoot.
- In Hudu, go to Admin > API Keys.
- Click New API Key, name it CyberHoot and save.
- Copy the API key and store it somewhere safe.
You will need the following values in the next step:
- Hudu Instance URL – your own Hudu address, for example https://yourcompany.huducloud.com (or your self-hosted Hudu URL).
- API Key – the API key you generated in Hudu.
2. Connect to CyberHoot on Autopilot:
- On the CyberHoot Autopilot platform, navigate to Partner Dashboard > Integrations.
- Select Hudu and click “Get Started”.
- Enter the values you collected in step 1: Hudu Instance URL, API Key.
- Click “Connect to Hudu”. CyberHoot validates the credentials against Hudu before saving them.
Note: If the connection fails, double-check the Hudu Instance URL and make sure the credentials were copied without leading or trailing spaces.
3. Map Companies and Publish:
- On the same page, click “Map Companies”. CyberHoot lists every company in your Hudu account on the left with a drop-down of your CyberHoot tenants on the right.
- For each Hudu company you want documented, pick the matching CyberHoot tenant from the drop-down. Leave companies you do not want documented unmapped.
- Click “Map Companies” at the bottom of the window to save the mappings.
- Click “Publish Now” to publish the first set of assets. The Sync Log shows the result for each mapped company.
Note: Open any mapped company in Hudu and look for the CyberHoot asset to confirm the first publish succeeded.
4. Ongoing Management:
- The CyberHoot asset on each mapped company is refreshed every night with the latest active user count, compliant user count and compliance percentage.
- To document a new customer, map their Hudu company to a CyberHoot tenant using “Map Companies” and click Publish Now.
- You can add the CyberHoot fields to your own Hudu views and reports like any other asset data.
- The Last Sync Time and Sync Log on the integration page show what happened during the most recent run.
5. Removing a Company:
- On the CyberHoot Autopilot platform, navigate to Partner Dashboard > Integrations.
- Select Hudu and click “Map Companies”.
- Click the red “X” next to the company you want to remove, then click “Map Companies” to save.
Note: Unmapping a company stops publishing to it. Assets already published are left in place in Hudu; delete them there if you no longer want them.
6. Disconnecting Integration (If needed):
- On the CyberHoot Autopilot platform, navigate to Partner Dashboard > Integrations.
- Select Hudu and click “Disconnect”.
Confirm with “Disconnect”. This removes the integration settings and company mappings from CyberHoot. Assets already published are left in place in Hudu, and the API key can then be revoked in Hudu.
Other CyberHoot integrations: