Project

General

Profile

DeEmailConfiguration » History » Version 9

C S, 2021-01-18 14:11
Aktualisierung auf originale Rev. 54

1 9 C S
Übersetzung von "Rev. 54":http://www.redmine.org/projects/redmine/wiki/EmailConfiguration/54
2 1 Robert Schneider
3
{{>toc}}
4
5
h1. Email-Konfiguration
6
7
h2. Konfigurationsregeln
8
9
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
11
h3. Authentifizierung
12
13 9 C S
Die Art der Authentifizierungsmethode, die vom Service-Provider erwartet wird.
14 1 Robert Schneider
15
Gültige Werte:
16
17 4 Robert Schneider
* @nil@ (oder das Weglassen des Schlüssels und Wertes): keine Authentifizierung
18 1 Robert Schneider
* @:plain@
19
* @:login@
20
* @:cram_md5@
21
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
Die zu verwendende Transportmethode für die Emailversand.
27
28 9 C S
Gültige Werte (=< Redmine v3.x):
29 1 Robert Schneider
30 9 C S
* @:smtp@
31
* @:sendmail@
32
* @:async_smtp@
33
* @:async_sendmail@
34 1 Robert Schneider
35 9 C S
Gültige Werte (>= Redmine v4.x, siehe #30068):
36
37
* @:smtp@
38
* @:sendmail@
39
40 1 Robert Schneider
h4. Asynchrone Versandmethoden
41
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 9 C S
Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel @async_smtp_settings@ statt @smt-settings@ verwendet:
45 1 Robert Schneider
46
<pre><code class="yml">
47
development:
48
  email_delivery:
49
    delivery_method: :async_smtp
50 2 Robert Schneider
    async_smtp_settings:           # anstatt smtp_settings:  
51 1 Robert Schneider
      address: "example.com"
52
      # ...
53 2 Robert Schneider
</code></pre>
54
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
<pre><code class="yml">
60
# Outgoing email settings
61
62
production:
63
  email_delivery:
64
    delivery_method: :smtp
65
    smtp_settings:
66
      address: smtp.example.net
67
      port: 25
68
      domain: example.net
69
      authentication: :login
70 1 Robert Schneider
      user_name: redmine@example.net
71
      password: redmine
72
73
development:
74 2 Robert Schneider
  email_delivery:
75
    delivery_method: :smtp
76
    smtp_settings:
77
      address: 127.0.0.1
78
      port: 25
79
      domain: example.net
80 1 Robert Schneider
      authentication: :login
81 2 Robert Schneider
      user_name: redmine@example.net
82
      password: redmine
83 1 Robert Schneider
</code></pre>
84 2 Robert Schneider
85 9 C S
h3. GMail, Google Apps
86
87
Wenn GMail/Google Apps oder andere SMTP-Server mit aktivem TLS zum Einsatz können, werden weitere Angaben benötigt:
88
89 1 Robert Schneider
<pre><code class="yml">
90
production:
91
  email_delivery:
92
    delivery_method: :smtp
93
    smtp_settings:
94
      enable_starttls_auto: true
95
      address: "smtp.gmail.com" 
96 9 C S
      port: 587
97 1 Robert Schneider
      domain: "smtp.gmail.com" 
98
      authentication: :plain
99
      user_name: "your_email@gmail.com" 
100 9 C S
      password: "your_password" 
101 1 Robert Schneider
</code></pre>
102
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
Weitere Informationen und eine ausführliche Anleitung zum Aktivieren des SMTP-Relays finden Sie hier: https://support.google.com/a/answer/2956491
105
Verwenden Sie beim Konfigurieren des SMTP-Relay-Dienstes folgendes:
106
107
* Name: Redmine
108
* 1. Erlaubte Absender:
109
** Nur registrierte Apps-Benutzer in meinen Domains - falls Sie einen dedizierten G Suite-Benutzer für Redmine erstellt haben
110
* 2. Authentifizierung
111
** [x] Akzeptieren Sie nur E-Mails von den angegebenen IP-Adressen - IP-Adresse Ihres Redmine-Servers
112
** [x] SMTP-Authentifizierung erforderlich
113
* 3. Verschlüsselung
114
** [x] TLS-Verschlüsselung erforderlich
115
116
Und die Konfiguration kann sehr einfach sein:
117
118
<pre><code class="yml">
119
production:
120
  email_delivery:
121
    delivery_method: :smtp
122
    smtp_settings:
123
      address: smtp-relay.gmail.com
124
      port: 587
125
      domain: smtp-relay.gmail.com
126
      authentication: :plain
127
      user_name: your_email@gmail.com
128
      password: your_password
129
</code></pre>
130
131
h3. Office 365, Exchange Online
132
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
135
<pre><code class="yml">
136
production:
137
  email_delivery:
138
    delivery_method: :smtp
139
    smtp_settings:
140
      enable_starttls_auto: true
141 9 C S
      address: "smtp.office365.com"
142
      port: 587
143
      domain: "your_domain.com"
144 2 Robert Schneider
      authentication: :login
145 9 C S
      user_name: "email@your_domain.com"
146
      password: "password"
147 2 Robert Schneider
</code></pre>
148
149
h3. Ohne Authentifizierung
150
151 9 C S
Beispiel für ein SMTP-Serviceanbieter ohne Authentifizierung.
152 2 Robert Schneider
153
<pre><code class="yml">
154
production:
155
  email_delivery:
156 1 Robert Schneider
    delivery_method: :smtp
157
    smtp_settings:
158
      address: smtp.knology.net
159
      port: 25
160
      domain: cybersprocket.com
161
</code></pre>
162 2 Robert Schneider
163 1 Robert Schneider
h3. Verwendung von sendmail
164
165 2 Robert Schneider
Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet.
166
167
<pre><code class="yml">
168
production:
169
  email_delivery:
170
    delivery_method: :sendmail
171
</code></pre>
172
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
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
179
<pre><code class="yml">
180
enable_starttls_auto: false
181
</code></pre>
182
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
185
<pre><code class="yml">
186
openssl_verify_mode: "NONE"
187
</code></pre>
188
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
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
<pre><code class="yml">
198
# default configuration options for all environments
199
default:
200
  email_delivery:    
201
    delivery_method: :sendmail
202
    sendmail_settings:
203
      arguments: "-i" 
204 8 Robert Schneider
</code></pre>
205
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
h3. Error: "Timeout:Error" due to SSL SMTP server connection
209
210
Hier muss eine SSL-Einstellung zur Konfiguration in @configuration.yml@ hinzugefügt werden (#17239).
211
212
<pre><code class="yml">
213
default:
214
  # Outgoing emails configuration (see examples above)
215
  email_delivery:
216
    delivery_method: :smtp
217
  smtp_settings:
218
    address: smtp.domain.com
219
    port: 465
220
    ssl: true
221
    enable_starttls_auto: true
222
    domain: domain.com
223
    authentication: :login
224
    user_name: redmine@domain.com
225
    password: xxxx
226
</code></pre>
227
228
h2. Weitere Informationen
229
230 1 Robert Schneider
"Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration