Pošta a notifikace

Jeden mailer na instalaci, který v Settings → Organization → Email nebo z CLI nastavuje ten, kdo drží pravomoc nad nasazením, s tajemstvími jen pro zápis — a klíče, které potřebuje web push.

Kdo ho smí měnit

Mailer posílá každý reset hesla a každý přihlašovací kód na instalaci, takže jde o nastavení pro celé nasazení. Platform admini ho mění přes kteroukoli organizaci, kterou spravují; při nastaveném VITRINKA_OPS_ORG ho přes tu organizaci mění i její admini. Bez nastavení ho drží jen platform admini — běžný admin organizace se nikdy nekvalifikuje, protože organizaci může vlastnit každý účet, který se zaregistruje (první administrátor).

Kdokoli jiný je odmítnut: set nebo test skončí kódem 2, aniž by cokoli změnily. Dokud VITRINKA_OPS_ORG není nastavené, a při nastaveném uvnitř té organizace, uvidí navíc proč a koho požádat — Nastavení ukáže místo formuláře důvod od serveru a status vypíše důvod i nápravu. Když nastavené je, admin jakékoli jiné organizace mailer vůbec neuvidí, stejně jako na hostované službě.

V produktu

Settings → Organization → Email nabízí stejná pole jako set — host, port, šifrování, uživatele, heslo, adresu odesílatele a volitelný balík privátní CA — a k tomu send test email a remove saved settings. Uložená konfigurace má přednost před prostředím SMTP_* / RESEND_API_KEY a platí od dalšího e-mailu.

Nastavení relaye

vitrinka admin smtp set \
  --host smtp.example.com --port 587 --tls starttls \
  --from "vitrinka@example.com" --user mailer --password-stdin

Přepínač	Co dělá
`--host`	Host relaye.
`--port`	Port relaye. Výchozí na serveru 587.
`--tls`	`starttls`, `implicit` nebo `none`.
`--from`	Adresa odesílatele.
`--user`	Uživatel relaye. Prázdná hodnota přepne na anonymní relay.
`--password-stdin`	Načte heslo relaye ze stdin.
`--password`	Heslo jako argument — raději `--password-stdin`.
`--ca`	Cesta k PEM balíku privátní CA.
`--no-ca`	Zahodí uloženou CA a vrátí se k systémovým kořenům.
`--clear`	Smaže uloženou konfiguraci a spadne zpět na `SMTP_*` / `RESEND_API_KEY` z prostředí.

Používejte --password-stdin. Heslo předané jako --password vidí v ps kdokoli další na stroji.

Ověření

status hlásí zdroj, host, režim TLS a adresu odesílatele a jestli je uložené heslo. test pošle testovací e-mail na vaši vlastní adresu.

vitrinka admin smtp status
vitrinka admin smtp test

Bez startu serveru — třeba před prvním spuštěním — pošle vitrinka smtp-test ze serverové binárky jeden testovací e-mail přes relay SMTP_* z vašeho .env:

docker compose run --rm --no-deps vitrinka smtp-test -to you@example.com

Která organizace

Všechny tři podpříkazy jdou přes organizaci, kterou spravujete. --org vybere kterou, když jich váš login má víc; jinak se použije $VITRINKA_ORG, pak organizace navázaného workspace, pak vaše jediné členství. Platform admin smí použít kteroukoli organizaci, kterou spravuje, a admin organizace z VITRINKA_OPS_ORG jde přes tu — když váš login patří do několika, zadejte ji přes --org.

vitrinka admin smtp status --org acme

Push notifikace

Web push dorazí na zařízení člověka i se zavřenou záložkou. Potřebuje pár klíčů VAPID — VAPID_PUBLIC_KEY a VAPID_PRIVATE_KEY, vygenerovaný jednou libovolnou knihovnou pro Web Push — a VAPID_SUBSCRIBER, kontakt mailto:, přes který vás push služby mohou zastihnout: nastavte vlastní adresu, protože výchozí hodnota je jen zástupná. Jakmile jsou klíče na místě, každý si push zapne pro každé zařízení zvlášť v Settings → Preferences → Notifications (notifikace).

AIR_GAP=1 web push vymaže, protože posílá na push služby výrobců prohlížečů. E-mailové notifikace odcházejí přes mailer instalace výše a zůstávají vypnuté, dokud si je každý nezapne.