Konfigurace e-mailových oznámení

Chcete-li, aby Easy Project odesílal oznámení o nových úkolech, aktualizacích úkolů a všech ostatních vybraných událostech, musíte aplikaci připojit k poštovnímu serveru. Nastavení konfigurace e-mailu naleznete v souboru configuration.yml ([kořenový adresář easyproject]/config/configuration.yml). Po provedení jakýchkoli změn v tomto konfiguračním souboru je nutné restartovat aplikační server, aby se změny projevily. Otestujte, zda je vaše konfigurace správná, a to v části Administrace » Nastavení » E-mailová oznámení - Poslat testovací email.

Zde následují ukázkové konfigurace souboru configuration.yml.

Jednoduché ověření přihlášením (výchozí nastavení)

# Nastavení odchozích e-mailů

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.example.net"
      port: '25'
      domain: "example.net"
      authentication: :login
      user_name: "easyproject@example.net"
      password: "easyproject"

development:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "127.0.0.1"
      port: '25'
      domain: example.net
      authentication: :login
      user_name: "easyproject@example.net"
      password: "easyproject"

Pokud chcete používat Gmail/Google Apps a další SMTP servery vyžadující TLS, budete muset přidat některá nastavení související s TLS:

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.gmail.com" 
      port: '587'
      domain: "smtp.gmail.com" 
      authentication: :plain
      user_name: "your_email@gmail.com" 
      password: "your_password"

Zde je příklad pro uživatele Office 365 (Exchange Online). Odesílatel musí mít účet, nebo chcete-li odesílat ze sdílené poštovní schránky, musí mít níže uvedený účet oprávnění k odesílání jako odesílatel, který je definován v nastavení e-mailových oznámení Easy Projectu.

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.office365.com" 
      port: '587'
      domain: "your_domain.com" 
      authentication: :login
      user_name: "email@your_domain.com" 
      password: "password" 

Žádné ověření

Příklad pro poskytovatele služby SMTP bez ověření.

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.knology.net"
      port: '25'
      domain: "cybersprocket.com"

Použití příkazu sendmail

Příklad pro unixový systém, který používá příkaz /usr/sbin/sendmail.

production:
  email_delivery:
    delivery_method: :sendmail

Možnost bypass TLS

Podporuje-li váš SMTP server TLS, ale z nějakého důvodu jej nechcete používat (nastavíte port 25), notifikace nebudou fungovat. Mechanizmy, které zpracují emailové notifikace v tomto případě vynucují použití TLS. Obejít TLS je možné nahrazením řádků

enable_starttls_auto: false
verify_openssl_mode: none

tímto

bypass_tls: true

Umožní to použít port 25. Následně můžete odstranit jiné řádky související s SSL nebo TLS.

Časté problémy a řešení potíží

Problém: E-maily nejsou odesílány

V některých případech se může zdát, že Easy Redmine e-maily odesílá, ale uživatelé je neobdrží. Může to být způsobeno nesprávným nastavením SMTP nebo chybnou konfigurací aplikačního prostředí.

Příklad: perform_deliveries: false

Byl identifikován běžný problém s konfigurací, kdy systémový log obsahoval záznam perform_deliveries: false. To znamená, že i když je odeslání e-mailu spuštěno, samotné doručení je zakázáno. Tento problém často nastává u instalací založených na Dockeru nebo v prostředích, kde nebyly správně aplikovány SMTP nastavení.

Řešení pro Docker prostředí

Aby byly e-mailová oznámení správně doručována, musí být SMTP nastavení výslovně nakonfigurována v souboru s proměnnými prostředí (.env) nebo v souboru docker-compose.yml. Příklad nastavení:

SMTP_ADDRESS=smtp.vasedomena.cz
SMTP_PORT=587
SMTP_DOMAIN=vasedomena.cz
SMTP_USER_NAME=notifications@vasedomena.cz
SMTP_PASSWORD=vasetajneheslo
SMTP_AUTHENTICATION=login
SMTP_ENABLE_STARTTLS_AUTO=true

Po aktualizaci konfigurace:

1. Znovu sestavte Docker kontejnery pomocí docker-compose build.
2. Restartujte kontejnery pomocí docker-compose up -d.
3. Otestujte funkčnost e-mailů z rozhraní aplikace.

Pokud potíže přetrvávají nebo potřebujete pomoc s úpravou nastavení, neváhejte kontaktovat náš tým podpory.

Další doporučení

• Po aplikaci nového nastavení vždy otestujte doručení e-mailu pomocí testovacího uživatele.
• Ujistěte se, že váš SMTP server umožňuje připojení z IP adresy serveru Easy Redmine.
• Zkontrolujte spamové složky nebo e-mailové logy kvůli možným problémům s doručením.