MySonicWall

Overview

MySonicWall is SonicWall's licensing and account portal. It tracks your organization's tenants (product groups), registered products (firewalls, appliances, client licenses), support contracts, per-product service licenses, and portal users.

The Bumblebee integration is read-only and focused on renewal and expiration reporting: which products have expired or soon-expiring support contracts and service licenses, per tenant/customer. Firewall traffic and threat telemetry is not part of this integration — that lives in SonicWall NSM/Analytics, a separate API.

Prerequisites & Setup

Before setting up the MySonicWall integration, you need:

• A MySonicWall account (https://www.mysonicwall.com) with access to the tenants and products you want to report on
• An API key generated from the portal

Generate an API Key

1. Sign in to mysonicwall.com
2. In the left navigation, expand Settings and select My Account
3. Open the User list tab and click Generate My API Key
4. Enter a description, optionally restrict the source IP, and pick the Valid until date (maximum one year)
5. Click Confirm and copy the key immediately — it is shown exactly once

The key acts with your user's permissions and expires on the date you chose, so plan to rotate it before then.

Vendor documentation:

• MySonicWall API Reference Guide — How to generate an API key

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select MySonicWall
3. Paste your API Key
4. Save the configuration
5. Run a test request (e.g. list tenants) from the validation card

Available Tools

Reporting (5 tools)

• list_tenants — Tenants (product groups) with organization id, product counts, and per-cloud-service enablement/renewal status. No parameters.
• list_products — Registered products with support/license expiry dates and flags, firmware status, plus account-level and per-tenant expiry aggregates. The primary renewal-report source. Optional: page_number, page_size, search (name or serial), product_type, tenant_name, show_expired_products.
• get_product_licenses — Per-service license type, node counts, and expiry for registered products. Required: serials (list of serial numbers, max 25 per call).
• list_tenant_firewalls — Firewalls eligible for cloud management/reporting in a tenant, with cloud license counts. Required: tenant_id (from list_tenants).
• list_users — Portal users (admin flag, last access) or user groups with members. Optional: resource_type (users | user_groups).

Example: renewal report

Ask the assistant something like "Which of our SonicWall products have licenses expiring in the next 60 days, grouped by customer?" The agent composes:

1. list_products(show_expired_products=true) — pages through all registered products
2. Keeps rows flagged is_support_expiring / is_license_expiring (or already expired)
3. get_product_licenses(serials=[...]) — fetches per-service expiry dates for those products
4. Groups the result by tenant

API Notes & Limits

• Authentication is a raw API key sent as an X-API-Key header; there is no token exchange.
• Only a subset of the MySonicWall API is API-key-enabled. The portal's pre-built reports (renewals list, subscription report, co-term) require an interactive browser session and are not available to this integration — the renewal report is composed from list_products + get_product_licenses instead.
• App-level failures return HTTP 200 with an operationStatus: "NOK" envelope; a serial not registered to your account returns msgCode: "NODATAFOUND".
• SonicWall does not publish request quotas for the portal API; keep page_size at the default 50 unless you have a reason to change it.