Hudu

Overview

The Hudu integration lets Bumblebee workflows read documentation from your Hudu instance. It is useful for pulling internal runbooks and knowledge base articles into automated workflows.

Prerequisites & Setup

Before setting up the Hudu integration, you need:

• A Hudu instance with API access enabled
• A Hudu API key with permission to read articles
• Your Hudu domain URL (for example, https://your-instance.huducloud.com)

Create an API Key in Hudu

1. Log in to your Hudu admin account
2. Navigate to Admin > API Keys
3. Create a new API key for Bumblebee
4. Copy and store the key securely
5. Confirm your key has access to the data you want to query

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Hudu
3. Enter:
   • API Key
   • API Domain (your Hudu base URL)
4. Click Test Connection
5. Save the configuration

Available Tools

Articles

• get_article - Get a knowledge base article by ID. Required: article_id (int)
• list_articles - List knowledge base articles with optional filters. Optional: company_id (int), name (str), search (str)

Companies

• get_company - Get a company by ID. Required: company_id (int)
• list_companies - List companies with optional search filter. Optional: search (str)

Assets

• get_asset - Get an asset by company and asset ID. Required: company_id (int), asset_id (int)
• list_assets - List all assets for a given company. Required: company_id (int)

Asset Layouts

• get_asset_layout - Get an asset layout (template) by ID. Required: asset_layout_id (int)
• list_asset_layouts - List all asset layouts (templates) available in Hudu

Folders

• get_folder - Get a knowledge base folder by ID. Required: folder_id (int)
• list_folders - List knowledge base folders. Optional: company_id (int), name (str)

Procedures

• get_procedure - Get a procedure (process/runbook) by ID. Required: procedure_id (int)
• list_procedures - List procedures with optional company filter. Optional: company_id (int)

Websites

• get_website - Get a monitored website by ID, including SSL, DNS, and WHOIS details. Required: website_id (int)
• list_websites - List monitored websites. Optional: name (str), search (str)

Networks & IP Addresses

• list_networks - List networks with optional company filter. Optional: company_id (int)
• list_ip_addresses - List IP addresses. Optional: network_id (int), company_id (int)
• list_vlans - List VLANs with optional company filter. Optional: company_id (int)

Activity Logs

• list_activity_logs - List activity logs (audit trail). Optional: resource_type (str: "Asset", "AssetPassword", "Company", "Article", "Website"), resource_id (int), user_email (str), start_date (str)