Skip to main content
This guide walks you through connecting Breach Secure Now (BSN) to MSPortal.ai. Setup is for MSP staff with integration management permission. On the BSN connection page, the Setup guide has three tasks: Connect, Import or match companies and Review.

​
Overview

Breach Secure Now is a security awareness training and dark web monitoring platform for MSPs. By integrating BSN with MSPortal.ai, you can:
  • View security awareness training progress for every client in one place
  • Track Employee Secure Score (ESS), phishing fail rates, and micro training completion
  • Monitor dark web breach exposure per client and per user
  • Include security awareness metrics in client reports and QBRs
Mapping assigns BSN clients to MSPortal companies. It does not invite users or change their portal roles.

​
Prerequisites

  • An active Breach Secure Now partner account
  • The MSPortal integration enabled for your partner account in Breach Secure Now
  • An MSPortal.ai account with integration management permissions

​
Part 1: Enable the Integration in Breach Secure Now

Before connecting, you need your Partner Integration Key from Breach Secure Now.
1

Log into the Breach Secure Now Partner Portal

Sign in to your Breach Secure Now (PII Protect) partner portal with a partner administrator account.
2

Open the Integrations Section

Navigate to the integrations area of your partner configuration and locate MSPortal in the list of available integrations.
3

Enable MSPortal

Enable the MSPortal integration for your partner account.
If MSPortal does not appear in your integrations list, contact Breach Secure Now support and ask them to enable the MSPortal API integration for your partner account.
4

Copy Your Partner Integration Key

Copy the Partner Integration Key, the secret key generated when the integration is enabled. This is the only value you enter in MSPortal.
You do not need your Partner ID. MSPortal identifies your partner account from the Partner Integration Key automatically.
Treat the Partner Integration Key like a password. Anyone with the key can read your client and user training data.

​
Part 2: Connect in MSPortal

1

Find Breach Secure Now

In MSPortal.ai, go to Settings > Integrations, choose Directory, find Breach Secure Now, and choose Connect. To maintain an existing connection, open it from your active integrations instead.
2

Enter Your Partner Integration Key

Fill in the connection fields:
3

Test Connection

Choose Test connection to verify your key.When the test passes, a confirmation shows your partner name and a client count. This confirms MSPortal matched your key to the right partner account.
The test reads only the first five clients, so the count tops out at 5. Your full client list appears on Import or match companies.
If the connection fails:
  • Verify the Partner Integration Key was copied in full, without extra spaces
  • Confirm the MSPortal integration is enabled for your partner account in the BSN portal
  • If you see “That Partner Integration Key was not recognized by Breach Secure Now,” return to Part 1, enable MSPortal for that partner account, copy the key again, then test again
4

Save the connection

Once the test passes, choose Save and continue. This saves the connection and starts client discovery in the background. A successful test alone does not save anything.
Your credentials are stored with encryption and are never exposed in logs or API responses.

​
Part 3: Import or Match Companies

Map your Breach Secure Now clients to MSPortal companies. This determines which data syncs to which company.
1

Sync Your Clients

Open Import or match companies. If no clients have synced yet, choose Sync clients to pull your client list from Breach Secure Now. The sync usually takes less than a minute, and new clients appear as they arrive.
2

Match Clients

For each BSN client, accept the suggested company or choose the correct MSPortal company. Accept strong matches accepts every suggestion at 90% confidence or more after you review them. Ignore hides a BSN client you do not want to map, and you can restore it later.
3

Import Missing Companies

If a BSN client does not have a corresponding MSPortal company yet, use Import company on its row. MSPortal creates the company right away and matches it to the BSN client. Check for an existing company first to avoid duplicates.
4

Check the Saved Matches

Each accepted or chosen match saves immediately and starts a user training sync for that client. Removing a saved match also takes effect immediately.
Only data from mapped clients syncs to MSPortal. Map at least one client before you finish setup.

​
Part 4: Review and Finish

1

Check the Sync

Use Overview and Sync activity to check the connection and the results of each sync. Run sync starts a sync in the background; the first sync can take several minutes, depending on how many clients and users you have.
2

Finish Setup

Open Review and choose Finish setup. Finishing setup does not wait for the background sync, which keeps running after you leave.
User-level metrics stay empty until the first user sync finishes. Missing values, zero counts and a connected status do not prove that everyone is trained or free of exposure. Check the company match and when the data last synced.

​
What Gets Synced

The Breach Secure Now integration syncs the following data for mapped clients:

​
Client Metrics

  • Average Employee Secure Score (ESS)
  • Average phishing fail rate
  • Dark web breach counts (breached employees and total breaches)
  • Active user count and product type

​
User Training Data

Per-user security awareness details, including:
  • Security training courses available and completed
  • Micro training completion percentage and average score
  • Employee Secure Score (ESS)
  • Phishing simulation results (emails sent, clicked, captured data, phish caught)
  • Dark web breach count and last breach date
  • Last login and enrollment status

​
Synchronization Schedule

After the initial setup, data syncs automatically once per day. Clients sync first, followed by user training data.
You can trigger a manual sync at any time: open the Breach Secure Now connection from Settings > Integrations and choose Run sync. Check Sync activity for the result before relying on new data.

​
Managing Your Integration

After setup, open the Breach Secure Now connection from Settings > Integrations:

​
Troubleshooting

​
Frequently Asked Questions

No. Enter the Partner integration key from the BSN MSPortal integration; MSPortal resolves the partner account from it.
No. The connection test reads only a sample of clients. Review the client list on Import or match companies and the saved matches for actual coverage.
No. After entering the replacement, choose Save changes. A test only checks credentials.
No. A zero only describes the synced data. Check the company match, how recently the data synced, and provider coverage before drawing conclusions.
No. The connection requires MSP integration management access. Mapping BSN users does not invite them or grant portal roles.

​
Next Steps

After setting up the Breach Secure Now integration:

View Security Data

Explore security awareness scores and breach exposure per client

Build Reports

Include training and phishing metrics in client reports

Other Integrations

Explore additional integration options

Integration FAQ

Common questions about syncing and mapping

​
Need Help?

For assistance with the Breach Secure Now integration, contact support@msportal.ai.