Blazalek.com

Weryfikacja domeny w Postmark: DKIM, Return-Path i test

Twoja aplikacja wysyła e-maile transakcyjne przez Postmark i chcesz, żeby domena z adresu From bezbłędnie przechodziła DKIM i DMARC. Zobacz, jak wygenerować i opublikować rekord DKIM, kiedy warto wdrożyć własny Return-Path dla zgodności SPF i jak sprawdzić nagłówki rzeczywistej wiadomości testowej.

Autor:

Na tej stronie

Gdy Twoja aplikacja wysyła e-maile transakcyjne przez Postmark, zweryfikuj w panelu dokładnie tę domenę, która pojawia się w polu From, a następnie wyślij przez tę aplikację wiadomość testową za pośrednictwem Postmark. Całe wdrożenie uznasz za zakończone dopiero wtedy, gdy połączysz dwa elementy: status Verified na koncie Postmark oraz pozytywne wyniki uwierzytelniania w nagłówkach odebranego e-maila.

Instrukcje konfiguracji Postmark sprawdziłem w oficjalnej dokumentacji technicznej 10 września 2026 r.

Nadawca i dostęp, zanim cokolwiek opublikujesz

Do przeprowadzenia wdrożenia potrzebujesz aktywnego konta Postmark z możliwością nadania wiadomości testowej z aplikacji. Ustal dokładny adres z pola From, którym posługuje się aplikacja. Zarządzanie domeną w Postmark wymaga konta z rolą Account Owner lub Account Admin (Postmark: role Account Owner i Account Admin), uprawnień do wysyłania poczty w imieniu tej domeny (Postmark: zatwierdzanie adresu i upoważnienie do korzystania z domeny) oraz uprawnień do dodawania rekordów w strefie DNS (Postmark: weryfikacja DKIM, krok 4). Jeśli brakuje któregokolwiek z tych warunków, zatrzymaj się na tym etapie.

Pamiętaj o różnicy między dwoma mechanizmami Postmark: Sender Signature autoryzuje wyłącznie pojedynczy adres e-mail, natomiast weryfikacja całej domeny daje prawo do nadawania korespondencji z dowolnego adresu w jej obrębie i uruchamia podpisywanie DKIM (Postmark: zatwierdzanie adresu i upoważnienie do korzystania z domeny). Samo dodanie Sender Signature nie zastępuje weryfikacji domeny i nie konfiguruje uwierzytelniania kryptograficznego.

Zanotuj obecne rekordy DNS i politykę DMARC, jeśli już istnieje pod nazwą _dmarc. Zacznij od _dmarc w dokładnej domenie adresu From, a w razie potrzeby ustal, która polityka domeny nadrzędnej ma zastosowanie (RFC 9989 §4.10.1). Zapisz wartości adkim i aspf: s oznacza ścisłą zgodność domen (alignment), r swobodną, a jeśli trybu nie podano, domyślnie obowiązuje zgodność swobodna (RFC 9989 §4.7). Dodając tego nadawcę, zachowaj istniejącą politykę i nie łagodź jej tylko po to, żeby uzyskać pozytywny wynik testu.

Weryfikacja DKIM i własny Return-Path w Postmark

W Sender Signatures wybierz Add Domain, jeśli docelowej domeny jeszcze nie ma, a następnie otwórz jej DNS Settings. System wygeneruje unikalną nazwę rekordu TXT dla DKIM oraz jego wartość kryptograficzną (Postmark: rozwiązywanie problemów z DKIM oraz Postmark: konfiguracja DKIM dla domeny). Skopiuj dokładnie wygenerowane wartości do strefy DNS, zwracając uwagę, czy panel DNS nie dodaje automatycznie nazwy domeny na końcu selektora.

Następnie podejmij decyzję w sprawie adresu Return-Path. Domyślnie odbicia trafiają na domenę Postmark pm.mtasv.net. Jeśli chcesz uzyskać zgodność domen również dla mechanizmu SPF, skonfiguruj własny Return-Path (Postmark: konfiguracja własnego Return-Path). Opublikuj rekord CNAME wskazujący na pm.mtasv.net pod wybranym aliasem, na przykład pm_bounces lub pm-bounces, zgodnie z tym, co wskazuje panel Twojego konta.

