Documentation
Sign inGet started

bird email tools analyze-dmarc-report

Usage

Codevoorbeeld
bird email tools analyze-dmarc-report <report-xml> [flags]

Description

Analyze a DMARC aggregate report
Analyze a DMARC aggregate (RUA) report and get back totals, a per-source-IP breakdown, and plain-language findings. These are the XML reports mailbox providers email to the address in your DMARC rua= tag; pass the XML in report_xml. The tool reports the overall pass rate, which sources are passing or failing SPF and DKIM alignment (and which domains a failing source is sending as — usually a forwarder), and flags the things worth acting on. Use this to read a DMARC report you can't make sense of, or to find which senders are failing before you tighten your policy. Offline — nothing is looked up or sent. Public — no authentication required.
Build the request from the <report_xml> argument, a JSON AnalyzeDmarcReportRequest body via --body-file ("-" reads stdin), or both — an inline value overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.

Examples

Codevoorbeeld
# print the body shape (no credentials needed)
bird email tools analyze-dmarc-report --example

Options

Request

NameDescription
--body-fileRead the JSON request body from this file; "-" reads stdin
--examplePrint a complete example request body, then exit
--dry-runPrint the resolved request without sending it, then exit
--idempotency-keyDeduplication key; a retry with the same key won't act twice

Options

NameDescription
--response-schemaPrint the fields this command returns, then exit
NameDescription
bird email tools analyze-headersAnalyze raw email headers
bird email tools auditAudit a domain's email authentication
bird email tools split-dns-recordSplit a long DNS TXT value into 255-octet chunks
bird email tools validate-bimiValidate a BIMI record
bird email tools validate-dmarcValidate a DMARC record