Подключение и конфигурирование#

Подключение и конфигурирование окружения#

Подключение и конфигурирование окружения описано в «Руководстве по установке», в разделе «Установка».

Конфигурация параметров сервиса в config map#

В данном разделе будут подробно описаны блоки конфигурации сервиса AE lite. Пример конфигурации см. в разделе Пример конфигурации в Config Map и Deployment

Настройка почтовых серверов#

Соединения с почтовыми серверами конфигурируются в блоке

    configprops:
      mailServers:
        - name: 'EwsServer'
          url: 'https://***.***.***.***:***/ews/exchange.asmx'
          type: 'ews'
        - name: 'ExchangeServer'
          type: 'smtp'
          smtpIsSSL: 'false'
          smtpHost: '***.***.***.***'
          smtpPort: '***'
          imapHost: '***.***.***.***'
          imapPort: '***'      

За данными для конфигурирования соединения с почтовым сервером обращайтесь к дежурным администраторам Exchange

Поддерживаются следующие протоколы:

SMTP
IMAP
EWS

Настройка SMTP#

Для отправки по протоколу SMTP необходимо настроить следующие поля:

Название параметра	Допустимые параметры	Описание
type	„smtp“	Название протокола
smtpIsSSL	boolean	Требуется ли SSL на сервисе при обращении к серверу. False если настроен egress
smtpHost	string	SMTP host почтового сервера
smtpPort	integer	SMTP port почтового сервера
imapHost	string	IMAP host почтового сервера (для функционала сохранения письма в папку «отправленные»)
imapPort	integer	IMAP port почтового сервера (для функционала сохранения письма в папку «отправленные»)

Настройка EWS#

Для отправки по протоколу EWS необходимо настроить следующие поля:

Название параметра	Допустимые параметры	Описание
type	„ews“	Название протокола
url	string	URL до EWS сервера. Пример: `https://hostEws:443/ews/exchange.asmx`

Настройка почтовых ящиков#

Соединения с почтовыми ящиками конфигурируются в блоке

    configprops:
      mailboxes:
        - address: "aelt-1@ae.ru"
          login: "aelt-1"
          password: "SimplePassword!"
          mailServer: ExchangeServer
          isNeedToSaveSent: true
          isDeliveryReceiptNeed: true
        - address: "aelt-ews@ae.ru"
          login: "aelt-ews"
          password: "SimplePassword!"
          mailServer: EwsServer
          isNeedToSaveSent: true
          isDeliveryReceiptNeed: true
          sentFolderName: sent

Описание параметров:

Название параметра	Допустимые параметры	Описание
address	string (в формате Email)	Адрес почтового ящика
mailServer	string	Псевдоним почтового сервера (допускаются только значения из перечня полей `name` блока `mailServers`)
imapHost	string	IMAP host почтового сервера (для функционала сохранения письма в папку «отправленные»)
imapPort	integer	IMAP port почтового сервера (для функционала сохранения письма в папку «отправленные»)
sentFolderName (опционально)	string	Название папки, в которую сохранить отправленное письмо (для функционала сохранения письма в папку «отправленные»). Если поле не задавать, то по умолчанию «Sent»

Настройка данных подключения к почтовым ящикам#

Настройка данных подключения к почтовым ящикам проводится в блоке

  credentials:
    - address: 'smtp@ae.ru'
      login: 'smtp'
      password: 'password'
    - address: 'ews@ae.ru'
      login: 'ews'
      password: 'password'

Описание параметров:

Название параметра	Допустимые параметры	Описание
address	string (в формате Email)	Адрес почтового ящика
login	string	Логин для подключения к почтовому серверу
password	string	Пароль для подключения к почтовому серверу

Настройка переотправки#

Повторная отправка конфигурируется только для EWS протокола в блоке

    configprops:
      resendProps:
        resendCount: 1
        # Ошибки, при получении которых следует выполнять переотправку
        # Список ошибок, возвращаемых EWS Exchange: https://docs.microsoft.com/ru-ru/exchange/client-developer/web-service-reference/responsecode?redirectedfrom=MSDN
        resendErrors:
          - 'ErrorADUnavailable'
          - 'ErrorADOperation'
          - 'ErrorInternalServerTransientError'

resendCount - количество попыток отправки, resendErrors - массив ошибок, при возникновении которых будет использоваться переотправка

Настройка вложений#

Отправка с вложениями конфигурируется в блоке

    configprops:
      attachmentProps:
        # Максимальный размер файла в Мбайт
        maxFileSize: 35
        # Максимальное число файлов вложений
        maxCount: 10
        # Список запрещенных расширений вложений
        blacklist:
          - 'ade'
          - 'adp'
          - 'apk'
          - 'app'

Blacklist можно дополнить другими расширениями (указывать без .)

Настройка Hot Reload (обновление конфигурации без перезапуска Pod)#

Hot Reload конфигурируется в блоке

reload:
  enabled: true
  # Таймаут обновления в мс
  reloadTimeout: 10000