Preskočiť na obsah
Yuva

Yuva Email Worker pre Cloudflare

E-mail podpory cez Cloudflare.Žiadny poštový server na prevádzku.

Cloudflare® Email Routing prijíma poštu vašich adries podpory a open source Yuva Email Worker odovzdá každú správu Yuve, podpísanú. Dorazí do vašej zdieľanej schránky ako konverzácia, na ktorú odpovedá váš tím.

Čo to je

Email Routing vpredu

Cloudflare Email Routing sa stane MX vašej domény a prijíma poštu. Yuva nepočúva na SMTP, takže nie je čo inštalovať ani aktualizovať.

Malý open source Worker

Yuva Email Worker prečíta surovú správu a obálku, podpíše požiadavku a odošle ju Yuve. Parsovanie, vlákna a rozhodnutia o spame zostávajú na serveri.

Skutočné konverzácie

Pošta na adresu podpory otvorí alebo nadviaže konverzáciu v schránke a tím odpovedá z rovnakého panela ako pri chate a správach z aplikácií.

Ako sa správa dostane od zákazníka k vášmu tímu

  1. 1Zákazník píše na jednu z vašich adries podpory, napríklad support@example.com.
  2. 2Cloudflare Email Routing prijme správu a odovzdá ju Yuva Email Workeru.
  3. 3Worker podpíše surovú správu, obe adresy obálky a časovú pečiatku pomocou HMAC-SHA256 s tajomstvom, ktoré zdieľate s Yuva, a odošle ich na /ingress/email na vašom serveri Yuva.
  4. 4Yuva pred prečítaním správy overí podpis a či je časová pečiatka v rozmedzí 5 minút. Požiadavka s nesprávnym podpisom sa odmietne.
  5. 5Yuva nájde e-mailový kanál podľa adresy príjemcu a správu zaradí podľa In-Reply-To a References do konverzácie, do ktorej patrí. Čokoľvek iné začne novú konverzáciu. Odpoveď konverzáciu znova otvorí.
  6. 6Váš tím odpovedá v paneli. Odpoveď sa odošle cez vlastný účet SMTP e-mailového kanála, napríklad Amazon SES, Postmark alebo váš vlastný relay, z rovnakej adresy a v rovnakom vlákne. Odpovede neprechádzajú cez Worker.

Odmietnutia sa dostanú k odosielateľovi

Keď Yuva správu natrvalo odmietne, napríklad pre neznámu adresu, blokovaného odosielateľa alebo príliš veľkú správu, Worker ju odmietne a odosielateľ dostane trvalú chybu SMTP s dôvodom od Yuva.

Ak je Yuva nedostupná

Ak Yuva odpovie chybou servera, neodpovie do 20 sekúnd alebo je nedostupná, Worker môže správu presmerovať na adresu, ktorú zvolíte, ak nastavíte FALLBACK_FORWARD. Táto adresa musí byť overeným cieľom v Email Routing. Správa potom dorazí ako obyčajné presmerovanie a v Yuva sa neobjaví. Bez FALLBACK_FORWARD doručenie zlyhá s chybou a odosielajúci server to môže neskôr skúsiť znova.

Nastavte to v niekoľkých krokoch

Potrebujete server Yuva a účet Cloudflare, ktorý spravuje doménu.

  1. 1

    V Yuva otvorte Nastavenia → vaša schránka → Kanály → E-mail a pridajte adresu podpory. Nastavte na serveri tajomstvo a reštartujte ho:

    YUVA_INGRESS_SECRET=<openssl rand -hex 32>
    YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net
  2. 2

    Nasaďte Worker do svojho účtu Cloudflare s rovnakým tajomstvom:

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

    V paneli Cloudflare otvorte svoju doménu → Email → Email Routing a zapnite ho. Cloudflare pridá svoje záznamy MX a SPF.

  4. 4

    V Routing rules pošlite každú adresu podpory Workeru yuva-edge. Pri zachytávacom kanáli naň nasmerujte zachytávacie pravidlo.

  5. 5

    Odošlite testovaciu správu a sledujte, ako sa konverzácia objaví v paneli.

  6. 6

    Voliteľné: zachovajte poštu počas výpadku pridaním záložnej adresy do príkazu na nasadenie:

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

Email Routing sa stane MX domény, preto použite doménu alebo subdoménu, ktorú nespracúva žiadny iný poštový server.

Prečítať príručku nastavenia →

Nie je viazané na Cloudflare

Worker je jeden zo spôsobov, ako volať /ingress/email. Ktorýkoľvek poštový server alebo relay môže odoslať surovú správu s rovnakými podpísanými hlavičkami a poštový server doručujúci príkazu môže správu odovzdať cez rúru do yuva ingest-email. Formát požiadavky je zdokumentovaný v README Workera.

Otázky a odpovede

Musím prevádzkovať poštový server?

Nie pre prichádzajúcu poštu. Yuva nepočúva na SMTP; poštu prijíma Cloudflare Email Routing a Worker ju odovzdá ďalej. Odpovede potrebujú účet SMTP pre e-mailový kanál, napríklad Amazon SES, Postmark alebo vlastný relay.

Čo sa stane, keď Yuva nefunguje?

Pri nastavenom FALLBACK_FORWARD sa správa presmeruje na túto adresu. Bez neho doručenie zlyhá a odosielajúci server to môže skúsiť znova. Správy, ktoré Yuva odmietne zámerne, napríklad pošta na neznámu adresu, sa odmietnu a nepresmerujú.

Ktoré domény a adresy môžem použiť?

Ľubovoľná doména, ktorú spravujete v Cloudflare a ktorej poštu nespracúva iný server, pretože Email Routing sa stane jej MX. Každý e-mailový kanál má adresu alebo zachytávaciu adresu *@example.com pre všetky adresy domény, ktoré žiadny kanál nemá presne. Subadresa ako support+billing@example.com sa dostane do kanála adresy support@example.com.

Aká veľká môže byť správa?

Správa môže mať vrátane príloh až 25 MiB, čo je limit Cloudflare Email Routing. Yuva uchováva až 50 príloh na správu, každú v rámci limitu veľkosti príloh servera (predvolene 25 MiB) a povolených typov; zvyšok vynechá.

Môže niekto sfalšovať poštu na môj server Yuva?

Yuva odmietne každú požiadavku bez platného podpisu HMAC alebo s časovou pečiatkou, ktorá sa líši o viac ako 5 minút, ešte pred prečítaním tela. Tajomstvo nechajte pre seba.

Používa Yuva výsledok DMARC z Cloudflare?

Áno, keď nastavíte YUVA_INGRESS_AUTHSERV_ID na mx.cloudflare.net. Yuva potom číta verdikt DMARC, ktorý pridáva Email Routing. Nová konverzácia, ktorá v DMARC neprejde, sa označí ako spam.

Cloudflare, logo Cloudflare a Cloudflare Workers sú ochranné známky a/alebo registrované ochranné známky spoločnosti Cloudflare, Inc. v Spojených štátoch a iných jurisdikciách. Yuva je nezávislý open source projekt, nie je s Cloudflare nijako spojený ani ňou schválený.