DeEmailConfiguration » History » Version 11

C S, 2021-11-10 10:16
Notiz zu veralteten async_smtp und async_sendmail Einstellungen seit Redmine 4.0 hinzugefügt (Rev. 55)

1 11 C S
Übersetzung von "Rev. 55":http://www.redmine.org/projects/redmine/wiki/EmailConfiguration/55
2 1 Robert Schneider
3 1 Robert Schneider
{{>toc}}
4 1 Robert Schneider
5 1 Robert Schneider
h1. Email-Konfiguration
6 1 Robert Schneider
7 1 Robert Schneider
h2. Konfigurationsregeln
8 1 Robert Schneider
9 1 Robert Schneider
Diese Seite ist unvollständig. Die folgenden Konfigurationsanweisungen stellen nur ein Ausschnitt dar. Weitere Informationen dazu sind in "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration zu finden.
10 1 Robert Schneider
11 1 Robert Schneider
h3. Authentifizierung
12 1 Robert Schneider
13 9 C S
Die Art der Authentifizierungsmethode, die vom Service-Provider erwartet wird.
14 1 Robert Schneider
15 1 Robert Schneider
Gültige Werte:
16 1 Robert Schneider
17 4 Robert Schneider
* @nil@ (oder das Weglassen des Schlüssels und Wertes): keine Authentifizierung
18 1 Robert Schneider
* @:plain@
19 1 Robert Schneider
* @:login@
20 1 Robert Schneider
* @:cram_md5@
21 1 Robert Schneider
22 9 C S
+Hinweis+: wenn diese Einstellung auf @nil@ gesetzt oder weggelassen wird, können auch die Einstellungen @user_name@ und @password@ vernachlässigt werden.
23 3 Robert Schneider
24 9 C S
h3. Übertragungsmethode
25 1 Robert Schneider
26 1 Robert Schneider
Die zu verwendende Transportmethode für die Emailversand.
27 1 Robert Schneider
28 9 C S
Gültige Werte (=< Redmine v3.x):
29 1 Robert Schneider
30 9 C S
* @:smtp@
31 9 C S
* @:sendmail@
32 9 C S
* @:async_smtp@
33 9 C S
* @:async_sendmail@
34 1 Robert Schneider
35 9 C S
Gültige Werte (>= Redmine v4.x, siehe #30068):
36 9 C S
37 9 C S
* @:smtp@
38 9 C S
* @:sendmail@
39 9 C S
40 1 Robert Schneider
h4. Asynchrone Versandmethoden
41 1 Robert Schneider
42 9 C S
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":http://redmineblog.com/articles/asynchronous-email-delivery/ 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":https://community.bitnami.com/t/updating-an-issue-in-redmine-takes-10-seconds/4421 könnten wohl ein üblicher Wert sein; weitere Informationen dazu auch im Ticket #11376).
43 1 Robert Schneider
44 10 C S
Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel @async_smtp_settings@ statt @smtp-settings@ verwendet:
45 1 Robert Schneider
46 1 Robert Schneider
<pre><code class="yml">
47 1 Robert Schneider
development:
48 1 Robert Schneider
  email_delivery:
49 1 Robert Schneider
    delivery_method: :async_smtp
50 2 Robert Schneider
    async_smtp_settings:           # anstatt smtp_settings:  
51 1 Robert Schneider
      address: "example.com"
52 1 Robert Schneider
      # ...
53 1 Robert Schneider
</code></pre>
54 11 C S
55 11 C S
> *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.
56 11 C S
57 11 C S
58 2 Robert Schneider
59 6 Robert Schneider
h2. configuration.yml-Beispielkonfigurationen
60 2 Robert Schneider
61 5 Robert Schneider
h3. Einfache Authentifizierung (Standardvorgaben)
62 2 Robert Schneider
63 2 Robert Schneider
<pre><code class="yml">
64 2 Robert Schneider
# Outgoing email settings
65 2 Robert Schneider
66 2 Robert Schneider
production:
67 2 Robert Schneider
  email_delivery:
68 2 Robert Schneider
    delivery_method: :smtp
69 2 Robert Schneider
    smtp_settings:
70 2 Robert Schneider
      address: smtp.example.net
71 2 Robert Schneider
      port: 25
72 2 Robert Schneider
      domain: example.net
73 2 Robert Schneider
      authentication: :login
74 1 Robert Schneider
      user_name: redmine@example.net
75 1 Robert Schneider
      password: redmine
76 1 Robert Schneider
77 1 Robert Schneider
development:
78 2 Robert Schneider
  email_delivery:
79 2 Robert Schneider
    delivery_method: :smtp
80 2 Robert Schneider
    smtp_settings:
81 2 Robert Schneider
      address: 127.0.0.1
82 2 Robert Schneider
      port: 25
83 2 Robert Schneider
      domain: example.net
84 1 Robert Schneider
      authentication: :login
85 2 Robert Schneider
      user_name: redmine@example.net
86 2 Robert Schneider
      password: redmine
87 1 Robert Schneider
</code></pre>
88 2 Robert Schneider
89 9 C S
h3. GMail, Google Apps
90 9 C S
91 9 C S
Wenn GMail/Google Apps oder andere SMTP-Server mit aktivem TLS zum Einsatz können, werden weitere Angaben benötigt:
92 9 C S
93 1 Robert Schneider
<pre><code class="yml">
94 1 Robert Schneider
production:
95 1 Robert Schneider
  email_delivery:
96 1 Robert Schneider
    delivery_method: :smtp
97 1 Robert Schneider
    smtp_settings:
98 1 Robert Schneider
      enable_starttls_auto: true
99 1 Robert Schneider
      address: "smtp.gmail.com" 
100 9 C S
      port: 587
101 1 Robert Schneider
      domain: "smtp.gmail.com" 
102 1 Robert Schneider
      authentication: :plain
103 1 Robert Schneider
      user_name: "your_email@gmail.com" 
104 9 C S
      password: "your_password" 
105 1 Robert Schneider
</code></pre>
106 1 Robert Schneider
107 9 C S
Beim Versand über G Suite (ehemals Google Apps) empfiehlt es sich, *SMTP-Relay* zu verwenden, für das die Sendelimits wesentlich höher sind.
108 9 C S
Weitere Informationen und eine ausführliche Anleitung zum Aktivieren des SMTP-Relays finden Sie hier: https://support.google.com/a/answer/2956491
109 9 C S
Verwenden Sie beim Konfigurieren des SMTP-Relay-Dienstes folgendes:
110 9 C S
111 9 C S
* Name: Redmine
112 9 C S
* 1. Erlaubte Absender:
113 9 C S
** Nur registrierte Apps-Benutzer in meinen Domains - falls Sie einen dedizierten G Suite-Benutzer für Redmine erstellt haben
114 9 C S
* 2. Authentifizierung
115 9 C S
** [x] Akzeptieren Sie nur E-Mails von den angegebenen IP-Adressen - IP-Adresse Ihres Redmine-Servers
116 9 C S
** [x] SMTP-Authentifizierung erforderlich
117 9 C S
* 3. Verschlüsselung
118 9 C S
** [x] TLS-Verschlüsselung erforderlich
119 9 C S
120 9 C S
Und die Konfiguration kann sehr einfach sein:
121 9 C S
122 9 C S
<pre><code class="yml">
123 9 C S
production:
124 9 C S
  email_delivery:
125 9 C S
    delivery_method: :smtp
126 9 C S
    smtp_settings:
127 9 C S
      address: smtp-relay.gmail.com
128 9 C S
      port: 587
129 9 C S
      domain: smtp-relay.gmail.com
130 9 C S
      authentication: :plain
131 9 C S
      user_name: your_email@gmail.com
132 9 C S
      password: your_password
133 9 C S
</code></pre>
134 9 C S
135 9 C S
h3. Office 365, Exchange Online
136 9 C S
137 2 Robert Schneider
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:
138 2 Robert Schneider
139 2 Robert Schneider
<pre><code class="yml">
140 2 Robert Schneider
production:
141 2 Robert Schneider
  email_delivery:
142 2 Robert Schneider
    delivery_method: :smtp
143 2 Robert Schneider
    smtp_settings:
144 2 Robert Schneider
      enable_starttls_auto: true
145 9 C S
      address: "smtp.office365.com"
146 9 C S
      port: 587
147 9 C S
      domain: "your_domain.com"
148 2 Robert Schneider
      authentication: :login
149 9 C S
      user_name: "email@your_domain.com"
150 9 C S
      password: "password"
151 2 Robert Schneider
</code></pre>
152 2 Robert Schneider
153 2 Robert Schneider
h3. Ohne Authentifizierung
154 2 Robert Schneider
155 9 C S
Beispiel für ein SMTP-Serviceanbieter ohne Authentifizierung.
156 2 Robert Schneider
157 2 Robert Schneider
<pre><code class="yml">
158 2 Robert Schneider
production:
159 2 Robert Schneider
  email_delivery:
160 1 Robert Schneider
    delivery_method: :smtp
161 1 Robert Schneider
    smtp_settings:
162 1 Robert Schneider
      address: smtp.knology.net
163 1 Robert Schneider
      port: 25
164 1 Robert Schneider
      domain: cybersprocket.com
165 1 Robert Schneider
</code></pre>
166 2 Robert Schneider
167 1 Robert Schneider
h3. Verwendung von sendmail
168 1 Robert Schneider
169 2 Robert Schneider
Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet.
170 2 Robert Schneider
171 2 Robert Schneider
<pre><code class="yml">
172 2 Robert Schneider
production:
173 2 Robert Schneider
  email_delivery:
174 2 Robert Schneider
    delivery_method: :sendmail
175 2 Robert Schneider
</code></pre>
176 2 Robert Schneider
177 9 C S
h2. Fehlerbehebung
178 2 Robert Schneider
179 1 Robert Schneider
h3. Error: "hostname was not match with the server certificate"
180 1 Robert Schneider
181 7 Robert Schneider
Wenn dieser Fehler auftritt, dann gibt es vermutlich ein Problem mit dem SSL-Zertifikat des SMTP-Relays. Vorübergehend kann diese Einstellung im Abschnitt @email_delivery@ gesetzt werden:
182 7 Robert Schneider
183 7 Robert Schneider
<pre><code class="yml">
184 7 Robert Schneider
enable_starttls_auto: false
185 7 Robert Schneider
</code></pre>
186 7 Robert Schneider
187 9 C S
Wenn Sie @starttls@ aktivieren müssen und nur die Zertifikatsüberprüfung umgehen möchten, können Sie im entsprechenden Abschnitt "email_delivery" die folgende Option hinzufügen:
188 9 C S
189 9 C S
<pre><code class="yml">
190 9 C S
openssl_verify_mode: "NONE"
191 9 C S
</code></pre>
192 9 C S
193 7 Robert Schneider
h3. Error: "Mail failure - no recipient addresses"
194 8 Robert Schneider
195 9 C S
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.
196 8 Robert Schneider
197 9 C S
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 müssen wir @exim4@ so konfigurieren, dass die Zieladresse von der Befehlszeile abgerufen wird.
198 8 Robert Schneider
199 8 Robert Schneider
Die Lösung besteht darin, dass @config/configuration.yml@ dahingehend angepasst wird, dass die Einstellung @arguments@ mit dem Wert @"-i"@ enthalten ist: 
200 7 Robert Schneider
201 7 Robert Schneider
<pre><code class="yml">
202 7 Robert Schneider
# default configuration options for all environments
203 7 Robert Schneider
default:
204 7 Robert Schneider
  email_delivery:    
205 7 Robert Schneider
    delivery_method: :sendmail
206 7 Robert Schneider
    sendmail_settings:
207 7 Robert Schneider
      arguments: "-i" 
208 8 Robert Schneider
</code></pre>
209 8 Robert Schneider
210 9 C S
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.
211 7 Robert Schneider
212 7 Robert Schneider
h3. Error: "Timeout:Error" due to SSL SMTP server connection
213 7 Robert Schneider
214 7 Robert Schneider
Hier muss eine SSL-Einstellung zur Konfiguration in @configuration.yml@ hinzugefügt werden (#17239).
215 7 Robert Schneider
216 7 Robert Schneider
<pre><code class="yml">
217 7 Robert Schneider
default:
218 7 Robert Schneider
  # Outgoing emails configuration (see examples above)
219 7 Robert Schneider
  email_delivery:
220 7 Robert Schneider
    delivery_method: :smtp
221 7 Robert Schneider
  smtp_settings:
222 7 Robert Schneider
    address: smtp.domain.com
223 7 Robert Schneider
    port: 465
224 7 Robert Schneider
    ssl: true
225 7 Robert Schneider
    enable_starttls_auto: true
226 7 Robert Schneider
    domain: domain.com
227 7 Robert Schneider
    authentication: :login
228 7 Robert Schneider
    user_name: redmine@domain.com
229 7 Robert Schneider
    password: xxxx
230 7 Robert Schneider
</code></pre>
231 7 Robert Schneider
232 7 Robert Schneider
h2. Weitere Informationen
233 7 Robert Schneider
234 1 Robert Schneider
"Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration