Testing av e-post fra Amazon SES

Sjekk sandkassen først, fordi den avgjør om dette fungerer i det hele tatt. En ny SES-konto starter i sandkassen i hver region, og så lenge den er der, leverer SES bare til verifiserte adresser, verifiserte domener og sin egen postkassesimulator. I tillegg er grensen 200 meldinger per 24 timer og én melding per sekund.

Det hjelper ikke å verifisere en Email Spam Tester-adresse. SES verifiserer en mottaker ved å sende en e-post med en lenke, og siden adressene våre godtar nøyaktig én melding før de stenges, vil verifiseringsmeldingen bruke opp adressen. I praksis trenger du derfor produksjonstilgang i regionen du sender fra. AWS lover et første svar på forespørselen innen 96 timer.

Fordi sandkassestatus gjelder per region, kan en konto som er i produksjon i eu-west-1, fortsatt være i sandkassen i us-east-1. Identiteter gjelder også per region, hver med sine egne DKIM-oppføringer.

Hent en adresse, send én melding

Åpne email-spam-tester.com og kopier adressen som vises. Du trenger verken konto eller API-nøkkel. Adressen ser ut som test- etterfulgt av tjue tegn på t.email-spam-tester.com. Du har én time og én melding, så klargjør sendekommandoen før du henter adressen.

Den enkleste måten å sende på er med CLI. Kommandoen er tilpasset fra AWS sitt eget eksempel på siden om SES-leietakere, uten flaggene for leietaker og konfigurasjonssett:

aws sesv2 send-email \
  --from-email-address "sender@yourdomain.com" \
  --destination "ToAddresses=test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}"

From må være en verifisert identitet, også i produksjon. En melding med bare tekst, som denne, er nok til å teste autentisering og IP, men sier nesten ingenting om innholdet. For å få et reelt resultat må du sende meldingen applikasjonen faktisk sender, med HTML-delen og meldingshodene. Bruk også den samme kodebanen, enten det er boto3-funksjonen send_email, et SMTP-bibliotek eller noe annet. Hvis produksjonsutsendelser bruker et konfigurasjonssett, legger du også til --configuration-set-name her, slik at testen kjøres med de samme innstillingene.

Innbokstesten bruker den samme kommandoen. Leverandørinnboksene legges til i ToAddresses ved siden av testadressen, og markøren legges til i Subject-dataene. Ett kall fyller da ut to rapporter. Den andre viser hvilken mappe meldingen havnet i hos Gmail, Outlook, Yahoo og andre leverandører. Disse innboksene er heller ikke verifisert, så dette krever også produksjonstilgang.

Du kan også bruke konsollen. Åpne Configuration > Identities, klikk på identiteten og velg Send test email. Velg Raw hvis du vil lime inn en fullstendig MIME-melding med egne meldingshoder. AWS beskriver konsollen som et verktøy du vanligvis bare bruker til testmeldinger, og dokumentasjonen beskriver ikke noe testprefiks eller andre endringer i meldingen. I sandkassen må feltet Custom recipient inneholde en verifisert adresse, noe som fører deg tilbake til problemet ovenfor.

Slik ser en ny SES-identitet ut i rapporten

DKIM. Easy DKIM er standarden for domeneidentiteter og signerer hver melding med en 2048-bits nøkkel. Oppsettet består av tre CNAME-oppføringer med navnet token._domainkey.yourdomain.com som peker til token.dkim.<region>.amazonses.com. Hvis DKIM-kontrollen mislykkes, bør du først kontrollere to ting: om DNS er oppdatert (AWS oppgir at det kan ta opptil 72 timer), og om DNS-leverandøren la domenet til navnet og opprettet token._domainkey.yourdomain.com.yourdomain.com. Med BYODKIM publiserer du i stedet én TXT-oppføring på din egen selektor. Under bytte mellom de to kan SES sende helt uten signatur, noe rapporten markerer som manglende DKIM. DKIM-kontrollen bruker tokenet som selektor.

