Project

General

Profile

DeEmailConfiguration » History » Version 8

Robert Schneider, 2015-06-17 08:35

1 1 Robert Schneider
Übersetzung von "Rev. 43":http://www.redmine.org/projects/redmine/wiki/EmailConfiguration/43
2
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
Die Einstellungen werden in der Datei @config/configuration.yml@ gesetzt. Hier werden zwei erklärungswürdige Einstellungen beschrieben.
12
13
h3. Authentifizierung
14
15
Die Art der Authentifizierungsmehtode, die vom Service-Provider erwartet wird.
16
17
Gültige Werte:
18
19 4 Robert Schneider
* @nil@ (oder das Weglassen des Schlüssels und Wertes): keine Authentifizierung
20 1 Robert Schneider
* @:plain@
21
* @:login@
22
* @:cram_md5@
23
24 3 Robert Schneider
+Hinweis+: wenn diese Einstellung auf @nil@ gesetzt oder weggelassen wird, so muss die Einstelluneng user_name und password auch weggelassen werden.
25 1 Robert Schneider
26
h3. delivery_method
27
28
Die zu verwendende Transportmethode für die Emailversand.
29
30
Gültige Werte:
31
32
* :smtp
33
* :sendmail
34
* :async_smtp
35
* :async_sendmail
36
37
h4. Asynchrone Versandmethoden
38
39
Mit den Werten @:async_smtp@ und @:async_sendmail@ wird asynchron versendet. Das heißt, dass Redmine nicht wartet 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 könnten wohl ein üblicher Wert sein; weitere Informationen dazu im Ticket #11376).
40
41
Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel @async_smtp_settings@ verwendet:
42
43
<pre><code class="yml">
44
development:
45
  email_delivery:
46
    delivery_method: :async_smtp
47 2 Robert Schneider
    async_smtp_settings:           # anstatt smtp_settings:  
48 1 Robert Schneider
      address: "example.com"
49
      # ...
50 2 Robert Schneider
</code></pre>
51
52 6 Robert Schneider
h2. configuration.yml-Beispielkonfigurationen
53 2 Robert Schneider
54 5 Robert Schneider
h3. Einfache Authentifizierung (Standardvorgaben)
55 2 Robert Schneider
56
<pre><code class="yml">
57
# Outgoing email settings
58
59
production:
60
  email_delivery:
61
    delivery_method: :smtp
62
    smtp_settings:
63
      address: smtp.example.net
64
      port: 25
65
      domain: example.net
66
      authentication: :login
67
      user_name: redmine@example.net
68
      password: redmine
69
70
development:
71
  email_delivery:
72
    delivery_method: :smtp
73
    smtp_settings:
74
      address: 127.0.0.1
75
      port: 25
76
      domain: example.net
77
      authentication: :login
78
      user_name: redmine@example.net
79
      password: redmine
80
</code></pre>
81
*
82
Für GMail/Google Apps oder andere SMTP-Server, die TLS benötigen*, sind einige TLS-bezogene Einstellung hinzuzufügen:
83
84
<pre><code class="yml">
85
production:
86
  email_delivery:
87
    delivery_method: :smtp
88
    smtp_settings:
89
      enable_starttls_auto: true
90
      address: "smtp.gmail.com" 
91
      port: '587'
92
      domain: "smtp.gmail.com" 
93
      authentication: :plain
94
      user_name: "your_email@gmail.com" 
95
      password: "your_password"
96
</code></pre>
97
98
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:
99
100
<pre><code class="yml">
101
production:
102
  email_delivery:
103
    delivery_method: :smtp
104
    smtp_settings:
105
      enable_starttls_auto: true
106
      address: "smtp.office365.com" 
107
      port: '587'
108
      domain: "your_domain.com" 
109
      authentication: :login
110
      user_name: "email@your_domain.com" 
111
      password: "password" 
112
</code></pre>
113
114
Dieses Beispiel wird jedoch nur mit entsprechend aktuellen Ruby- und Rails-Version möglich sein (1.8.7 patchset 2xx, bzw. 2.3.5).
115
(Infos: #5814)
116
117
h3. Ohne Authentifizierung
118
119
Beispiel für ein SMPT-Serviceanbieter ohne Authentifizierung.
120
121
<pre><code class="yml">
122
production:
123
  email_delivery:
124
    delivery_method: :smtp
125
    smtp_settings:
126
      address: smtp.knology.net
127
      port: 25
128
      domain: cybersprocket.com
129
</code></pre>
130
131
h3. Verwendung von sendmail
132
133
Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet.
134
135
<pre><code class="yml">
136
production:
137
  email_delivery:
138
    delivery_method: :sendmail
139 1 Robert Schneider
</code></pre>
140 7 Robert Schneider
141
h2. Troubleshooting
142
143
h3. Error: "hostname was not match with the server certificate"
144
145
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:
146
147
<pre><code class="yml">
148
enable_starttls_auto: false
149
</code></pre>
150
151
h3. Error: "Mail failure - no recipient addresses"
152
153 8 Robert Schneider
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, in welcher in den Headers "From:"-Felder zu sehen sind, jedoch keine "To:"-Felder.
154
155
Dieser Fehler kommt auf Grund dessen, wie _exim4_ standardmäßig konfiguriert ist (@"-i -t"@), bei Debian-System öfters vor. Jene Konfiguration teilt _exim4_ mit, dass die Zieladresse in den Headers der Nachricht enthalten ist. Stattdessen soll aber _exim4_ angewiesen werden, die Zieladdresse von der Kommandozeile zu lesen.
156
157
Die Lösung besteht darin, dass @config/configuration.yml@ dahingehend angepasst wird, dass die Einstellung @arguments@ mit dem Wert @"-i"@ enthalten ist: 
158
159 7 Robert Schneider
<pre><code class="yml">
160
# default configuration options for all environments
161
default:
162
  email_delivery:    
163
    delivery_method: :sendmail
164
    sendmail_settings:
165
      arguments: "-i" 
166
</code></pre>
167 8 Robert Schneider
168
Das obige Beispiel verwendet die Methode @:sendmail@, welche @sendmail_settings@ erfordert. Für den Fall, dass die Methode @:smpt@ oder @:async_smpt@ eingestellt ist, ist @smtp_settings@ zu verwenden.
169 7 Robert Schneider
170
h3. Error: "Timeout:Error" due to SSL SMTP server connection
171
172
Hier muss eine SSL-Einstellung zur Konfiguration in @configuration.yml@ hinzugefügt werden (#17239).
173
174
<pre><code class="yml">
175
default:
176
  # Outgoing emails configuration (see examples above)
177
  email_delivery:
178
    delivery_method: :smtp
179
  smtp_settings:
180
    address: smtp.domain.com
181
    port: 465
182
    ssl: true
183
    enable_starttls_auto: true
184
    domain: domain.com
185
    authentication: :login
186
    user_name: redmine@domain.com
187
    password: xxxx
188
</code></pre>
189
190
h2. Weitere Informationen
191
192
"Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration