Yuva Email Worker za Cloudflare

E-pošta podrške preko Cloudflarea.Nema poštanskog poslužitelja za pokretanje.

Cloudflare® Email Routing prima poštu za vaše adrese podrške, a open-source Yuva Email Worker predaje svaku poruku Yuvi, potpisanu. Stiže u vaš zajednički sandučić kao razgovor na koji odgovara vaš tim.

Pročitaj vodič za postavljanje Izvorni kôd Workera na GitHubu →

Što je

Email Routing ispred

Cloudflare Email Routing postaje MX vaše domene i prima poštu. Yuva ne sluša SMTP, pa nema poštanskog poslužitelja za instalaciju ni održavanje.

Mali open-source Worker

Yuva Email Worker čita sirovu poruku i omotnicu, potpisuje zahtjev i šalje ga Yuvi. Parsiranje, nizanje u niti i odluke o spamu ostaju na poslužitelju.

Stvarni razgovori

Pošta na adresu podrške otvara ili nastavlja razgovor u sandučiću, a tim odgovara iz istog panela kao i na chat i poruke iz aplikacije.

Kako poruka stiže od klijenta do vašeg tima

1Klijent piše na jednu od vaših adresa za podršku, na primjer support@example.com.
2Cloudflare Email Routing prima poruku i predaje je Yuva Email Workeru.
3Worker potpisuje sirovu poruku, obje adrese omotnice i vremensku oznaku pomoću HMAC-SHA256 s tajnom koju dijelite s Yuvom i šalje ih na /ingress/email na vašem Yuva poslužitelju.
4Yuva provjerava potpis i je li vremenska oznaka unutar 5 minuta prije nego što pročita poruku. Zahtjev s pogrešnim potpisom odbija se.
5Yuva pronalazi kanal e-pošte za adresu primatelja i nizom In-Reply-To i References uvrštava poruku u razgovor kojem pripada. Sve ostalo pokreće novi razgovor. Odgovor ponovno otvara razgovor.
6Vaš tim odgovara u panelu. Odgovor se šalje preko SMTP računa samog kanala e-pošte, poput Amazon SES-a, Postmarka ili vlastitog releja, s iste adrese i u istoj niti. Odgovori ne prolaze kroz Worker.

Odbijanja stižu do pošiljatelja

Kad Yuva trajno odbije poruku, na primjer zbog nepoznate adrese, blokiranog pošiljatelja ili prevelike poruke, Worker je odbija, a pošiljatelj dobiva trajnu SMTP pogrešku s Yuvinim razlogom.

Ako je Yuva nedostupna

Ako Yuva odgovori pogreškom poslužitelja, ne odgovori u 20 sekundi ili je nedostupna, Worker može proslijediti poruku na adresu koju odaberete, pod uvjetom da postavite FALLBACK_FORWARD. Ta adresa mora biti potvrđeno odredište u Email Routingu. Poruka tada stiže kao obično prosljeđivanje i ne pojavljuje se u Yuvi. Bez FALLBACK_FORWARD isporuka ne uspijeva s pogreškom, a poslužitelj pošiljatelja može kasnije pokušati ponovno.

Postavite ga u nekoliko koraka

Trebate Yuva poslužitelj i Cloudflare račun koji upravlja domenom.

1
U Yuvi otvorite Postavke → vaš sandučić → Kanali → E-pošta i dodajte adresu podrške. Postavite tajnu na poslužitelju i ponovno ga pokrenite:
```
YUVA_INGRESS_SECRET=<openssl rand -hex 32>
YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
```

Postavite Worker na svoj Cloudflare račun, s istom tajnom:

cd edge
bun install
bunx wrangler login
bunx wrangler secret put INGRESS_SECRET
bunx wrangler deploy --var YUVA_URL:https://support.example.com

3
U Cloudflare nadzornoj ploči otvorite svoju domenu → Email → Email Routing i uključite ga. Cloudflare dodaje svoje MX i SPF zapise.
4
Pod Routing rules usmjerite svaku adresu podrške na Worker yuva-edge. Za sveobuhvatni kanal usmjerite sveobuhvatno pravilo na njega.
5
Pošaljite probnu poruku i gledajte kako se razgovor pojavljuje u panelu.

Neobavezno: sačuvajte poštu tijekom ispada dodavanjem pričuvne adrese u naredbu za implementaciju:

bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org

Email Routing postaje MX domene, stoga koristite domenu ili poddomenu koju ne obrađuje nijedan drugi poštanski poslužitelj.

Pročitaj vodič za postavljanje →

Nije vezano uz Cloudflare

Worker je jedan od načina za pozivanje /ingress/email. Bilo koji poštanski poslužitelj ili relej može poslati sirovu poruku s istim potpisanim zaglavljima, a poštanski poslužitelj koji isporučuje naredbi može proslijediti poruku u yuva ingest-email. Format zahtjeva dokumentiran je u README-u Workera.

Pročitaj ingress ugovor →Drugi načini za unos pošte →

Pitanja i odgovori

Moram li pokretati poštanski poslužitelj?

Ne za dolaznu poštu. Yuva ne sluša SMTP; poštu prima Cloudflare Email Routing, a Worker je prosljeđuje. Odgovori trebaju SMTP račun za kanal e-pošte, poput Amazon SES-a, Postmarka ili vlastitog releja.

Što se događa kad Yuva ne radi?

S postavljenim FALLBACK_FORWARD poruka se umjesto toga prosljeđuje na tu adresu. Bez njega isporuka ne uspijeva, a poslužitelj pošiljatelja može pokušati ponovno. Poruke koje Yuva namjerno odbija, poput pošte na nepoznatu adresu, odbijaju se, a ne prosljeđuju.

Koje domene i adrese mogu koristiti?

Bilo koja domena kojom upravljate u Cloudflareu i čiju poštu ne obrađuje nijedan drugi poslužitelj, jer Email Routing postaje njezin MX. Svaki kanal e-pošte ima adresu ili sveobuhvatnu *@example.com za sve adrese domene koje nijedan kanal nema točno. Podadresa poput support+billing@example.com stiže u kanal adrese support@example.com.

Koliko velika može biti poruka?

Poruka može imati do 25 MiB uključujući privitke, što je ograničenje Cloudflare Email Routinga. Yuva zadržava do 50 privitaka po poruci, svaki unutar ograničenja veličine privitaka na poslužitelju (zadano 25 MiB) i dopuštenih vrsta; ostalo izostavlja.

Može li netko krivotvoriti poštu prema mom Yuva poslužitelju?

Yuva odbija svaki zahtjev bez valjanog HMAC potpisa ili s vremenskom oznakom koja odstupa više od 5 minuta, prije nego što pročita tijelo. Tajnu zadržite za sebe.

Koristi li Yuva DMARC rezultat iz Cloudflarea?

Da, kad postavite YUVA_INGRESS_AUTHSERV_ID na mx.cloudflare.net. Yuva tada čita DMARC presudu koju dodaje Email Routing. Novi razgovor koji ne prođe DMARC označava se kao spam.

Cloudflare, logotip Cloudflarea i Cloudflare Workers zaštitni su znakovi i/ili registrirani zaštitni znakovi tvrtke Cloudflare, Inc. u Sjedinjenim Državama i drugim jurisdikcijama. Yuva je neovisan open-source projekt, nije povezan s Cloudflareom niti ga Cloudflare podržava.