DeEmailConfiguration » History » Version 10

C S, 2021-01-18 14:19
1 Fehler korrigiert

1 9 C S
Übersetzung von "Rev. 54":http://www.redmine.org/projects/redmine/wiki/EmailConfiguration/54
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 2 Robert Schneider
</code></pre>
54 2 Robert Schneider
55 6 Robert Schneider
h2. configuration.yml-Beispielkonfigurationen
56 2 Robert Schneider
57 5 Robert Schneider
h3. Einfache Authentifizierung (Standardvorgaben)
58 2 Robert Schneider
59 2 Robert Schneider
<pre><code class="yml">
60 2 Robert Schneider
# Outgoing email settings
61 2 Robert Schneider
62 2 Robert Schneider
production:
63 2 Robert Schneider
  email_delivery:
64 2 Robert Schneider
    delivery_method: :smtp
65 2 Robert Schneider
    smtp_settings:
66 2 Robert Schneider
      address: smtp.example.net
67 2 Robert Schneider
      port: 25
68 2 Robert Schneider
      domain: example.net
69 2 Robert Schneider
      authentication: :login
70 1 Robert Schneider
      user_name: redmine@example.net
71 1 Robert Schneider
      password: redmine
72 1 Robert Schneider
73 1 Robert Schneider
development:
74 2 Robert Schneider
  email_delivery:
75 2 Robert Schneider
    delivery_method: :smtp
76 2 Robert Schneider
    smtp_settings:
77 2 Robert Schneider
      address: 127.0.0.1
78 2 Robert Schneider
      port: 25
79 2 Robert Schneider
      domain: example.net
80 1 Robert Schneider
      authentication: :login
81 2 Robert Schneider
      user_name: redmine@example.net
82 2 Robert Schneider
      password: redmine
83 1 Robert Schneider
</code></pre>
84 2 Robert Schneider
85 9 C S
h3. GMail, Google Apps
86 9 C S
87 9 C S
Wenn GMail/Google Apps oder andere SMTP-Server mit aktivem TLS zum Einsatz können, werden weitere Angaben benötigt:
88 9 C S
89 1 Robert Schneider
<pre><code class="yml">
90 1 Robert Schneider
production:
91 1 Robert Schneider
  email_delivery:
92 1 Robert Schneider
    delivery_method: :smtp
93 1 Robert Schneider
    smtp_settings:
94 1 Robert Schneider
      enable_starttls_auto: true
95 1 Robert Schneider
      address: "smtp.gmail.com" 
96 9 C S
      port: 587
97 1 Robert Schneider
      domain: "smtp.gmail.com" 
98 1 Robert Schneider
      authentication: :plain
99 1 Robert Schneider
      user_name: "your_email@gmail.com" 
100 9 C S
      password: "your_password" 
101 1 Robert Schneider
</code></pre>
102 1 Robert Schneider
103 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.
104 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
105 9 C S
Verwenden Sie beim Konfigurieren des SMTP-Relay-Dienstes folgendes:
106 9 C S
107 9 C S
* Name: Redmine
108 9 C S
* 1. Erlaubte Absender:
109 9 C S
** Nur registrierte Apps-Benutzer in meinen Domains - falls Sie einen dedizierten G Suite-Benutzer für Redmine erstellt haben
110 9 C S
* 2. Authentifizierung
111 9 C S
** [x] Akzeptieren Sie nur E-Mails von den angegebenen IP-Adressen - IP-Adresse Ihres Redmine-Servers
112 9 C S
** [x] SMTP-Authentifizierung erforderlich
113 9 C S
* 3. Verschlüsselung
114 9 C S
** [x] TLS-Verschlüsselung erforderlich
115 9 C S
116 9 C S
Und die Konfiguration kann sehr einfach sein:
117 9 C S
118 9 C S
<pre><code class="yml">
119 9 C S
production:
120 9 C S
  email_delivery:
121 9 C S
    delivery_method: :smtp
122 9 C S
    smtp_settings:
123 9 C S
      address: smtp-relay.gmail.com
124 9 C S
      port: 587
125 9 C S
      domain: smtp-relay.gmail.com
126 9 C S
      authentication: :plain
127 9 C S
      user_name: your_email@gmail.com
128 9 C S
      password: your_password
129 9 C S
</code></pre>
130 9 C S
131 9 C S
h3. Office 365, Exchange Online
132 9 C S
133 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:
134 2 Robert Schneider
135 2 Robert Schneider
<pre><code class="yml">
136 2 Robert Schneider
production:
137 2 Robert Schneider
  email_delivery:
