Credentials
Stolen logins are how most account takeovers start. Credentials watches for your staff addresses in known data breaches and for your domain on devices infected with password-stealing malware.
What is monitored
| Signal | What it tells you |
|---|---|
| Breached addresses | A monitored email address on your domain appears in a known breach. Each address is its own finding. |
| Infostealer infections | Malware copied saved logins for your domain from a staff device or a customer device. Counts are shown separately for staff and customers, with the date of the most recent staff infection. |
Findings from this page use the credentials category, so they appear in Findings with the rest. Breach metadata only is stored. Bermward does not collect password lists.
Managing monitored addresses
- Verify the domain first. Addresses are only monitored on verified owned domains.
- Paste addresses (up to 100,000 characters). Only addresses on that domain are accepted, and invalid ones are reported back.
- Discover addresses finds public staff addresses for the domain when the discovery connector is available on your server.
- Removing an address resolves its open breach findings.
- When a domain is verified, common role addresses are added for you.
| Free | Starter | Growth | MSP | |
|---|---|---|---|---|
| Monitored email addresses | Not included | 50 | 250 | 2500 |
Addresses over your allowance are skipped and counted in the response as over limit. On MSP plans the allowance is shared across all clients.
Checks and handling
Addresses are re-checked on a schedule. Press Check now for an immediate pass, at most once every ten minutes per domain. Breach findings describe something that already happened, so scans cannot close them. After you reset the password and revoke sessions, mark the finding handled.
API
| Method | Path | Role | What it does |
|---|---|---|---|
GET | /api/orgs/:orgId/credentials | viewer | Per-domain summary: addresses, infostealer counts, open findings and worst severity. |
GET | /api/orgs/:orgId/domains/:domainId/credentials | viewer | Addresses and credential findings for one domain. |
POST | /api/orgs/:orgId/domains/:domainId/credentials/addresses | analyst | Body: text with addresses. |
DELETE | /api/orgs/:orgId/domains/:domainId/credentials/addresses/:addressId | analyst | Stop monitoring an address. |
POST | /api/orgs/:orgId/domains/:domainId/credentials/discover | analyst | Discover addresses. |
POST | /api/orgs/:orgId/domains/:domainId/credentials/check | analyst | Check now. Answers 202, or 429 inside the cooldown. |
POST | /api/orgs/:orgId/findings/:findingId/handled | analyst | Mark a leaked credential finding handled. |