Domains
A domain is the unit Bermward scans. Add the domains you own, prove you own them, and Bermward maps what attackers can see and keeps checking it.
Owned and prospect domains
| Kind | Verified? | Scanning | Used for |
|---|---|---|---|
| Owned | Yes, with a DNS TXT record | Passive, plus active on verified domains when the plan includes it | Your own domains and your clients' domains. |
| Prospect | Never | Passive only | MSP sales reports on a company that is not a client yet. Convert it into a client when they sign. |
What a scan checks
- Email authentication: SPF, DKIM, DMARC and MTA-STS.
- Certificates and domain registration expiry.
- Subdomains found in certificate logs, and subdomain takeover risks.
- Registered lookalike domains.
- Threat-feed listings.
- On verified domains with active scanning: open ports and known vulnerabilities on exposed hosts.
Adding and verifying
Adding a domain starts its first scan automatically. To verify, publish the TXT record shown on the domain page (see Getting started) and press Check DNS record. Checks are rate limited to ten a minute. A failed lookup tells you whether the record is missing or the DNS lookup itself failed.
The first time a domain verifies on a plan with active scanning, its scan tier switches to active and a verification scan starts. Free role addresses on the domain are also added for credential monitoring.
Scan settings
| Setting | Values | Notes |
|---|---|---|
| Depth (scan tier) | Passive or active | Active needs a verified owned domain and a plan with active scanning. |
| Schedule | Weekly or daily | Daily needs a plan whose scan schedule is daily. Free plans stay weekly. |
| Monitoring (paused) | On or off | A paused domain is not scanned and stops counting toward your running-domain limit. Resuming checks the limit again. |
Only admins change these. Anyone with the analyst role can start a manual scan. A domain scanned in the last five minutes answers with a short wait instead of starting another scan. A domain cannot be removed while a scan is running.
Limits by plan
| Free | Starter | Growth | MSP | |
|---|---|---|---|---|
| Owned domains | 1 | 1 | 3 | 50 |
| Prospect domains | Not included | Not included | Not included | 25 |
| Subdomains scanned per domain | 25 | 200 | 500 | 1000 |
| Scan schedule | weekly | daily | daily | daily |
The domain page
Each domain has tabs for findings, assets (subdomains and certificates), scan history, a timeline of what changed, DMARC and credentials. The credentials and DMARC tabs appear on owned domains only. Changes are summarised in the timeline so you can see exactly which scan opened or closed an issue.
API
| Method | Path | Role | What it does |
|---|---|---|---|
GET | /api/orgs/:orgId/domains | viewer | List domains with latest scan and open counts. |
POST | /api/orgs/:orgId/domains | analyst | Add a domain. Body: domain, optional kind of owned or prospect. Starts the first scan. |
GET | /api/orgs/:orgId/domains/:domainId | viewer | One domain, its running scan and plan capabilities. |
PATCH | /api/orgs/:orgId/domains/:domainId | admin | Change scanTier, schedule or paused. |
DELETE | /api/orgs/:orgId/domains/:domainId | admin | Remove a domain and its history. |
POST | /api/orgs/:orgId/domains/:domainId/verify | analyst | Check the verification TXT record. |
POST | /api/orgs/:orgId/domains/:domainId/scan | analyst | Start a scan. Answers 202, or 429 inside the five minute cooldown. |
GET | /api/orgs/:orgId/domains/:domainId/scans | viewer | Scan history. |
GET | /api/orgs/:orgId/domains/:domainId/timeline | viewer | Changes over time. |
GET | /api/orgs/:orgId/domains/:domainId/assets | viewer | Subdomains and certificates. |
Read-only access with an API token is described in API.