Настройка электронной почты для получения уведомлений

Настройка SMTP для предприятия

1. В учетной записи администратора GitHub Enterprise Server в правом верхнем углу любой страницы щелкните .
2. Если вы еще не на странице "Администратор сайта", в левом верхнем углу щелкните Администратор сайта. 1. На боковой панели Администратор сайта щелкните Консоль управления.
3. На боковой панели "Параметры" щелкните Email.
4. Установите флажок Включить электронную почту. Это позволит включить как исходящие, так и входящие сообщения электронной почты. Однако для работы входящей электронной почты необходимо также настроить параметры DNS, как описано ниже в разделе Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты.
5. Введите параметры для вашего SMTP-сервера.
   • В поле Адрес сервера введите адрес SMTP-сервера.
   • В поле Порт введите порт, используемый SMTP-сервером для отправки электронной почты.
   • В поле Домен введите доменное имя, которое SMTP-сервер будет отправлять с ответом HELO, если таковой имеется.
   • Щелкните раскрывающийся список Проверка подлинности и выберите в нем тип шифрования, используемый SMTP-сервером.
   • В поле Адрес электронной почты для автоматической рассылки введите адрес электронной почты, который будет использоваться в полях "От" и "Кому" для всех уведомлений.
6. Если вы хотите отменить все входящие сообщения электронной почты, поступающие на адрес для автоматической рассылки, установите флажок Отменить сообщения на адрес электронной почты для автоматической рассылки.
7. В разделе Поддержка выберите тип ссылки для предоставления дополнительной поддержки пользователям.
   • Электронная почта: внутренний адрес электронной почты.
   • URL-адрес: ссылка на внутренний сайт поддержки. Вы должны включить http:// или https://.
8. Проверьте доставку по электронной почте.

Проверка доставки по электронной почте

1. В верхней части раздела Электронная почта щелкните Проверить параметры электронной почты.

2. В разделе "Отправить тестовое сообщение электронной почты" введите адрес для отправки тестового сообщения электронной почты.

3. Нажмите Отправить тестовое сообщение.

   Совет. Если при отправке тестового сообщения электронной почты возникают ошибки SMTP( например, сбой немедленной доставки или ошибка конфигурации исходящей почты), вы увидите их в диалоговом окне "Проверка параметров электронной почты".

4. Если проверка электронной почты завершается неудачно, исправьте параметры электронной почты.

5. После успешного выполнения тестового сообщения электронной почты на боковой панели "Параметры" нажмите кнопку Сохранить параметры.

6. Подождите завершения запуска конфигурации.

Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты

Если вы хотите разрешить ответы на уведомления по электронной почте, необходимо настроить параметры DNS.

1. Убедитесь, что порт 25 в экземпляре доступен для вашего SMTP-сервера.
2. Создайте запись A, указывающую на reply.[hostname]. В некоторых конфигурациях поставщика DNS и узла экземпляра можно вместо этого создать одну запись A, указывающую на *.[hostname].
3. Создайте запись MX, указывающую на reply.[hostname], чтобы сообщения электронной почты для данного домена перенаправлялись в этот экземпляр.
4. Создайте запись MX, указывающую noreply.[hostname] на [hostname], чтобы ответы на адрес cc в сообщениях с уведомлениями перенаправлялись в этот экземпляр. Дополнительные сведения см. в разделе Настройка уведомлений.

Устранение неполадок доставки электронной почты

Создание пакета поддержки

Если вы не можете определить проблему из отображаемого сообщения об ошибке, можно скачать Пакет поддержки, содержащий все SMTP-взаимодействие между вашим почтовым сервером и GitHub Enterprise Server. Скачав и извлекив пакет, проверка записи в enterprise-manage-logs/unicorn.log для всего журнала бесед SMTP и всех связанных ошибок.

В журнале unicorn должна отображаться транзакция, аналогичная следующей:

This is a test email generated from https://10.0.0.68/setup/settings
Connection opened: smtp.yourdomain.com:587
-> "220 smtp.yourdomain.com ESMTP nt3sm2942435pbc.14\r\n"
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-STARTTLS\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "STARTTLS\r\n"
-> "220 2.0.0 Ready to start TLS\r\n"
TLS connection started
<- "EHLO yourdomain.com\r\n"
-> "250-smtp.yourdomain.com at your service, [1.2.3.4]\r\n"
-> "250-SIZE 35882577\r\n"
-> "250-8BITMIME\r\n"
-> "250-AUTH LOGIN PLAIN XOAUTH\r\n"
-> "250-ENHANCEDSTATUSCODES\r\n"
-> "250 PIPELINING\r\n"
<- "AUTH LOGIN\r\n"
-> "334 VXNlcm5hbWU6\r\n"
<- "dGhpc2lzbXlAYWRkcmVzcy5jb20=\r\n"
-> "334 UGFzc3dvcmQ6\r\n"
<- "aXRyZWFsbHl3YXM=\r\n"
-> "535-5.7.1 Username and Password not accepted. Learn more at\r\n"
-> "535 5.7.1 http://support.yourdomain.com/smtp/auth-not-accepted nt3sm2942435pbc.14\r\n"

Журнал показывает, что на устройстве произошли следующие события.

• Открыто подключение к SMTP-серверу (Connection opened: smtp.yourdomain.com:587).
• Подключение успешно выполнено и выбрано использование TLS (TLS connection started).
• Выполнен тип login проверки подлинности (<- "AUTH LOGIN\r\n").
• SMTP-сервер отклонил проверку подлинности как недопустимую (-> "535-5.7.1 Username and Password not accepted.).

Проверка журналов экземпляр GitHub Enterprise Server

Если необходимо убедиться, что входящий адрес электронной почты работает, можно просмотреть /var/log/mail.log и /var/log/mail-replies/metroplex.log в своем экземпляре.

/var/log/mail.log проверяет, что сообщения достигают вашего сервера. Ниже приведен пример успешного ответа по электронной почте.

Oct 30 00:47:18 54-171-144-1 postfix/smtpd[13210]: connect from st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: 51DC9163323: client=st11p06mm-asmtp002.mac.com[17.172.124.250]
Oct 30 00:47:19 54-171-144-1 postfix/cleanup[13216]: 51DC9163323: message-id=<b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: from=<tcook@icloud.com>, size=5048, nrcpt=1 (queue active)
Oct 30 00:47:19 54-171-144-1 postfix/virtual[13217]: 51DC9163323: to=<reply+i-1-1801beb4df676a79250d1e61e54ab763822c207d-5@reply.ghe.tjl2.co.ie>, relay=virtual, delay=0.12, delays=0.11/0/0/0, dsn=2.0.0, status=sent (delivered to maildir)
Oct 30 00:47:19 54-171-144-1 postfix/qmgr[17250]: 51DC9163323: removed
Oct 30 00:47:19 54-171-144-1 postfix/smtpd[13210]: disconnect from st11p06mm-asmtp002.mac.com[17.172.124.250]

Обратите внимание, что клиент сначала подключается, затем очередь становится активной. Затем сообщение доставляется, клиент удаляется из очереди, и сеанс отключается.

/var/log/mail-replies/metroplex.log показывает, обрабатываются ли входящие сообщения электронной почты для добавления к проблемам и запросам на вытягивание в качестве ответов. Ниже приведен пример успешного сообщения.

[2014-10-30T00:47:23.306 INFO (5284) #] metroplex: processing <b2b9c260-4aaa-4a93-acbb-0b2ddda68579@me.com>
[2014-10-30T00:47:23.333 DEBUG (5284) #] Matched /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie
[2014-10-30T00:47:23.334 DEBUG (5284) #] Moving /data/user/mail/reply/new/1414630039.Vfc00I12000eM445784.ghe-tjl2-co-ie => /data/user/incoming-mail/success

Вы заметите, что metroplex перехватывает входящее сообщение, обрабатывает его, а затем перемещает файл в /data/user/incoming-mail/success.

Проверка параметров DNS

Для правильной обработки входящих сообщений электронной почты необходимо настроить допустимую запись A (или CNAME), а также запись MX. Дополнительные сведения см. в разделе Настройка параметров DNS и брандмауэра для разрешения входящих сообщений электронной почты.

Проверка параметров брандмауэра или группы безопасности AWS

Если экземпляр GitHub Enterprise Server находится за брандмауэром или обслуживается через группу безопасности AWS, убедитесь, что порт 25 открыт для всех почтовых серверов, отправляющих сообщения электронной почты на reply@reply.[hostname].

Обращение в службу поддержки

Если вам все же не удалось устранить проблему, обратитесь в Поддержка GitHub Enterprise. Вложите в свое сообщение электронной почты выходной файл из http(s)://[hostname]/setup/diagnostics, чтобы помочь нам устранить проблему.