SMTP e-mail

Služba zasílání zpráv může odesílat e-mailová oznámení prostřednictvím serveru SMTP.

Použijte SMTP, když organizace již poskytuje poštovní relé nebo když není v nasazení používán e-mail Microsoft 365.

Poznámka

Pokud je nakonfigurován SMTP, služba používá SMTP pro e-mail. Pokud SMTP není nakonfigurováno a je nakonfigurován e-mail Microsoft 365, služba používá Microsoft 365.

Předpoklady

Než nakonfigurujete SMTP, ujistěte se, že:

• organizace poskytuje SMTP server nebo přeposílač pošty
• server LogMan.io se může připojit k SMTP serveru na nakonfigurovaném portu
• je známo požadované SMTP TLS nastavení, buď implicitní TLS nebo STARTTLS
• jsou k dispozici SMTP přihlašovací údaje, pokud server vyžaduje autentizaci
• nakonfigurovaná odesílací adresa je povolena k odesílání přes SMTP server
• je k dispozici řetězec certifikátů CA, pokud SMTP server používá interní certifikační autoritu
• jsou k dispozici údaje o HTTP CONNECT proxy, pokud musí odchozí SMTP provoz procházet proxy serverem

Požadovaná konfigurační pole

Pole	Popis
host	Název hostitele nebo IP adresa SMTP serveru.
port	Port serveru SMTP. Běžné hodnoty jsou 465 pro implicitní TLS a 587 pro STARTTLS.
from	Výchozí e-mailová adresa odesílatele.

Ověřovací pole jsou vyžadována, když SMTP server vyžaduje přihlášení:

Pole	Popis
user	Uživatelské jméno SMTP.
password	Heslo SMTP.

Pole TLS určují, jak služba komunikuje se SMTP serverem:

Pole	Popis
ssl	Nastavte na yes pro implicitní TLS, běžně na portu 465.
starttls	Nastavte na yes pro STARTTLS, běžně na portu 587.
validate_certs	Nastavte na yes pro ověření certifikátu SMTP serveru. Toto se doporučuje pro produkční prostředí.
cert_bundle	Volitelná cesta k CA nebo souboru PEM pro certifikační řetězec pro interní certifikační autority.

Varování

Nepovolujte současně ssl a starttls.

Nepovinná konfigurační pole

Pole	Popis
subject	Výchozí předmět e-mailu používaný, když oznámení neposkytne vlastní.
proxy_host	HTTP CONNECT proxy hostname.
proxy_port	Port proxy serveru HTTP CONNECT.
proxy_user	Nepovinné uživatelské jméno proxy.
proxy_password	Nepovinné heslo proxy.
proxy_connect_timeout	Časový limit připojení proxy v sekundách.

Nastavení proxy je potřeba pouze tehdy, když server LogMan.io musí dosáhnout SMTP serveru prostřednictvím HTTP CONNECT proxy.

Ukázka konfigurace

Upravte soubor model.yaml pro konfiguraci služby asab-iris:

/Site/model.yaml

define:
  type: rc/model

services:
  asab-iris:
    instances:
      - node1
    asab:
      config:
        smtp:
          host: smtp.example.com
          port: 587
          user: "{{SMTP_USER}}"
          password: "{{SMTP_PASSWORD}}"
          from: "noreply@example.com"
          ssl: no
          starttls: yes
          validate_certs: yes
          cert_bundle: ""

Instrukce k nastavení

1. Získejte údaje o SMTP serveru od správce pošty:
2. název hostitele
3. port
4. režim TLS
5. uživatelské jméno a heslo, pokud je vyžadována autentizace
6. adresa odesílatele
7. Potvrďte, že server LogMan.io se může připojit k SMTP serveru.
8. Vyberte režim TLS:
9. použijte ssl: yes a starttls: no pro implicitní TLS na portu 465
10. použijte ssl: no a starttls: yes pro STARTTLS na portu 587
11. Pokud SMTP server používá interní certifikační autoritu, zkopírujte soubor PEM s řetězcem CA do prostředí LogMan.io a nakonfigurujte cert_bundle.
12. Uložte SMTP přihlašovací údaje do Vault nebo do úložiště tajemství nasazení používaného instalací LogMan.io.
13. Aktualizujte /Site/model.yaml.
14. Aplikujte model z Knihovny nebo spusťte příkaz pro aplikaci nasazení používaný instalací.
15. Odeslat testovací e-mailové upozornění.

Ověřte konfiguraci

Konfigurace je připravena, když:

• služba se spouští bez chyb konfigurace SMTP
• testovací e-mail je doručen očekávanému příjemci
• zpráva je odeslána z nakonfigurované adresy from
• validace TLS certifikátu uspěje, pokud je povoleno validate_certs
• přílohy jsou doručeny, pokud oznámení obsahuje přílohy

Běžná nastavení

STARTTLS na portu 587

/Site/model.yaml

services:
  asab-iris:
    asab:
      config:
        smtp:
          host: smtp.example.com
          port: 587
          user: "{{SMTP_USER}}"
          password: "{{SMTP_PASSWORD}}"
          from: "noreply@example.com"
          ssl: no
          starttls: yes
          validate_certs: yes
          cert_bundle: ""

Implicitní TLS na portu 465

/Site/model.yaml

services:
  asab-iris:
    asab:
      config:
        smtp:
          host: mail.internal.example
          port: 465
          user: "{{SMTP_USER}}"
          password: "{{SMTP_PASSWORD}}"
          from: "noreply@example.com"
          ssl: yes
          starttls: no
          validate_certs: yes
          cert_bundle: "/etc/ssl/internal-ca.pem"

SMTP přes HTTP CONNECT proxy

/Site/model.yaml

services:
  asab-iris:
    asab:
      config:
        smtp:
          host: mail.internal.example
          port: 465
          user: "{{SMTP_USER}}"
          password: "{{SMTP_PASSWORD}}"
          from: "noreply@example.com"
          ssl: yes
          starttls: no
          validate_certs: yes
          cert_bundle: "/etc/ssl/internal-ca.pem"
          proxy_host: proxy.example.com
          proxy_port: 3128
          proxy_user: "{{SMTP_PROXY_USER}}"
          proxy_password: "{{SMTP_PROXY_PASSWORD}}"
          proxy_connect_timeout: 10

Šablony e-mailů

E-mailové šablony musí být uloženy v adresáři /Templates/Email/ v Knihovně.

Pro více informací o e-mailových oznámeních a šablonách viz:

• Emailová upozornění
• Vytváření e-mailových šablon