138 2 Robert Schneider
    delivery_method: :smtp
139 2 Robert Schneider
    smtp_settings:
140 2 Robert Schneider
      enable_starttls_auto: true
141 9 C S
      address: "smtp.office365.com"
142 9 C S
      port: 587
143 9 C S
      domain: "your_domain.com"
144 2 Robert Schneider
      authentication: :login
145 9 C S
      user_name: "email@your_domain.com"
146 9 C S
      password: "password"
147 2 Robert Schneider
</code></pre>
148 2 Robert Schneider
149 2 Robert Schneider
h3. Ohne Authentifizierung
150 2 Robert Schneider
151 9 C S
Beispiel für ein SMTP-Serviceanbieter ohne Authentifizierung.
152 2 Robert Schneider
153 2 Robert Schneider
<pre><code class="yml">
154 2 Robert Schneider
production:
155 2 Robert Schneider
  email_delivery:
156 1 Robert Schneider
    delivery_method: :smtp
157 1 Robert Schneider
    smtp_settings:
158 1 Robert Schneider
      address: smtp.knology.net
159 1 Robert Schneider
      port: 25
160 1 Robert Schneider
      domain: cybersprocket.com
161 1 Robert Schneider
</code></pre>
162 2 Robert Schneider
163 1 Robert Schneider
h3. Verwendung von sendmail
164 1 Robert Schneider
165 2 Robert Schneider
Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet.
166 2 Robert Schneider
167 2 Robert Schneider
<pre><code class="yml">
168 2 Robert Schneider
production:
169 2 Robert Schneider
  email_delivery:
170 2 Robert Schneider
    delivery_method: :sendmail
171 2 Robert Schneider
</code></pre>
172 2 Robert Schneider
173 9 C S
h2. Fehlerbehebung
174 2 Robert Schneider
175 1 Robert Schneider
h3. Error: "hostname was not match with the server certificate"
176 1 Robert Schneider
177 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:
178 7 Robert Schneider
179 7 Robert Schneider
<pre><code class="yml">
180 7 Robert Schneider
enable_starttls_auto: false
181 7 Robert Schneider
</code></pre>
182 7 Robert Schneider
183 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:
184 9 C S
185 9 C S
<pre><code class="yml">
186 9 C S
openssl_verify_mode: "NONE"
187 9 C S
</code></pre>
188 9 C S
189 7 Robert Schneider
h3. Error: "Mail failure - no recipient addresses"
190 8 Robert Schneider
191 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.
192 8 Robert Schneider
193 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.
194 8 Robert Schneider
195 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: 
196 7 Robert Schneider
197 7 Robert Schneider
<pre><code class="yml">
198 7 Robert Schneider
# default configuration options for all environments
199 7 Robert Schneider
default:
200 7 Robert Schneider
  email_delivery:    
201 7 Robert Schneider
    delivery_method: :sendmail
202 7 Robert Schneider
    sendmail_settings:
203 7 Robert Schneider
      arguments: "-i" 
204 8 Robert Schneider
</code></pre>
205 8 Robert Schneider
206 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.
207 7 Robert Schneider
208 7 Robert Schneider
h3. Error: "Timeout:Error" due to SSL SMTP server connection
209 7 Robert Schneider
210 7 Robert Schneider
Hier muss eine SSL-Einstellung zur Konfiguration in @configuration.yml@ hinzugefügt werden (#17239).
211 7 Robert Schneider
212 7 Robert Schneider
<pre><code class="yml">
213 7 Robert Schneider
default:
214 7 Robert Schneider
  # Outgoing emails configuration (see examples above)
215 7 Robert Schneider
  email_delivery:
216 7 Robert Schneider
    delivery_method: :smtp
217 7 Robert Schneider
  smtp_settings:
218 7 Robert Schneider
    address: smtp.domain.com
219 7 Robert Schneider
    port: 465
220 7 Robert Schneider
    ssl: true
221 7 Robert Schneider
    enable_starttls_auto: true
222 7 Robert Schneider
    domain: domain.com
223 7 Robert Schneider
    authentication: :login
224 7 Robert Schneider
    user_name: redmine@domain.com
225 7 Robert Schneider
    password: xxxx
226 7 Robert Schneider
</code></pre>
227 7 Robert Schneider
228 7 Robert Schneider
h2. Weitere Informationen
229 7 Robert Schneider
230 1 Robert Schneider
"Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration