# Интеграция с почтовыми серверами

Сервер **Webim** поддерживает интеграцию с почтовыми серверами для рассылки исходящих Email сообщений (администраторам, операторам и посетителям сайтов клиентов) и приёма входящих (поддержка Email как полноценного канала связи). В этой статье содержится описание SMTP-параметров конфигурационного файла `[hosted-]main.ini` для облачной и локальной сетевой конфигурации, а также описание режимов аутентификации для SMTP, поддерживаемых **Webim**.

!!! Note "N.B."
    Для облачной и локальной конфигурации файл `[hosted-]main.ini` имеет несколько различий в параметрах. В частности, в облачной конфигурации некоторые параметры являются неизменяемыми. Они обозначены звёздочкой (*).

## SMTP-параметры для облачной сетевой конфигурации (cloud mode)

| Параметр               | Описание                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `smtp_server*`         | Имя сервера SMTP, к которому обращается **Webim Server**                                                                                                                                                                                                                                                                                                                         |
| `smtp_username`        | `user@yourdomain.ru` – имя пользователя                                                                                                                                                                                                                                                                                                                                          |
| `smtp_password`        | `your_password` – пароль   пользователя                                                                                                                                                                                                                                                                                                                                          |
| `smtp_port*`           | Порт подключения                                                                                                                                                                                                                                                                                                                                                                 |
| `smtp_encryption`      | `tls`, `ssl` или пустое значение (`""`, `None`) – тип шифрования                                                                                                                                                                                                                                                                                                                 |
| `smtp_from_addr`       | `noreply@address.ru` – адрес, с которого отправляются письма                                                                                                                                                                                                                                                                                                                     |
| `smtp_auth_mode`       | Тип аутентификации. Может быть `login`, `plain`, `cram-md5` или пустое значение (`""`, `None`). При пустом значении способ аутентификации будет определяться автоматически, согласно ответу на EHLO от SMTP сервера.<br>Поддерживаются только **указанные типы** аутентификации; также, для корректной работы **Webim Server** аутентификация почтового сервера **обязательна**. |
| `smtp_skip_ssl_checks` | Игнорирование проверки SSL/TLS сертификатов. Может принимать значение `true` или `false`                                                                                                                                                                                                                                                                                         |
| `local_domain`         | Имя домена,к которому обращается сервер **Webim** для использования в команде EHLO                                                                                                                                                                                                                                                                                               |

## SMTP-параметры для локальной сетевой конфигурации (hosted mode)

| Параметр                     | Описание                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hostedmode_smtp_server`     | `smtp.yourdomain.com` – имя SMTP-сервера, к которому обращается **Webim Server**                                                                                                                                                                                                                                                                                                 |
| `hostedmode_smtp_username`   | `user@yourdomain.ru` – имя пользователя                                                                                                                                                                                                                                                                                                                                          |
| `hostedmode_smtp_password`   | `your_password` – пароль пользователя                                                                                                                                                                                                                                                                                                                                            |
| `hostedmode_smtp_port`       | `25` (могут быть и другие значения) – порт для подключения к SMTP-серверу                                                                                                                                                                                                                                                                                                        |
| `hostedmode_smtp_encryption` | Тип шифрования. Может быть `tls`, `ssl` или пустое значение (`""`, `None`). Устанавливается в зависимости от значения порта.                                                                                                                                                                                                                                                     |
| `hostedmode_smtp_from_addr`  | `noreply@address.ru` – адрес, с которого отправляются письма. Параметр обязателен для заполнения.                                                                                                                                                                                                                                                                                |
| `hostedmode_smtp_auth_mode`  | Тип аутентификации. Может быть `login`, `plain`, `cram-md5` или пустое значение (`""`, `None`). При пустом значении способ аутентификации будет определяться автоматически, согласно ответу на EHLO от SMTP сервера.<br>Поддерживаются только **указанные типы** аутентификации; также, для корректной работы **Webim Server** аутентификация почтового сервера **обязательна**. |

## Описание поддерживаемых типов аутентификации

**Webim Server** поддерживает следующие типы аутентификации для SMTP:

  * `plain`: логин и пароль пользователя отправляются одной строкой

  * `login`: логин и пароль пользователя отправляются по очереди. В `plain` и `login` пароли предварительно передаются в открытом виде

  * `cram-md5`: аутентификация вида "запрос-ответ", основанная на алгоритме `HMAC-MD5` (используется сравнение хэшей)

Часто у клиентов с локальной сетевой конфигурацией (hosted-клиенты) возникает проблема при аутентификации вида: `SMTP AUTH extension not supported by server`. Как правило, она возникает в тех случаях, когда в параметре аутентификации указывают неподдерживаемый тип (например, `ntlm`).

!!! Note "N.B."
    Интеграция **Webim** с почтовым сервером не поддерживает двухфакторную аутентификацию!

---

Источник: https://webim.ru/kb/devops/smtp-integration.html