Postmark zarządza serwerami pocztowymi dla domeny pm.mtasv.net i nie wymaga dopisywania wpisu include:spf.mtasv.net do rekordu SPF w Twojej domenie głównej (Postmark: zasady konfiguracji SPF). Taki wpis nie jest w tym celu wymagany ani nie zastępuje rekordu CNAME własnego Return-Path. Pod dokładnie tą samą nazwą co CNAME nie dodawaj rekordu TXT dla SPF ani innego kolidującego rekordu; jeśli nazwa jest już zajęta, uzgodnij rozwiązanie konfliktu z osobą, która za nią odpowiada, albo wybierz inny obsługiwany alias.

Element konfiguracjiRekord DNSNazwa i wartość do wpisaniaCo potwierdzić w koncie
DKIMTXTWartości z kolumny DKIM w PostmarkUruchom Verify i sprawdź, czy status potwierdza pomyślną weryfikację Postmark: weryfikacja konfiguracji
Własny Return-Path (opcjonalny)CNAMENazwa aliasu wskazująca na pm.mtasv.netStatus Verified w sekcji Custom Return-Path

Zapisz rekord TXT, wróć do DNS Settings i uruchom Verify. Pomyślna weryfikacja włącza podpisywanie DKIM i upoważnia do wysyłania z całej domeny (Postmark: weryfikacja i wysyłka z całej domeny). Strony pomocy Postmark podają różny czas oczekiwania na weryfikację, a samo odczekanie nie oznacza, że weryfikacja się powiodła.

DMARC wymaga, aby domena nagłówka From była zgodna z domeną uwierzytelnioną przez SPF lub DKIM, co szczegółowo definiuje standard (RFC 9989 §4.4). Zgodność DKIM występuje wtedy, gdy domena w sygnaturze (header.d) odpowiada domenie nadawcy (RFC 9989 §4.4.1). Zgodność SPF zachodzi w trybie swobodnym, gdy ścieżka powrotna (na przykład subdomena bounces) i adres From dzielą tę samą domenę organizacyjną, natomiast w trybie ścisłym (aspf=s) domeny muszą być identyczne (RFC 9989 §4.4). Parametry adkim i aspf przyjmują wartość r (tryb swobodny, domyślny) albo s (tryb ścisły, trzeba go ustawić jawnie, na przykład adkim=s; aspf=r).

Jeśli do wiadomości nie ma zastosowania żadna polityka DMARC, jej wyniku DMARC nie można uznać za pass (RFC 9989 §5.3.2). Wstrzymaj wtedy tę weryfikację, aż właściciel domeny przygotuje szersze wdrożenie DMARC: uwierzytelnianie (RFC 9989 §5.1.4), działający adres odbioru raportów zbiorczych (RFC 9989 §5.1.3) i początkową politykę monitorującą pod kontrolą właściciela, na przykład p=none, z rzeczywistym adresem odbioru raportów. Polityka musi obejmować domenę autora i domenę organizacyjną, jeśli się różnią; kolejnym warunkiem jest proces analizy raportów (RFC 9989 §5.1.5). Zakres wysyłki ustalisz z pomocą procedury inwentaryzacji nadawców.

Wiadomość testowa z aplikacji i nagłówki odbiorcy

Wyślij jedną kontrolowaną wiadomość przez docelową aplikację na zewnętrzną skrzynkę, z której możesz pobrać oryginalne źródło wiadomości.

Sprawdź Authentication-Results utworzone przez zaufaną usługę odbierającą. Jeśli nie możesz ustalić, kto wygenerował wyniki, poproś tę usługę o ich potwierdzenie; do tego czasu weryfikacja pozostaje nieukończona (RFC 8601 §1.2). Praktyczne wskazówki znajdziesz w rozdziale weryfikacja całego łańcucha za pomocą nagłówków wiadomości. Zapisz każdy wynik razem z jego tożsamością: dkim z header.d i selektorem (RFC 8601 §2.7.1), spf z smtp.mailfrom (RFC 8601 §2.7.2) oraz dmarc z header.from (RFC 9989 §9.1).