SPF og retursti. Som standard bruker SES et underdomene av amazonses.com som MAIL FROM. SPF består, men for amazonses.com, så rapporten viser SPF som ikke justert med From-domenet ditt. Når DKIM er justert, har dette liten betydning (2 poeng på skalaen med 100 poeng i stedet for 5), og DMARC består fortsatt basert på DKIM. Hvis du også vil justere SPF, konfigurerer du et tilpasset MAIL FROM-underdomene med nøyaktig én MX-oppføring, 10 feedback-smtp.<region>.amazonses.com, og en TXT-oppføring, v=spf1 include:amazonses.com ~all. Ikke velg et underdomene som mottar e-post, og ikke ta med aspf=s i DMARC-oppføringen, fordi AWS oppgir at SPF-justering med SES ikke fungerer med strenge SPF-regler.

DMARC. SES publiserer ikke en DMARC-oppføring for deg. Eksempelet fra AWS er v=DMARC1;p=quarantine;rua=mailto:my_dmarc_report@example.com. Hvis ingen leser DMARC-rapportene dine ennå, ville jeg startet med p=none og strammet inn senere. DMARC-kontrollen viser hva du har, og DMARC fail beskriver de vanligste feilene.

List-Unsubscribe. SES legger bare til List-Unsubscribe og List-Unsubscribe-Post når du sender med ListManagementOptions som peker til en kontaktliste og et emne. Selv da skjer det bare for meldinger med én mottaker og bare med Easy DKIM, og SES overskriver eventuelle avmeldingshoder du angir selv. Alt annet sendes uten avmeldingshoder. For et nyhetsbrev betyr dette at både List-Unsubscribe-kontrollen og ettklikkskontrollen mislykkes, med mindre du legger til hodene selv. Siden mars 2024 har v2 API støttet egendefinerte hoder uten rå MIME. Tilpasset fra AWS sitt blogginnlegg om ettklikksavmelding ser de to hodene slik ut:

"Headers": [
  { "Name": "List-Unsubscribe",
    "Value": "<https://yourdomain.com/unsub?address=x&topic=x>, <mailto:unsubscribe@yourdomain.com>" },
  { "Name": "List-Unsubscribe-Post",
    "Value": "List-Unsubscribe=One-Click" }
]

Endepunktet ditt må deretter håndtere POST-forespørselen. Tilbakestilling av passord og kvitteringer uten listehoder er et annet tilfelle. For slike meldinger markerer rapporten gruppen for masseutsendelser som hoppet over. Du finner mer om hodet på siden vår om List-Unsubscribe.

IP-adresser og blokkeringslister

Nye kontoer sender fra IP-adresser som deles med andre SES-brukere, og AWS anbefaler å fortsette med dem med mindre du har et stort og regelmessig volum. Rapporten sjekker IP-adressen som brukes til sending, mot 21 blokkeringslister. For delte adresser gjelder et treff hele gruppen. Dedikerte IP-adresser finnes som Standard, som du varmer opp manuelt, eller Managed, der SES håndterer oppvarmingen. Da er en oppføring knyttet til din egen sending. Alle IP-adresser du finner i fanen Headers, kan legges direkte inn i blokkeringslistekontrollen.

AWS overvåker også kontoen din. Ifølge vanlige spørsmål om håndheving bør du teste mot ekte adresser som kan motta e-post, eller bruke simulatoren, slik at oppdiktede mottakere ikke øker antallet avvisninger. En konto blir satt til gjennomgang ved en avvisningsfrekvens på 5 % eller en klagefrekvens på 0,1 %.

Tiltaksplanen nederst viser opptil åtte endringer. Hver endring inneholder DNS-oppføringen du skal kopiere når det er relevant, og poengene ved siden av hvert tiltak er de gjeldende trekkene for kontrollene tiltaket berører. Modellen velger og forklarer tiltakene. Den beregner ikke hva de koster. Hvis navnet på en kontroll ikke sier deg noe, forklarer dokumentasjonen hver av de 42 kontrollene.