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 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
Die Einstellungen werden in der Datei @config/configuration.yml@ gesetzt. Hier werden zwei erklärungswürdige Einstellungen beschrieben.
12 1 Robert Schneider
13 1 Robert Schneider
h3. Authentifizierung
14 1 Robert Schneider
15 1 Robert Schneider
Die Art der Authentifizierungsmehtode, die vom Service-Provider erwartet wird.
16 1 Robert Schneider
17 1 Robert Schneider
Gültige Werte:
18 1 Robert Schneider
19 1 Robert Schneider
* @nil@ (oder das Weglassen des Schlüssels): keine Authentifizierung
20 1 Robert Schneider
* @:plain@
21 1 Robert Schneider
* @:login@
22 1 Robert Schneider
* @:cram_md5@
23 1 Robert Schneider
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 1 Robert Schneider
h3. delivery_method
27 1 Robert Schneider
28 1 Robert Schneider
Die zu verwendende Transportmethode für die Emailversand.
29 1 Robert Schneider
30 1 Robert Schneider
Gültige Werte:
31 1 Robert Schneider
32 1 Robert Schneider
* :smtp
33 1 Robert Schneider
* :sendmail
34 1 Robert Schneider
* :async_smtp
35 1 Robert Schneider
* :async_sendmail
36 1 Robert Schneider
37 1 Robert Schneider
h4. Asynchrone Versandmethoden
38 1 Robert Schneider
39 1 Robert Schneider
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 1 Robert Schneider
41 1 Robert Schneider
Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel @async_smtp_settings@ verwendet:
42 1 Robert Schneider
43 1 Robert Schneider
<pre><code class="yml">
44 1 Robert Schneider
development:
45 1 Robert Schneider
  email_delivery:
46 1 Robert Schneider
    delivery_method: :async_smtp
47 2 Robert Schneider
    async_smtp_settings:           # anstatt smtp_settings:  
48 1 Robert Schneider
      address: "example.com"
49 1 Robert Schneider
      # ...
50 2 Robert Schneider
</code></pre>
51 2 Robert Schneider
52 2 Robert Schneider
h2. configuration.yml-Beispiel
53 2 Robert Schneider
54 2 Robert Schneider
h3. Einfache Authentifizierung (Standardeinstellungen)
55 2 Robert Schneider
56 2 Robert Schneider
<pre><code class="yml">
57 2 Robert Schneider
# Outgoing email settings
58 2 Robert Schneider
59 2 Robert Schneider
production:
60 2 Robert Schneider
  email_delivery:
61 2 Robert Schneider
    delivery_method: :smtp
62 2 Robert Schneider
    smtp_settings:
63 2 Robert Schneider
      address: smtp.example.net
64 2 Robert Schneider
      port: 25
65 2 Robert Schneider
      domain: example.net
66 2 Robert Schneider
      authentication: :login
67 2 Robert Schneider
      user_name: redmine@example.net
68 2 Robert Schneider
      password: redmine
69 2 Robert Schneider
70 2 Robert Schneider
development:
71 2 Robert Schneider
  email_delivery:
72 2 Robert Schneider
    delivery_method: :smtp
73 2 Robert Schneider
    smtp_settings:
74 2 Robert Schneider
      address: 127.0.0.1
75 2 Robert Schneider
      port: 25
76 2 Robert Schneider
      domain: example.net
77 2 Robert Schneider
      authentication: :login
78 2 Robert Schneider
      user_name: redmine@example.net
79 2 Robert Schneider
      password: redmine
80 2 Robert Schneider
</code></pre>
81 2 Robert Schneider
*
82 2 Robert Schneider
Für GMail/Google Apps oder andere SMTP-Server, die TLS benötigen*, sind einige TLS-bezogene Einstellung hinzuzufügen:
83 2 Robert Schneider
84 2 Robert Schneider
<pre><code class="yml">
85 2 Robert Schneider
production:
86 2 Robert Schneider
  email_delivery:
87 2 Robert Schneider
    delivery_method: :smtp
88 2 Robert Schneider
    smtp_settings:
89 2 Robert Schneider
      enable_starttls_auto: true
90 2 Robert Schneider
      address: "smtp.gmail.com" 
91 2 Robert Schneider
      port: '587'
92 2 Robert Schneider
      domain: "smtp.gmail.com" 
93 2 Robert Schneider
      authentication: :plain
94 2 Robert Schneider
      user_name: "your_email@gmail.com" 
95 2 Robert Schneider
      password: "your_password"
96 2 Robert Schneider
</code></pre>
97 2 Robert Schneider
98 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:
99 2 Robert Schneider
100 2 Robert Schneider
<pre><code class="yml">
101 2 Robert Schneider
production:
102 2 Robert Schneider
  email_delivery:
103 2 Robert Schneider
    delivery_method: :smtp
104 2 Robert Schneider
    smtp_settings:
105 2 Robert Schneider
      enable_starttls_auto: true
106 2 Robert Schneider
      address: "smtp.office365.com" 
107 2 Robert Schneider
      port: '587'
108 2 Robert Schneider
      domain: "your_domain.com" 
109 2 Robert Schneider
      authentication: :login
110 2 Robert Schneider
      user_name: "email@your_domain.com" 
111 2 Robert Schneider
      password: "password" 
112 2 Robert Schneider
</code></pre>
113 2 Robert Schneider
114 2 Robert Schneider
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 2 Robert Schneider
(Infos: #5814)
116 2 Robert Schneider
117 2 Robert Schneider
h3. Ohne Authentifizierung
118 2 Robert Schneider
119 2 Robert Schneider
Beispiel für ein SMPT-Serviceanbieter ohne Authentifizierung.
120 2 Robert Schneider
121 2 Robert Schneider
<pre><code class="yml">
122 2 Robert Schneider
production:
123 2 Robert Schneider
  email_delivery:
124 2 Robert Schneider
    delivery_method: :smtp
125 2 Robert Schneider
    smtp_settings:
126 2 Robert Schneider
      address: smtp.knology.net
127 2 Robert Schneider
      port: 25
128 2 Robert Schneider
      domain: cybersprocket.com
129 2 Robert Schneider
</code></pre>
130 2 Robert Schneider
131 2 Robert Schneider
h3. Verwendung von sendmail
132 2 Robert Schneider
133 2 Robert Schneider
Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet.
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: :sendmail
139 1 Robert Schneider
</code></pre>