Email входящей почты
Email входящей почты используется в заданиях с триггером «Запуск при получении Email». При настройке триггера можно использовать базовый либо дополнительный адрес:
- Базовый email - задается в настройках тенанта в конфигурационном файле (системным администратором).
- Дополнительные почтовые ящики - указываются в UI в разделе Настройки > Система > Email входящей почты. Права доступа есть только у администратора.
Поддерживаемые протоколы:
- POP3 Протокол для загрузки писем с удалением с сервера
- IMAP Протокол для работы с письмами на сервере
- MS Exchange Протокол для одключения к Microsoft Exchange Server
Как добавить дополнительный адрес
Чтобы добавить дополнительный email, перейдите в раздел Настройки > Система > Email входящей почты.
Нажмите кнопку Добавить Email:
Откроется форма:
Поле Логин заполняется только в том случае, если email и логин для аутентификации в почте не совпадают.
Далее выберите почтовый протокол:
- POP3 (по умолчанию);
- IMAP; С версии 25.5 добавлена поддержка IMAP-триггеров в Lotus Domino.
- MS Exchange - доступен с версии 23.11.
В завершение нажмите Сохранить, чтобы добавить email входящей почты.
POP3
Почтовый протокол POP3 не хранит письма на сервере, а загружает их на определенное устройство: компьютер, ноутбук или смартфон. После чего удаляет электронную почту с сервера. Таким образом, письма на сервере не остаются, и если вдруг письмо по ошибке будет удалено с устройства, скачать его заново не получится. При этом перенесенные письма можно посмотреть в любой момент без доступа к интернету.
Если вы выбрали протокол POP3, потребуется также заполнить поля:
- Pop3 - сервер входящей почты. Например,
pop.yandex.ru
. - Pop3 Port - номер порта, который использует сервер входящей почты.
Стандартные порты:
110
- незашифрованное соединение995
- SSL/TLS шифрование
IMAP
Почтовый протокол IMAP не удаляет письма с сервера, а продолжает их хранить. Таким образом, письма можно прочитать с любого устройства, подключенного к интернету. Поддерживается работа с Lotus Domino (с версии 1.25.5).
Если вы выбрали протокол IMAP, потребуется указать имя сервера Imap и номер его порта.
- Imap Server - сервер входящей почты
- Imap Port - номер порта (по умолчанию
143
или993
для SSL) 143
- незашифрованное соединение993
- SSL/TLS шифрование
При использовании IMAP с Lotus Domino включение опции “Удалять при прочтении” может привести к удалению всех ранее прочитанных писем, а не только новых.
MS Exchange
Протокол MS Exchange необходим для подключения к серверам Microsoft Exchange, а также позволяет использовать зашифрованные веб-соединения по порту 443/TCP для защиты данных.
Если вы выбрали MS Exchange, следом отобразится поле EWSUrl - укажите в нем адрес сервера входящей почты.
Формат адреса EWSUrl:
https://servername/EWS/Exchange.asmx
Пример:
https://ms-exchange.s1.primo1.orch/EWS/Exchange.asmx
Особенности работы на Linux
Если при проверке подключения к Exchange на Linux возникает ошибка
Unauthorized (401), установите пакет gssntlmssp
:
Установка пакета для CentOS:
sudo yum install gssntlmssp
Установка пакета для Astra Linux/Ubuntu:
sudo apt install gss-ntlmssp
После установки перезапустите службу WebApi:
sudo systemctl restart Primo.Orchestrator.WebApi
Дополнительные параметры
- Require Authenticate - определяет, требуется ли аутентификация.
- Use Ssl - определяет, используется ли шифрование с помощью SSL/TLS/STARTTLS.
- Use standart not SSL Port - определяет, используется ли стандартный порт без шифрования. По умолчанию используется - флаг UseSsl при этом игнорируется.
- Удалять полученные письма - определяет, будут ли удаляться письма после получения. По умолчанию не удаляются. Для IMAP письма помечаются как прочитанные.
В завершение нажмите Сохранить, чтобы добавить email входящей почты.
- Проверка подключения (доступно с версии 1.25.7+)
После сохранения настроек в списке адресов появится кнопка Тест для проверки соединения с почтовым сервером.
Особенности проверки:
- Проверка выполняется для уже добавленных email-адресов
- При успешной проверке выводится подтверждение
- При ошибке - подробное сообщение от сервера
- Для MS Exchange проверка требует указания пароля
Результат
В форме создании задания, для которого выбран триггер по email, добавленный адрес отобразится среди значений списка Email.