Przykład poniżej jest syntetyczny: na potrzeby tego artykułu nie wysłano żadnej wiadomości. W obu przypadkach użyto From: receipt@notify.example.com i do obu ma zastosowanie prawidłowa polityka z adkim=s; aspf=r. W przypadku A na hipotetycznym koncie skonfigurowano i zweryfikowano alias bounces. Przyjmij założenie, że procedura ustalania domeny organizacyjnej u odbiorcy wskazuje example.com zarówno dla domeny From, jak i dla domeny do obsługi odbić, bez granicy domen organizacyjnych na niższym poziomie, która by je rozdzielała. Sam wspólny sufiks nie wystarcza, żeby to stwierdzić (RFC 9989 §4.10.2). W przypadku B przyjmij, że pm.mtasv.net ma inną domenę organizacyjną i że nie ma żadnego innego poprawnego podpisu DKIM ze zgodnością domen.

Wynik u odbiorcyPrzypadek APrzypadek B
SPFspf=pass smtp.mailfrom=pm_bounces@bounces.notify.example.comspf=pass smtp.mailfrom=pm_bounces@pm.mtasv.net
DKIMdkim=pass header.d=notify.example.comdkim=fail header.d=notify.example.com
DMARCdmarc=pass header.from=notify.example.comdmarc=fail header.from=notify.example.com

W Przypadku A obie metody uwierzytelniania kończą się sukcesem: DKIM ma zgodność bezpośrednią, a SPF zachowuje zgodność swobodną przez subdomenę bounces.notify.example.com, co daje dmarc=pass header.from=notify.example.com (RFC 9989 §4.4). W Przypadku B podpis DKIM zwraca błąd dkim=fail header.d=notify.example.com, a SPF odnosi się do domeny technicznej pm.mtasv.net. Żadna tożsamość nie spełnia kryteriów zgodności, więc DMARC kończy się wynikiem dmarc=fail header.from=notify.example.com (RFC 9989 §5.3.5). Ten wynik mówi, że takiej ścieżki brakuje, ale nie wskazuje konkretnego błędu DNS. W nagłówkach weryfikujesz statusy pass i fail dla protokołów spf, dkim i dmarc oraz sprawdzasz tożsamości header.d, header.from i smtp.mailfrom.

Gdyby w polityce DMARC ustawiono ścisłą zgodność SPF (aspf=s), subdomena bounces.notify.example.com z Przypadku A nie byłaby zgodna z domeną notify.example.com (RFC 9989 §4.4). Jednak niezależny, poprawny wynik DKIM ze zgodnością domen i tak zapewniłby pozytywny wynik DMARC (RFC 9989 §5.3.5). Podobnie w Przypadku B: gdyby DKIM dał wynik pass dla właściwej domeny, DMARC uzyskałby status pass nawet przy braku zgodności SPF (RFC 9989 §4.4.1).

Status Not Verified i powtórka testu

Wstrzymaj wdrożenie, dopóki zaplanowana ścieżka uwierzytelniania nie uzyska pełnego potwierdzenia. Jeśli Postmark wyświetla dla rekordu DKIM status Not Verified, porównaj dokładnie nazwę oraz wartość w strefie DNS z danymi w panelu: usuń zbędne spacje, sprawdź, czy sufiks domeny nie został powtórzony przez panel DNS, a jeśli dostawca DNS nakłada limity długości na rekord TXT, poproś o pomoc operatora DNS (Postmark: rozwiązywanie typowych problemów z DKIM). Jeśli dla CNAME Return-Path włączono proxy, ustaw DNS Only.

