Project

General

Profile

DeEmailConfiguration » History » Version 7

Robert Schneider, 2015-06-17 07:39

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
<pre><code class="yml">
154
# default configuration options for all environments
155
default:
156
  email_delivery:    
157
    delivery_method: :sendmail
158
    sendmail_settings:
159
      arguments: "-i" 
160
</code></pre>
161
162
h3. Error: "Timeout:Error" due to SSL SMTP server connection
163
164
Hier muss eine SSL-Einstellung zur Konfiguration in @configuration.yml@ hinzugefügt werden (#17239).
165
166
<pre><code class="yml">
167
default:
168
  # Outgoing emails configuration (see examples above)
169
  email_delivery:
170
    delivery_method: :smtp
171
  smtp_settings:
172
    address: smtp.domain.com
173
    port: 465
174
    ssl: true
175
    enable_starttls_auto: true
176
    domain: domain.com
177
    authentication: :login
178
    user_name: redmine@domain.com
179
    password: xxxx
180
</code></pre>
181
182
h2. Weitere Informationen
183
184
"Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration