Domena bounce

Twoja domena bounce to nazwa hosta return-path w domenie wysyłkowej. Odbicia i informacje zwrotne o dostarczeniu trafiają na ten adres envelope-from. Jej rekord CNAME pozwala nam przetwarzać odbicia i zapewnia zgodność SPF bez rekordu SPF w wierzchołku domeny. Domena bounce to jeden z trzech rekordów wymaganych do wysyłki.

Ta strona dotyczy konkretnie return-path. Pełny zestaw rekordów i cykl weryfikacji znajdziesz w artykule Domeny wysyłkowe; informacje o tym, co potwierdza każdy rekord, w artykule DKIM, SPF i DMARC.

Rekord

Return-path to rekord CNAME w Twojej domenie wysyłkowej, który wskazuje na naszą infrastrukturę bounce w Twoim regionie:

Typ	Host	Wartość
CNAME	send.example.com	<region>.bounce.bird.com

Wartość zależy od regionu: us1.bounce.bird.com lub eu1.bounce.bird.com. Skopiuj ją z Email > Domains w panelu lub z zasobu domeny. Host domyślnie przyjmuje wartość send. w Twojej domenie wysyłkowej.

Dostosowywanie nazwy hosta

Etykietę wybierasz podczas rejestracji domeny: przekaż ją jako return_path.name, a my utworzymy pełną nazwę hosta w Twojej domenie wysyłkowej:

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" }
  }'

To rejestruje bounce.mail.acme.com jako return-path zamiast domyślnego send.mail.acme.com. Pomiń return_path, a wartość domyślna to send. Nazwa hosta jest częścią konfiguracji domeny wysyłkowej w obszarze roboczym.

Dlaczego obejmuje SPF

Odbiorcy sprawdzają SPF względem domeny envelope-from, a nie widocznego adresu From:. Twój envelope-from to nazwa hosta return-path. Ponieważ zweryfikowany CNAME wskazuje na naszą infrastrukturę bounce, autoryzacja SPF tej infrastruktury obejmuje również Ciebie i jest zgodna z Twoją domeną, bo return-path jest jej subdomeną. Dzięki temu SPF przechodzi pomyślnie i jest zgodny z jednym rekordem CNAME, a Ty nie musisz publikować ani utrzymywać rekordu include: w wierzchołku domeny. Pełne uzasadnienie znajdziesz w artykule Gdzie jest SPF?.

Wymagany do wysyłki i nie może być usunięty

Rekord CNAME return-path jest częścią bramki wysyłki: capabilities.sending weryfikuje się dopiero wtedy, gdy DKIM, rekord CNAME return-path i polityka DMARC są na miejscu. Dopóki return-path nie zostanie zweryfikowany, domena nie może wysyłać.

Z tego samego powodu return-path nie może być usunięty. Każda wysyłka wymaga adresu dla odbić, więc możesz zmienić nazwę hosta, ale nigdy jej usunąć: aktualizacja próbująca ustawić wartość null zostanie odrzucona. Zmiany są wdrażane bezpiecznie. Nazwa hosta, która jest już zweryfikowana, nigdy nie zostanie zamieniona na niezweryfikowaną. Weryfikujemy nowy return-path równolegle z aktywnym i promujemy go dopiero wtedy, gdy nowy CNAME przejdzie sprawdzenie, dzięki czemu wysyłka nie zostaje przerwana podczas migracji rekordu.

Następne kroki

Domeny wysyłkowe: rejestracja domeny i cykl weryfikacji
DKIM, SPF i DMARC: każdy rekord w domenie i co potwierdza
Domena śledzenia: opcjonalna nazwa hosta ze swoją marką do śledzenia otwarć i kliknięć
Instrukcje DNS dla poszczególnych dostawców: publikowanie rekordu CNAME u Twojego rejestratora

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikGetting started with email Poznaj możliwościEmail Podążaj ścieżką naukiBuild your first integration Przewodnik wdrożeniowySend your first email

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy