Project

General

Profile

DeEmailConfiguration » History » Revision 3

Revision 2 (Robert Schneider, 2015-06-16 23:48) → Revision 3/12 (Robert Schneider, 2015-06-16 23:49)

Übersetzung von "Rev. 43":http://www.redmine.org/projects/redmine/wiki/EmailConfiguration/43 

 {{>toc}} 

 h1. Email-Konfiguration 

 h2. Konfigurationsregeln 

 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. 

 Die Einstellungen werden in der Datei @config/configuration.yml@ gesetzt. Hier werden zwei erklärungswürdige Einstellungen beschrieben. 

 

 h3. Authentifizierung 

 Die Art der Authentifizierungsmehtode, die vom Service-Provider erwartet wird. 

 Gültige Werte: 

 * @nil@ (oder das Weglassen des Schlüssels): keine Authentifizierung 
 * @:plain@ 
 * @:login@ 
 * @:cram_md5@ 

 +Hinweis+: Hinweis: wenn diese Einstellung auf @nil@ gesetzt oder weggelassen wird, so muss die Einstelluneng user_name und password auch weggelassen werden. 

 

 h3. delivery_method 

 Die zu verwendende Transportmethode für die Emailversand. 

 Gültige Werte: 

 * :smtp 
 * :sendmail 
 * :async_smtp 
 * :async_sendmail 

 h4. Asynchrone Versandmethoden 

 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). 

 Bei dieser Versandmethode wird in der SMTP-Konfiguration der Schlüssel @async_smtp_settings@ verwendet: 

 <pre><code class="yml"> 
 development: 
   email_delivery: 
     delivery_method: :async_smtp 
     async_smtp_settings:             # anstatt smtp_settings:   
       address: "example.com" 
       # ... 
 </code></pre> 

 h2. configuration.yml-Beispiel 

 h3. Einfache Authentifizierung (Standardeinstellungen) 

 <pre><code class="yml"> 
 # Outgoing email settings 

 production: 
   email_delivery: 
     delivery_method: :smtp 
     smtp_settings: 
       address: smtp.example.net 
       port: 25 
       domain: example.net 
       authentication: :login 
       user_name: redmine@example.net 
       password: redmine 

 development: 
   email_delivery: 
     delivery_method: :smtp 
     smtp_settings: 
       address: 127.0.0.1 
       port: 25 
       domain: example.net 
       authentication: :login 
       user_name: redmine@example.net 
       password: redmine 
 </code></pre> 
 * 
 Für GMail/Google Apps oder andere SMTP-Server, die TLS benötigen*, sind einige TLS-bezogene Einstellung hinzuzufügen: 

 <pre><code class="yml"> 
 production: 
   email_delivery: 
     delivery_method: :smtp 
     smtp_settings: 
       enable_starttls_auto: true 
       address: "smtp.gmail.com"  
       port: '587' 
       domain: "smtp.gmail.com"  
       authentication: :plain 
       user_name: "your_email@gmail.com"  
       password: "your_password" 
 </code></pre> 

 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: 

 <pre><code class="yml"> 
 production: 
   email_delivery: 
     delivery_method: :smtp 
     smtp_settings: 
       enable_starttls_auto: true 
       address: "smtp.office365.com"  
       port: '587' 
       domain: "your_domain.com"  
       authentication: :login 
       user_name: "email@your_domain.com"  
       password: "password"  
 </code></pre> 

 Dieses Beispiel wird jedoch nur mit entsprechend aktuellen Ruby- und Rails-Version möglich sein (1.8.7 patchset 2xx, bzw. 2.3.5). 
 (Infos: #5814) 

 h3. Ohne Authentifizierung 

 Beispiel für ein SMPT-Serviceanbieter ohne Authentifizierung. 

 <pre><code class="yml"> 
 production: 
   email_delivery: 
     delivery_method: :smtp 
     smtp_settings: 
       address: smtp.knology.net 
       port: 25 
       domain: cybersprocket.com 
 </code></pre> 

 h3. Verwendung von sendmail 

 Beispiel für ein unixoides System, das @/usr/sbin/sendmail@ verwendet. 

 <pre><code class="yml"> 
 production: 
   email_delivery: 
     delivery_method: :sendmail 
 </code></pre>