RusEmailConfiguration » History » Version 4

Ruslan Khasanov, 2013-03-16 14:09

1 1 Ruslan Khasanov
[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]]
2 1 Ruslan Khasanov
3 4 Ruslan Khasanov
Оригинал: [[EmailConfiguration|Email configuration v.33]]
4 1 Ruslan Khasanov
5 1 Ruslan Khasanov
h1. Настройка почты
6 2 Ruslan Khasanov
7 4 Ruslan Khasanov
{{>toc}}
8 4 Ruslan Khasanov
9 1 Ruslan Khasanov
h2. Директивы конфигурации
10 1 Ruslan Khasanov
11 3 Denis Savitskiy
Эта страница находится в стадии разработки, следующие директивы являются лишь неполным списком.
12 1 Ruslan Khasanov
13 3 Denis Savitskiy
h3. Аутентификация
14 1 Ruslan Khasanov
15 1 Ruslan Khasanov
Тип метода аутентификации, установленный поставщиком услуг.
16 1 Ruslan Khasanov
17 1 Ruslan Khasanov
Допустимые значения:
18 1 Ruslan Khasanov
* :login
19 1 Ruslan Khasanov
* :none
20 1 Ruslan Khasanov
21 4 Ruslan Khasanov
(Примечание: Если вы установите это значение равным @:none@, вы не должны устанавливать настройки для @user_name@ и @password@)
22 1 Ruslan Khasanov
23 3 Denis Savitskiy
h3. Метод отправки
24 1 Ruslan Khasanov
25 3 Denis Savitskiy
Метод отправки почты, которые будет использоваться.
26 1 Ruslan Khasanov
27 1 Ruslan Khasanov
Допустимые значения:
28 1 Ruslan Khasanov
* :smtp
29 4 Ruslan Khasanov
* :async_smtp
30 1 Ruslan Khasanov
* :sendmail
31 4 Ruslan Khasanov
* :async_sendmail
32 1 Ruslan Khasanov
33 1 Ruslan Khasanov
h3. Асинхронный метод отправки
34 1 Ruslan Khasanov
35 4 Ruslan Khasanov
@:async_smtp@ и @:async_sendmail@ использует асинхронную передачу, это значит, что Redmine не ждет подтверждение отправки электронной почты для отображения следующей страницы. См. "Asynchronous Email Delivery":http://redmineblog.com/articles/asynchronous-email-delivery/. На некоторых SMTP серверах установлен период задержки перед обработкой письма для защиты от спама, в течении которого при синхронном методе отправки Redmine будет блокирован ("10 секунд":http://answers.bitnami.org/questions/4421/updating-an-issue-in-redmine-takes-10-seconds может быть значением по умолчанию, смотри так же #11376 для дополнительной информации) .
36 1 Ruslan Khasanov
37 4 Ruslan Khasanov
Для включения данного метода в настройках smtp необходимо указать ключевое слово @async_smtp_settings@:
38 4 Ruslan Khasanov
39 4 Ruslan Khasanov
<pre>
40 4 Ruslan Khasanov
development:
41 4 Ruslan Khasanov
  email_delivery:
42 4 Ruslan Khasanov
    delivery_method: :async_smtp
43 4 Ruslan Khasanov
    async_smtp_settings:
44 4 Ruslan Khasanov
    ...
45 4 Ruslan Khasanov
</pre>
46 4 Ruslan Khasanov
47 1 Ruslan Khasanov
h2. Пример конфигурации configuration.yml 
48 1 Ruslan Khasanov
49 4 Ruslan Khasanov
h3. Простая конфигурация с авторизацией (настройки по умолчанию)
50 4 Ruslan Khasanov
51 1 Ruslan Khasanov
<pre>
52 1 Ruslan Khasanov
# Outgoing email settings
53 1 Ruslan Khasanov
54 1 Ruslan Khasanov
production:
55 4 Ruslan Khasanov
  email_delivery:
56 4 Ruslan Khasanov
    delivery_method: :smtp
57 4 Ruslan Khasanov
    smtp_settings:
