Files
sorsfonalak/docs/levelkuldes.md
T
fecoandClaude Opus 5.5 21640ffd9e
CI / test (push) Successful in 53s
CI / build (push) Successful in 4m32s
CI / deploy (push) Skipped
Amazon SES as the mail sender
- worker: without SMTP_URL, the SES SMTP address is built from the AWS
  access key and secret in .env.secrets (several common names, any case);
  the SMTP password is derived from the secret as AWS documents; region
  eu-central-1, port 2587 (DigitalOcean blocks 25/465/587)
- deploy compose: no empty SMTP_URL in the worker's environment (it
  overrode .env.secrets); MAIL_FROM defaults to hello@sorsfonalak.hu
- docs/levelkuldes.md rewritten for SES (domain, DKIM, custom MAIL FROM,
  sandbox, firewall); privacy policy names AWS as the mail processor

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-17 18:43:39 +00:00

7.0 KiB
Raw Blame History

Levélküldés élesben: Amazon SES

Élesben most nincs levélküldő beállítva (SMTP_URL üres), így minden levél az email_outbox táblában vár. Amíg ez így van, a meghívót kézzel is továbbadhatod: az admin „Meghívók” oldala küldés után kiírja a linket („Link másolása”).

A meghívó a legkényesebb levéltípus, mert a címzett nem kérte. A spammappát elsősorban a feladó hírneve és a domain hitelesítése dönti el, a sablon csak ezután számít. Ezért kellenek a lenti lépések.

A SES ára 1000 levelenként 0,10 USD; a mi forgalmunknál ez havi néhány cent.

1. Régió és domain (SES konzol)

  1. Régió: eu-central-1 (Frankfurt), hogy az adatok az EU-ban maradjanak. Minden lépést ebben a régióban kell elvégezni, mert a SES-beállítások régiónként külön élnek.
  2. Configuration → Identities → Create identity → Domain: sorsfonalak.hu.
    • Easy DKIM, RSA 2048 bit. A SES három CNAME-rekordot ad (lásd 3. pont).
    • Custom MAIL FROM domain: mail.sorsfonalak.hu, és Behavior on MX failure: Use default MAIL FROM domain. Ettől az SPF is a saját domainünkre szól, ami a DMARC-nál számít. Ehhez egy MX- és egy TXT-rekord kell.
  3. A domain igazolása után bármelyik @sorsfonalak.hu cím lehet feladó. Javaslat: hello@sorsfonalak.hu. A noreply cím a szűrőknél rosszabb, és válaszolni sem lehet rá.

2. Kilépés a homokozóból (sandbox)

Új SES-fiók homokozóban indul. Ilyenkor:

  • csak igazolt címekre lehet küldeni (Identities → Create identity → Email address; teszteléshez a saját címed elég);
  • naponta legfeljebb 200 levél megy ki.

Meghívót idegen címre csak éles hozzáféréssel lehet küldeni: Account dashboard → Request production access. Az AWS kézzel bírálja el, általában egy napon belül. A kérésben érdemes leírni:

  • tranzakciós levelek (megerősítés, értesítés) és meghívók egy zártkörű oldalra;
  • meghívót csak az admin küld, személyesen ismert embereknek, kis mennyiségben;
  • minden meghívóban egykattintásos leiratkozás van, a leiratkozott címekre többé nem megy levél;
  • a visszapattanó és panaszos címeket a SES fiókszintű tiltólistája kezeli (Suppression list: bounces és complaints).

Fontos: ha a visszapattanási arány 5%, vagy a panaszarány 0,1% fölé megy, az AWS felfüggesztheti a küldést. Ezért csak olyan címre küldj meghívót, amelyről tudod, hogy él.

3. DNS a Cloudflare-en

Típus Név Tartalom
CNAME ×3 <kód>._domainkey <kód>.dkim.amazonses.com (a SES konzol kiírja mindhármat)
MX mail feedback-smtp.eu-central-1.amazonses.com, prioritás 10
TXT mail v=spf1 include:amazonses.com ~all
TXT _dmarc v=DMARC1; p=none; rua=mailto:<a te címed>
  • Minden rekord DNS only (szürke felhő) legyen; a proxyzott CNAME-mel a DKIM nem működik.
  • DMARC: induláskor p=none (csak jelentés). Ha pár hétig minden levél átmegy, szigorítható p=quarantine-ra.
  • Ha a hello@sorsfonalak.hu címre érkező válaszokat is olvasni szeretnéd: a Cloudflare Email Routing ingyen továbbítja őket a Gmailedre. Ez a fő domainre (sorsfonalak.hu) tesz MX- és SPF-rekordot, ami nem ütközik a mail. aldomain rekordjaival.

