Bounce-domein

Je bounce-domein is de return-path hostnaam op een verzenddomein. Bounces en afleveringsfeedback gaan naar dit envelope-from adres. Het CNAME-record laat ons bounces verwerken en zorgt voor SPF-afstemming zonder een SPF-record op de apex van je domein. Het bounce-domein is een van de drie records die verzending mogelijk maken.

Deze pagina gaat specifiek over het return-path. Zie Verzenddomeinen voor de volledige recordset en de verificatiecyclus, en DKIM, SPF & DMARC voor wat elk record bewijst.

Het record

Het return-path is een CNAME onder je verzenddomein dat verwijst naar onze bounce-infrastructuur in je regio:

Type	Host	Waarde
CNAME	send.example.com	<region>.bounce.bird.com

De waarde is regiospecifiek: us1.bounce.bird.com of eu1.bounce.bird.com. Kopieer deze uit Email > Domains in het dashboard of uit de domeinresource. De host is standaard send. onder je verzenddomein.

De hostnaam aanpassen

Je kiest het label wanneer je het domein registreert: geef het door als return_path.name en wij stellen de volledige hostnaam samen onder je verzenddomein:

const domain = await bird.domains.create({
  domain: "mail.acme.com",
  return_path: { name: "bounce" },
});

domain = client.domains.create(
    domain="mail.acme.com",
    return_path={"name": "bounce"},
)

domain, err := client.Domains.Create(context.Background(), bird.DomainCreateParams{
	Domain:     "mail.acme.com",
	ReturnPath: &bird.DomainReturnPathConfig{Name: "bounce"},
})

$domain = $bird->domains->create(
    (new DomainCreate())
        ->setDomain('mail.acme.com')
        ->setReturnPath((new DomainReturnPathConfig())->setName('bounce')),
);

bird email domains create mail.acme.com --body-file - <<'JSON'
{
  "domain": "mail.acme.com",
  "return_path": {
    "name": "bounce"
  }
}
JSON

curl -s https://us1.platform.bird.com/v1/email/domains \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "mail.acme.com",
    "return_path": { "name": "bounce" }
  }'

Dat registreert bounce.mail.acme.com als het return-path in plaats van de standaard send.mail.acme.com. Laat je return_path weg, dan wordt het standaard send. De hostnaam maakt deel uit van de werkruimteconfiguratie van het verzenddomein.

Waarom het SPF dekt

Ontvangers evalueren SPF op basis van het envelope-from domein in plaats van het zichtbare From:-adres. Je envelope-from is de return-path hostnaam. Omdat het geverifieerde CNAME verwijst naar onze bounce-infrastructuur, geldt de SPF-autorisatie van die infrastructuur voor jou, en het stemt af op je domein doordat het return-path een subdomein ervan is. Dus SPF slaagt en stemt af met één CNAME, en je hoeft geen include: op je apex te publiceren of te onderhouden. De volledige uitleg staat in Waar is SPF?.

Vereist voor verzending en kan niet worden verwijderd

Het return-path CNAME is onderdeel van de verzendvoorwaarde: capabilities.sending verifieert pas wanneer DKIM, het return-path CNAME en een DMARC-beleid allemaal aanwezig zijn. Zolang het return-path niet geverifieerd is, kan het domein niet verzenden.

Om dezelfde reden kan het return-path niet worden verwijderd. Elke verzending heeft een bestemming voor bounces nodig, dus je kunt de hostnaam wijzigen maar nooit wissen: een update die deze op null probeert te zetten wordt geweigerd. Wijzigingen worden veilig doorgevoerd. Een hostnaam die al geverifieerd is, wordt nooit verwisseld voor een ongeverifieerde. We verifiëren het nieuwe return-path naast je actieve en promoveren het pas wanneer het nieuwe CNAME slaagt, zodat live verzending nooit uitvalt terwijl je het record migreert.

Volgende stappen

Verzenddomeinen: een domein registreren en de verificatiecyclus
DKIM, SPF & DMARC: elk record op het domein en wat het bewijst
Tracking-domein: de optionele branded hostnaam voor open-/kliktracking
DNS-uitleg per provider: het CNAME publiceren bij je registrar

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsGetting started with email Ontdek de mogelijkheidEmail Volg het leerpadBuild your first integration ImplementatiegidsSend your first email

Probeer de oefening en ontvang een implementatieoverzicht