Skip to content

update Postboi dkim template (MAIL FROM), add Postboi dkim-dmarc template#1361

Open
darbymanning wants to merge 2 commits into
Domain-Connect:masterfrom
darbymanning:postboi-mailfrom-dmarc
Open

update Postboi dkim template (MAIL FROM), add Postboi dkim-dmarc template#1361
darbymanning wants to merge 2 commits into
Domain-Connect:masterfrom
darbymanning:postboi-mailfrom-dmarc

Conversation

@darbymanning

@darbymanning darbymanning commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Description

Updates the templates for Postboi (postboi.email), follow-up to #1333.

postboi.email.dkim → version 2: adds an aligned Amazon SES custom MAIL FROM on the bounce subdomain (MX + SPFM) alongside the existing three DKIM CNAMEs. Also moves logoUrl to a URL hosted on the provider domain itself.

postboi.email.dkim-dmarc (new): identical to dkim v2 plus a starter DMARC monitoring policy (v=DMARC1; p=none;). Postboi only builds apply URLs for this template after checking via DNS that the domain publishes no existing DMARC record — domains with a policy are always sent to the plain dkim template instead, so an apply can never downgrade an existing p=quarantine/p=reject policy. The record additionally carries txtConflictMatchingMode: Prefix on v=DMARC1 and essential: OnApply.

Type of change

Please mark options that are relevant.

  • New template (postboi.email.dkim-dmarc)
  • Bug fix (non-breaking change which fixes an issue in the template)
  • New feature (non-breaking change which adds functionality to the template) (postboi.email.dkim v2)
  • Breaking change (fix or feature that would cause existing template behavior to be not backward compatible)

How Has This Been Tested?

Please mark the following checks done

  • Template functionality checked using Online Editor
  • Template file name follows the pattern <providerId>.<serviceId>.json
  • resource URL provided with logoUrl is actually served by a webserver

Checklist of common problems

  • syncPubKeyDomain is set — public key published at _dcpubkeyv1.postboi.email (unchanged from v1)
  • warnPhishing is not set alongside syncPubKeyDomain — the two must not appear together
  • syncRedirectDomain is set whenever the template uses redirect_uri in the synchronous flow
  • no TXT record contains SPF content ("v=spf1 ...") — the MAIL FROM SPF uses SPFM on host bounce
  • txtConflictMatchingMode is set on every TXT record that must be unique per label or content prefix — the DMARC record uses Prefix / v=DMARC1
  • no variable is used as a bare full record value — DKIM variables are scoped with fixed suffixes (%dkim1%.dkim.amazonses.com)
  • no bare variable is used as the full host label — hosts use fixed ._domainkey suffix
  • no variable is used in the host field to create a subdomain — the bounce MAIL FROM host is a fixed label
  • %host% does not appear explicitly in any host attribute
  • essential is set to OnApply on records the end user may need to modify or remove without breaking the template — set on the DMARC record; the DKIM CNAMEs and MAIL FROM MX/SPFM are core to the service

Online Editor test results

Editor test link(s):

Test postboi.email/dkim-dmarc example.com/@

Test postboi.email/dkim-dmarc example.com/mail

Test postboi.email/dkim example.com/@

Test postboi.email/dkim example.com/mail

@github-actions github-actions Bot added Checklist of common problems not complete See PR template and mark *all* checkboxes, even if not applicable. Explain any discrepancies. PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. Test links missing No test links from Online Editor provided labels Jul 10, 2026
@github-actions

Copy link
Copy Markdown

JSON Filename Check Passed

@github-actions

Copy link
Copy Markdown

JSON Schema Validation Passed

@github-actions

github-actions Bot commented Jul 10, 2026

Copy link
Copy Markdown

Linter OK

postboi.email.dkim-dmarc.json

Level Code Note

postboi.email.dkim.json

Level Code Note

@darbymanning darbymanning changed the title postboi.email: add MAIL FROM records to dkim (v2), add dkim-dmarc template update Postboi dkim template (MAIL FROM), add Postboi dkim-dmarc template Jul 10, 2026
@github-actions github-actions Bot added the automerge-possible Label indicating, that restrictive linter checks all pass. For now it's PoC. label Jul 10, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Linter passed all checks — approving for auto-merge.

@github-actions github-actions Bot removed Checklist of common problems not complete See PR template and mark *all* checkboxes, even if not applicable. Explain any discrepancies. Test links missing No test links from Online Editor provided PR description incomplete The PR description template was not filled in at all, altered or filled in improperly. labels Jul 10, 2026
@github-actions

Copy link
Copy Markdown

PR Description Check Passed

All required sections are filled in correctly.

Details
  OK  Type of change: 2/4 checkboxes ticked
  OK  How Has This Been Tested?: all 3 checkboxes ticked
  OK  Checklist of common problems: 10/10 checkboxes ticked
  OK  Online Editor test results: 4 link(s) found
  OK  Template coverage: all 2 template(s) covered
Labels to remove: Checklist of common problems not complete, Forged editor links, PR description incomplete, Test links missing

PR description check PASSED

@darbymanning darbymanning marked this pull request as ready for review July 10, 2026 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automerge-possible Label indicating, that restrictive linter checks all pass. For now it's PoC.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant