Breach Secure Now

Overview

Breach Secure Now (BSN, also branded PII Protect) provides security awareness training, phishing simulation, and dark-web breach monitoring for MSPs. Bumblebee connects through BSN's read-only partner API and can retrieve your client roster, each client's summary posture (average Employee Secure Score, average phishing fail rate, dark-web breach counts, risk level), and per-user security stats (phishing emails sent/clicked/credentials captured, security-course and micro-training completion, ESS, breach counts).

The integration is read-only and works with summary data only — BSN's API does not expose phishing-campaign detail or dark-web breach detail.

Prerequisites & Setup

You enable the integration yourself from the BSN partner portal — no keys need to be requested from BSN.

1. Log in to your BSN partner portal as a partner administrator.
2. In the left sidebar, select Partner Profile.
3. On the Configure tab, select Integrations in the Your Progress checklist, then click Setup.
4. On the Integrations Partners page, switch the Bumblebee toggle on.
5. Copy the Partner Integration Key that appears on the Bumblebee card (a UUID-style value).

The key scopes Bumblebee to your BSN account only. Switching the Bumblebee toggle back off in BSN revokes access immediately.

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Breach Secure Now
3. Paste your Partner Integration Key
4. Save the configuration
5. Run a test request (e.g. list clients) from the validation card

Available Tools

All tools are read-only.

• list_partner_clients — List your BSN clients (companies) as {client_id, name}. Optional: limit (int), nextpage (str). Call this first to resolve the client_id the other tools need.
• get_client_users — One client's summary (client_details: avg ESS, avg phishing fail rate, dark-web breach counts, user count) plus per-user rows (phishing stats, training progress, ESS, breach counts). Required: client_id (str). Optional: limit, nextpage.
• list_client_summaries — Top-level summaries for all (or selected) clients in one call: each client's client_details plus Bumblebee-derived training/phishing rollups (users with incomplete security courses, phishing emails sent/clicked totals, and more). Optional: client_ids (list).

Each tool accepts an optional response_filter (a JMESPath projection) with a sensible default; pass response_filter="@" to retrieve the full response envelope.

Example questions

• "List our Breach Secure Now clients."
• "What's the phishing fail rate for Acme Corp, and who clicked phishing emails?"
• "Which Acme users haven't completed their security awareness training?"
• "Build a table of training completion and phishing fail rate across all our BSN clients."
• "How many dark-web breaches does Acme have?"

Notes

• Read-only. Covers BSN's full partner API surface (client roster + client/user summary data).
• Summary data only. BSN's API provides counts and rates — no per-campaign phishing results and no dark-web breach detail.
• Scoping. The Partner Integration Key limits Bumblebee to your BSN account; client IDs outside your account are rejected by BSN.