Szüksége lesz egy AWS-fiókra és hozzáférésre a domainje DNS-éhez. Az SES messze a legolcsóbb opció ezen a listán, és ezzel jár a legtöbb lépés.
Az Amazon saját dokumentációja: Domain ellenőrzése · SMTP-hitelesítő adatok beszerzése · Kilépés a tesztkörnyezetből (sandbox)
⭐ Az SES-hez annak SMTP-felületén keresztül csatlakozunk, nem pedig a REST API-ján keresztül. Ezért kérünk Öntől SMTP-felhasználónevet és -jelszót egy AWS hozzáférési kulcs helyett. Mindkét út pontosan ugyanazt az üzenetet kézbesíti; az SMTP-s megoldás elkerüli az AWS kérésaláírási problémák egy egész csoportját, amelyeket kívülről gyötrelmes diagnosztizálni, és az Amazon kifejezetten azért teszi közzé a hitelesítő adatokat ezen a felületen, hogy a miénkhez hasonló eszközök használhassák azt.
1. Válasszon egy régiót, és maradjon annál
Az SES régiónként működik. Az alábbiakban minden — az ellenőrzött domainje, a hitelesítő adatai, a küldési kvótája — egyetlen AWS-régióhoz tartozik, és semelyik másikban nem létezik.
Válassza ki az ügyfeleihez legközelebbit (eu-west-1 Európa esetén, us-east-1 Észak-Amerika esetén), és jegyezze fel. A domain Írországban történő ellenőrzése, majd a hitelesítő adatok Frankfurtban történő létrehozása a leggyakoribb módja annak, hogy elpazaroljon itt egy délutánt, és az ebből fakadó hibaüzenet semmit sem említ a régiókról.
2. Ellenőrizze a domainjét
Amazon SES console → Identities → Create identity → Domain. Adjon meg egy aldomaint, például a következőt: mail.yourdomain.com.
Kapcsolja be az Easy DKIM opciót, és válassza az RSA_2048_BIT lehetőséget. Az SES három CNAME rekordot ad Önnek:
| Type | Host |
|---|
CNAME | <token1>._domainkey.mail.yourdomain.com |
CNAME | <token2>._domainkey.mail.yourdomain.com |
CNAME | <token3>._domainkey.mail.yourdomain.com |
Adja hozzá mind a hármat. Az ellenőrzés általában egy órán belül befejeződik.
⭐ Engedélyezzen egy egyéni MAIL FROM domaint (bounce.mail.yourdomain.com) is, és adja hozzá a kért MX és SPF TXT rekordokat. Enélkül a borítékfeladó (envelope sender) az amazonses.com lesz, így az SPF az Amazonhoz igazodik és nem Önhöz, Ön pedig kizárólag a DKIM-re hagyatkozik.
3. Lépjen ki a sandboxból — ez az a lépés, amelyet az emberek kihagynak
⛔⛔ Az új SES-fiók egy tesztkörnyezetben (sandbox) van, és csak olyan címekre tud küldeni, amelyeket külön ellenőrzött. Minden mást el fog fogadni, de semmit sem kézbesít belőlük.
Pontosan ez az a hiba, amelynek kiszűrésére az ellenőrzési lépésünk létezik: a sandboxban az SES teljesen megszokott sikeres válasszal veszi át az üzenetét, majd eldobja azt. Ha úgy ellenőrzi a beállításunkat, hogy a tesztet egy olyan címre küldi, amelyet véletlenül már ellenőrzött az AWS-ben, az működni fog — aztán pedig minden valódi ügyfélnek szánt üzenet eltűnik.
Account dashboard → Request production access. Az Amazon rákérdez, hogy mit küld, és hogyan kezeli a visszapattanó leveleket; a saját ügyfeleinek szóló tranzakciós értesítésekről szóló pár őszinte mondatot általában 24 órán belül jóváhagyják.
⭐ Ezt az előtt tegye meg, mielőtt itt csatlakoztatná az SES-t. Utólag nincs mit hibakeresni, mert semmi sem jelez hibát.
4. SMTP-hitelesítő adatok létrehozása
SES console → SMTP settings → Create SMTP credentials.
Ez létrehoz egy kizárólag küldési engedéllyel rendelkező IAM-felhasználót, és megad egy SMTP-felhasználónevet és egy SMTP-jelszót.
⛔ Ezek nem az Ön AWS hozzáférési kulcsa és titkos kulcsa. Ezek egy adott algoritmus alapján származnak egy IAM-titokból, és nem felcserélhetők. Egy AWS secret access key beillesztése itt minden alkalommal hitelesítési hibát okoz, és a hiba egyszerűen azt fogja közölni, hogy a hitelesítő adatok el lettek utasítva.
⚠️ A jelszó csak egyszer jelenik meg. Töltse le a CSV-t, mielőtt elhagyná az oldalt.
5. Csatlakoztassa a Zinn®-ben
Nyissa meg az Email sending menüpontot az irányítópultján:
- Provider — Amazon SES
- Send from this domain —
mail.yourdomain.com
- AWS region — az 1. lépésből származó régió, pl.
eu-west-1
- SMTP username — a 4. lépésből
- Port — hagyja 587-en
- SES SMTP password — a 4. lépésből
A hostot felépítjük Ön helyett (email-smtp.<region>.amazonaws.com), így nem lehet elgépelni a hostnevet.
6. Küldje el a tesztet, és írja be a kódot
Nyomja meg a Send test message gombot egy olyan másik domainen lévő postafiókba, amelyet nem ellenőrzött az AWS-ben — egy személyes Gmail-cím ideális, mert ez bizonyítja, hogy kilépett a sandboxból. Olvassa el a kódot, és írja be.
Ha nem működik
"Email address is not verified" miközben valódi ügyfélnek küld — még mindig a sandboxban van. 3. lépés.
535 Authentication Credentials Invalid — az SMTP-hitelesítő adatok helyett az AWS hozzáférési kulcsát használta (4. lépés), vagy a hitelesítő adatok egy másik régióhoz tartoznak, mint amit megadott.
"Maximum sending rate exceeded" — egy új éles fiók másodpercenként 14 és naponta 50 000 üzenettel indul. Ez rengeteg értesítés, de ha nagy ügyfélkört költöztet, először kérjen emelést.
A tesztelés során működött, élesben pedig leállt — ellenőrizze az SES Reputation irányítópultját. Az Amazon automatikusan szünetelteti a küldést, ha a visszapattanási vagy a panaszarány átlépi a küszöbértéküket, és ezt egy régi ügyféllistával könnyű átlépni.