4. Hozzáférés

Két út van, mindkettő a szerver .env.secrets fájljába kerül (kis- vagy nagybetűvel is jó):

  • SMTP-hozzáférés (SMTP settings → Create SMTP credentials): egy IAM-felhasználó, amely csak levelet küldhet.
    SES_SMTP_USERNAME=AKIA...
    SES_SMTP_PASSWORD=...
    
  • IAM-kulcspár, amelynek van ses:SendRawEmail joga:
    AWS_ACCESS_KEY_ID=AKIA...
    AWS_SECRET_ACCESS_KEY=...
    
    Más nevek is jók: a kulcsnál SES_AUTH_KEY, SES_ACCESS_KEY, SES_KEY, AUTH_KEY, a titoknál SES_SECRET, SES_SECRET_KEY, AWS_SECRET, AUTH_SECRET (a teljes lista: services/worker/src/ses.rs). A worker ebből az AWS által leírt módon kiszámolja az SMTP-jelszót. Ha az AWS_SECRET_ACCESS_KEY helyére az SMTP-jelszót írtad, azt is felismeri, és változatlanul használja.

A régió alapból eu-central-1 (Frankfurt); felülírható a SES_REGION változóval. A port 2587, ezt a SES_SMTP_PORT írja felül. URL-kódolásra itt nincs szükség, mert a worker maga állítja össze a címet.

5. Tűzfal

A DigitalOcean a dropleteken tiltja a szokásos kimenő SMTP-portokat (25, 465, 587). A SES erre a 2587-es portot (STARTTLS) is kínálja.

A droplet saját tűzfala (sorsfonalak-fw, DigitalOcean → Networking → Firewalls) a kimenő forgalmat is szűri. Az Outbound rules közé fel kell venni a TCP 2587-et (cél: All IPv4, All IPv6), különben a worker nem éri el a SES-t.

6. Indítás

  • A .env fájlban opcionális: MAIL_FROM=Sorsfonalak <hello@sorsfonalak.hu> (ez az alapérték is).
  • Utána: docker compose up -d worker. A naplóban ennek kell megjelennie: e-mail delivery enabled, via=Amazon SES eu-central-1:2587, credentials from ….
  • Az eddig várakozó levelek ekkor kimennek. Ha ezt nem szeretnéd, előtte töröld őket: DELETE FROM email_outbox WHERE sent_at IS NULL;.
  • Hibaüzenetek a naplóban:
    • 535 Authentication Credentials Invalid: hibás kulcs, vagy az IAM-felhasználónak nincs ses:SendRawEmail joga;
    • 554 Message rejected: Email address is not verified: a fiók még homokozóban van, és a címzett nincs igazolva;
    • időtúllépés: a tűzfalon nincs engedélyezve a kimenő 2587-es port.
  • Ha mégis kész SMTP-címet adnál meg, az SMTP_URL mindig elsőbbséget élvez a SES-változókkal szemben.

7. Próba

  1. Admin → Meghívók → Teszt küldése magamnak: megérkezik-e, és nem a spamben van-e.
  2. A Gmailben a levélnél ⋮ → Eredeti megjelenítése: az SPF, a DKIM és a DMARC mellett is PASS álljon.
  3. A mail-tester.com ad egy egyszeri címet. Küldj rá meghívót az admin oldalról (utána vond vissza), és nézd meg a pontszámot; 9/10 fölött jó. Ehhez már éles hozzáférés kell.

Amit a kód már elintéz

  • HTML és szöveges változat ugyanazzal a tartalommal. Egyhasábos, képek és követés nélkül, minden link a saját domainre mutat.
  • List-Unsubscribe és List-Unsubscribe-Post (RFC 8058): a Gmail és a többi levelező saját „Leiratkozás” gombot mutat. Aki leiratkozik, annak a címére soha többé nem megy meghívó (email_optouts, csak a cím hash-e).
  • A worker saját domaines Message-ID-t tesz a levélre. A SES ezt a sajátjára cseréli, ami rendben van.
  • Meghívót csak admin küldhet. Egy meghívó legfeljebb háromszor megy ki, 24 óránként egyszer. A személyes üzenet legfeljebb 300 karakter, és nem lehet benne link.

Később

A visszapattanásokról és panaszokról a SES utólag, SNS-értesítésben szól; az SMTP-kapcsolat ezt nem jelzi. Ha lesz forgalom, érdemes bekötni egy SNS → backend webhookot. Ez a meghívólistán megjelölné a visszapattant címeket, és a panaszt tevőket a leiratkozottak közé tenné.