58 4 Ruslan Khasanov
      address: smtp.example.net
59 4 Ruslan Khasanov
      port: 25
60 4 Ruslan Khasanov
      domain: example.net
61 4 Ruslan Khasanov
      authentication: :login
62 4 Ruslan Khasanov
      user_name: redmine@example.net
63 4 Ruslan Khasanov
      password: redmine
64 4 Ruslan Khasanov
  
65 1 Ruslan Khasanov
development:
66 4 Ruslan Khasanov
  email_delivery:
67 4 Ruslan Khasanov
    delivery_method: :smtp
68 4 Ruslan Khasanov
    smtp_settings:
69 4 Ruslan Khasanov
      address: 127.0.0.1
70 4 Ruslan Khasanov
      port: 25
71 4 Ruslan Khasanov
      domain: example.net
72 4 Ruslan Khasanov
      authentication: :login
73 4 Ruslan Khasanov
      user_name: redmine@example.net
74 4 Ruslan Khasanov
      password: redmine
75 1 Ruslan Khasanov
</pre>
76 1 Ruslan Khasanov
77 4 Ruslan Khasanov
*Если вы хотите использовать GMail/Google Apps и другие требующие TLS SMTP-сервера*, вы должны добавить некоторые TLS-параметры:
78 4 Ruslan Khasanov
79 1 Ruslan Khasanov
<pre>
80 1 Ruslan Khasanov
production:
81 4 Ruslan Khasanov
  email_delivery:
82 4 Ruslan Khasanov
    delivery_method: :smtp
83 4 Ruslan Khasanov
    smtp_settings:
84 4 Ruslan Khasanov
      enable_starttls_auto: true
85 4 Ruslan Khasanov
      address: "smtp.gmail.com" 
86 4 Ruslan Khasanov
      port: '587'
87 4 Ruslan Khasanov
      domain: "smtp.gmail.com" 
88 4 Ruslan Khasanov
      authentication: :plain
89 4 Ruslan Khasanov
      user_name: "your_email@gmail.com" 
90 4 Ruslan Khasanov
      password: "your_password" 
91 1 Ruslan Khasanov
</pre>
92 1 Ruslan Khasanov
93 4 Ruslan Khasanov
Однако, это будет работать только в "последней" версии ruby и rails (1.8.7 patchset 2xx and 2.3.5).
94 4 Ruslan Khasanov
(См. #5814 )
95 4 Ruslan Khasanov
96 1 Ruslan Khasanov
h3. Без проверки подлинности
97 1 Ruslan Khasanov
98 1 Ruslan Khasanov
Пример для поставщика службы SMTP без проверки подлинности. Обратите внимание на двоеточие перед none.
99 4 Ruslan Khasanov
100 2 Ruslan Khasanov
<pre>
101 2 Ruslan Khasanov
production:
102 4 Ruslan Khasanov
  email_delivery:
103 4 Ruslan Khasanov
    delivery_method: :smtp
104 4 Ruslan Khasanov
    smtp_settings:
105 4 Ruslan Khasanov
      address: smtp.knology.net
106 4 Ruslan Khasanov
      port: 25
107 4 Ruslan Khasanov
      domain: cybersprocket.com
108 4 Ruslan Khasanov
      authentication: :none
109 1 Ruslan Khasanov
</pre>
110 1 Ruslan Khasanov
111 1 Ruslan Khasanov
h3. Использование команды Sendmail 
112 1 Ruslan Khasanov
113 4 Ruslan Khasanov
Пример для UNIX систем, которые используют команду @/usr/sbin/sendmail@.
114 4 Ruslan Khasanov
115 1 Ruslan Khasanov
<pre>
116 1 Ruslan Khasanov
production:
117 4 Ruslan Khasanov
  email_delivery:
118 4 Ruslan Khasanov
    delivery_method: :sendmail
119 1 Ruslan Khasanov
</pre>
120 1 Ruslan Khasanov
121 1 Ruslan Khasanov
h2. Дополнительные ссылки
122 1 Ruslan Khasanov
123 1 Ruslan Khasanov
* "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration