Project

General

Profile

DeEmailConfiguration » History » Version 3

Robert Schneider, 2015-06-16 23:49

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
* @nil@ (oder das Weglassen des Schlüssels): keine Authentifizierung
20
* @: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
h2. configuration.yml-Beispiel
53
54
h3. Einfache Authentifizierung (Standardeinstellungen)
55
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>