Bermward

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

KindVerified?ScanningUsed for
OwnedYes, with a DNS TXT recordPassive, plus active on verified domains when the plan includes itYour own domains and your clients' domains.
ProspectNeverPassive onlyMSP 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

SettingValuesNotes
Depth (scan tier)Passive or activeActive needs a verified owned domain and a plan with active scanning.
ScheduleWeekly or dailyDaily needs a plan whose scan schedule is daily. Free plans stay weekly.
Monitoring (paused)On or offA 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

FreeStarterGrowthMSP
Owned domains11350
Prospect domainsNot includedNot includedNot included25
Subdomains scanned per domain252005001000
Scan scheduleweeklydailydailydaily

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

MethodPathRoleWhat it does
GET/api/orgs/:orgId/domainsviewerList domains with latest scan and open counts.
POST/api/orgs/:orgId/domainsanalystAdd a domain. Body: domain, optional kind of owned or prospect. Starts the first scan.
GET/api/orgs/:orgId/domains/:domainIdviewerOne domain, its running scan and plan capabilities.
PATCH/api/orgs/:orgId/domains/:domainIdadminChange scanTier, schedule or paused.
DELETE/api/orgs/:orgId/domains/:domainIdadminRemove a domain and its history.
POST/api/orgs/:orgId/domains/:domainId/verifyanalystCheck the verification TXT record.
POST/api/orgs/:orgId/domains/:domainId/scananalystStart a scan. Answers 202, or 429 inside the five minute cooldown.
GET/api/orgs/:orgId/domains/:domainId/scansviewerScan history.
GET/api/orgs/:orgId/domains/:domainId/timelineviewerChanges over time.
GET/api/orgs/:orgId/domains/:domainId/assetsviewerSubdomains and certificates.

Read-only access with an API token is described in API.