Übersetzung von Rev. 56

• Table of contents
• Email-Konfiguration
  • Konfigurationsregeln
    • Authentifizierung
    • Übertragungsmethode
      • Asynchrone Versandmethoden
  • configuration.yml-Beispielkonfigurationen
    • Einfache Authentifizierung (Standardvorgaben)
    • GMail, Google Apps
    • Office 365, Exchange Online
    • Ohne Authentifizierung
    • Verwendung von sendmail
  • Fehlerbehebung
    • Error: "hostname was not match with the server certificate"
    • Error: "Mail failure - no recipient addresses"
    • Error: "Timeout:Error" due to SSL SMTP server connection
  • Weitere Informationen

Email-Konfiguration¶

Konfigurationsregeln¶

Diese Seite ist unvollständig. Die folgenden Konfigurationsanweisungen stellen nur ein Ausschnitt dar. Weitere Informationen dazu sind in Action Mailer Configuration zu finden.

Authentifizierung¶

Die Art der Authentifizierungsmethode, die vom Service-Provider erwartet wird.

Gültige Werte:

• nil (oder das Weglassen des Schlüssels und Wertes): keine Authentifizierung
• :plain
• :login
• :cram_md5

Hinweis: wenn diese Einstellung auf nil gesetzt oder weggelassen wird, können auch die Einstellungen user_name und password vernachlässigt werden.

Übertragungsmethode¶

Die zu verwendende Transportmethode für die Emailversand.

Gültige Werte (=< Redmine v3.x):

• :smtp
• :sendmail
• :async_smtp
• :async_sendmail

Gültige Werte (>= Redmine v4.x, siehe #30068):

• :smtp
• :sendmail

Asynchrone Versandmethoden¶

Mit den Werten :async_smtp und :async_sendmail wird asynchron versendet. Das bedeutet, Redmine wartet nicht bis die Email versandt wurde, um die nächste Seite anzuzeigen. Mehr Informationen sind unter Asynchroner Emailversand zu finden. Einige SMTP-Server haben ein Anti-Spam-Feature, das die Verarbeitung der Emails verzügert, so dass bei synchronen Versandmethoden Redmine blockiert wird (10 Sekunden könnten wohl ein üblicher Wert sein; weitere Informationen dazu auch im Ticket #11376).

Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel async_smtp_settings statt smtp-settings verwendet:

development:
  delivery_method: :async_smtp
  async_smtp_settings:           # anstatt smtp_settings:  
    address: "example.com" 
    port: ...

Bitte beachten: Seit Redmine 4.0 wurde der asynchrone E-Mail-Versand zugunsten des Rails ActiveJob-Moduls entfernt, das E-Mails asynchron sendet. Siehe https://www.redmine.org/projects/redmine/repository/entry/tags/4.0.0/lib/redmine/configuration.rb#L53 für weitere Details.

configuration.yml-Beispielkonfigurationen¶

Einfache Authentifizierung (Standardvorgaben)¶

# Outgoing email settings

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.example.net
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

development:
  delivery_method: :smtp
  smtp_settings:
    address: 127.0.0.1
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

GMail, Google Apps¶

Wenn GMail/Google Apps oder andere SMTP-Server mit aktivem TLS zum Einsatz können, werden weitere Angaben benötigt:

production:
  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" 

Beim Versand über G Suite (ehemals Google Apps) empfiehlt es sich, SMTP-Relay zu verwenden, für das die Sendelimits wesentlich höher sind.
Weitere Informationen und eine ausführliche Anleitung zum Aktivieren des SMTP-Relays finden Sie hier: https://support.google.com/a/answer/2956491
Verwenden Sie beim Konfigurieren des SMTP-Relay-Dienstes folgendes:

• Name: Redmine
• 1. Erlaubte Absender:
  • Nur registrierte Apps-Benutzer in meinen Domains - falls Sie einen dedizierten G Suite-Benutzer für Redmine erstellt haben
• 2. Authentifizierung
  • [x] Akzeptieren Sie nur E-Mails von den angegebenen IP-Adressen - IP-Adresse Ihres Redmine-Servers
  • [x] SMTP-Authentifizierung erforderlich
• 3. Verschlüsselung
  • [x] TLS-Verschlüsselung erforderlich

Und die Konfiguration kann sehr einfach sein:

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp-relay.gmail.com
    port: 587
    domain: smtp-relay.gmail.com
    authentication: :plain
    user_name: your_email@gmail.com
    password: your_password

Office 365, Exchange Online¶

Es folgt ein Beispiel für Office 365 (Exchange Online). Der Versender muss ein Konto haben, oder falls der Versand über eine Shared Mailbox (also wenn es kein exklusives Konto für Redmine ist) erfolgen soll, so muss das Konto den hier definierten Benutzer die Berechtigung für den Versand geben:

production:
  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" 

Ohne Authentifizierung¶

Beispiel für ein SMTP-Serviceanbieter ohne Authentifizierung.

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

Verwendung von sendmail¶

Beispiel für ein unixoides System, das /usr/sbin/sendmail verwendet.

production:
  delivery_method: :sendmail

Fehlerbehebung¶

Error: "hostname was not match with the server certificate"¶

Wenn dieser Fehler auftritt, dann gibt es vermutlich ein Problem mit dem SSL-Zertifikat des SMTP-Relays. Vorübergehend kann diese Einstellung im Abschnitt smtp_settings gesetzt werden:

enable_starttls_auto: false

Wenn Sie starttls aktivieren müssen und nur die Zertifikatsüberprüfung umgehen möchten, können Sie im entsprechenden Abschnitt "smtp_settings" die folgende Option hinzufügen:

openssl_verify_mode: "NONE" 

Error: "Mail failure - no recipient addresses"¶

Beim Auftreten dieses Fehlers kann die Nachricht nicht an die Zieladresse gesendet werden. Häufig wird stattdessen eine Nachricht an die Email-Adresse des Absenders gesendet, welcher in den Headers "From:"-Felder zu sehen sind, jedoch keine "To:"-Felder enthalten.

Dieser Fehler tritt häufig bei Debian-Boxen auf, da exim4 standardmäßig konfiguriert ist ( "- i -t" ). Diese Konfiguration teilt exim4 mit, dass sich die Zieladresse im Header der Nachricht befindet. Stattdessen muss exim4 so konfiguriert werden, dass die Zieladresse von der Befehlszeile abgerufen wird.

Die Lösung besteht darin, dass config/configuration.yml dahingehend angepasst wird, dass die Einstellung arguments mit dem Wert "-i" enthalten ist:

# default configuration options for all environments
default:
  delivery_method: :sendmail
  sendmail_settings:
    arguments: "-i" 

Das obige Beispiel verwendet die Methode :sendmail, welche sendmail_settings erfordert. Für den Fall, dass die Methode :smtp oder :async_smtp eingestellt ist, ist smtp_settings zu verwenden.

Error: "Timeout:Error" due to SSL SMTP server connection¶

Hier muss eine SSL-Einstellung zur Konfiguration in configuration.yml hinzugefügt werden (#17239).

default:
  # Outgoing emails configuration (see examples above)
  delivery_method: :smtp
  smtp_settings:
    address: smtp.domain.com
    port: 465
    ssl: true
    enable_starttls_auto: true
    domain: domain.com
    authentication: :login
    user_name: redmine@domain.com
    password: xxxx

Weitere Informationen¶

Action Mailer Configuration