Jeśli odebrany e-mail nadal wskazuje domyślną domenę techniczną w nagłówku Return-Path, mimo że skonfigurowano własny alias, porównaj konfigurację DNS z ustawieniami w panelu (Postmark: konfiguracja własnego Return-Path) i sprawdź status weryfikacji (Postmark: weryfikacja własnego Return-Path). Po poprawieniu rekordu wyślij nową wiadomość przez aplikację i zbadaj zaktualizowane nagłówki zgodnie z sekcją 2.1 RFC 8601 (RFC 8601 §2.1). Jeśli rekordy w DNS są prawidłowe, a podpis DKIM nadal zawodzi, zachowaj oryginalną wiadomość i status z Postmark do dalszej diagnozy; nie ma podstaw, żeby uznać kolejną zmianę DNS za rozwiązanie.

Jeśli właściciel domeny wymaga ścisłej zgodności domen dla SPF, nie przedstawiaj przykładu z różnymi domenami jako spełniającego ten wymóg. Ustal wprost, jak go spełnić, i równolegle oceń niezależny wynik DKIM. Udana próba potwierdza wynik tylko dla tej drogi wysyłki i tej jednej wiadomości; nawet DMARC pass nie gwarantuje trafienia do skrzynki odbiorczej (RFC 9989 §1). W interpretacji wyniku pomoże materiał porównaj tożsamości uwierzytelniania w DMARC.

Najczęstsze pytania

Czy Sender Signature wystarczy zamiast weryfikacji domeny?

Nie. Sender Signature autoryzuje wyłącznie pojedynczy adres e-mail, natomiast weryfikacja całej domeny daje prawo do nadawania korespondencji z dowolnego adresu w jej obrębie i uruchamia podpisywanie DKIM. Samo dodanie Sender Signature nie zastępuje weryfikacji domeny i nie konfiguruje uwierzytelniania kryptograficznego.

Czy do SPF domeny głównej trzeba dodać include:spf.mtasv.net?

Nie. Postmark sam zarządza SPF dla domyślnej ścieżki obsługi odbić (bounce) przez pm.mtasv.net, więc dodanie include:spf.mtasv.net do rekordu SPF domeny głównej nie jest w tym celu wymagane ani nie zastępuje rekordu CNAME własnego Return-Path.

Czy własny Return-Path jest konieczny, żeby DMARC dał wynik pass?

Nie. Własny Return-Path pozwala uzyskać zgodność domen dla SPF, ale poprawny podpis DKIM ze zgodnością domen może samodzielnie zapewnić pozytywny wynik DMARC, nawet gdy SPF nie wykazuje zgodności domen.

pm_bounces czy pm-bounces: którą nazwę hosta wpisać?

Sprawdź dokładną wartość wygenerowaną w Twoim panelu Postmark, ponieważ w oficjalnych materiałach pojawiają się oba warianty (pm_bounces oraz pm-bounces). Jeśli wybierzesz inny obsługiwany alias, wpisz ten sam ciąg znaków w ustawieniach Custom Return-Path na koncie.

Co zrobić, gdy Postmark pokazuje status Not Verified?

Porównaj opublikowaną nazwę rekordu oraz jego wartość z danymi w panelu Postmark, usuwając przypadkowe spacje i upewniając się, że operator DNS nie zdublował sufiksu domeny. Jeśli limity długości TXT uniemożliwiają opublikowanie pełnej wartości, poproś o pomoc operatora DNS, a jeśli dla CNAME Return-Path włączono proxy, ustaw DNS Only.

Konsultant ds. dostarczalności e-mail

Co warto sprawdzić w Twojej wysyłce?

Opowiedz mi, co zgłaszają odbiorcy albo co planujesz zmienić. W 30 minut ustalimy, od czego Twój zespół może zacząć i czy warto zlecić audyt dostarczalności.

W GetResponse odpowiadałem za dostarczalność. Dla Easy.Tools zaprojektowałem osobny system do newsletterów, a zespołowi Youmoney pomogłem przenieść automatyczne wysyłki na nową platformę. Zobacz opisy projektów

Umów bezpłatną rozmowę

Audyt dostarczalności e-mail

Zobacz, co sprawdzam i jak wygląda raport z zaleceniami dla Twojego zespołu.