Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Дополнительные подключения
  6. Настройка почты

Настройка почты

Подключите почтовый сервис, настройте ящик и проверьте отправку и получение через BPMSoft. После этого можно включать уведомления и согласование Документооборота. Для корпоративного домена подойдёт уже действующая почтовая инфраструктура: установка отдельного почтового сервера не является обязательным этапом внедрения.

Подготовьте параметры подключения

Запишите версию BPMSoft, среду .NET и версию сервиса синхронизации. Совместимость поставки Документооборота сверяйте с техническими требованиями. Руководства BPMSoft, на которые ссылается эта статья, относятся к ветке 1.9; параметры отдельной поставки микросервиса сверяйте с её архивом.

Что подготовить Содержание
Почтовый ящик Email, владелец, назначение, разрешённый адрес отправителя; например, workflow@example.org.
Профиль сервера SMTP и IMAP либо Exchange/EWS; имена серверов, порты, TLS и способ аутентификации.
Данные входа Формат логина; пароль приложения или параметры поддерживаемой OAuth-интеграции. Секреты передаются отдельно.
Синхронизация Версия и URL Listener, его обратный адрес BPMSoft, действующие очереди и хранилище состояния.
Ограничения Размер всего письма и вложений, квота, период и папки загрузки, интервал обмена.
Эксплуатация Ответственные за ящик и секреты, срок их действия, порядок замены и проверка после перезапуска.

SMTP передаёт исходящие сообщения; IMAP предоставляет доступ к входящему ящику. Один SMTP relay не обеспечивает получение ответов. EWS — отдельный интерфейс Exchange. Microsoft Graph — другой API, для которого требуется совместимый адаптер. TLS защищает соединение, а Basic или OAuth определяют способ аутентификации; эти настройки выбирают независимо.

Выберите почтовый профиль

Сценарий Что проверить
Корпоративная почта по SMTP/IMAP Оба протокола доступны компоненту, выполняющему обмен; учётной записи разрешены отправка и чтение выбранных папок.
Локальный Microsoft Exchange Профиль Exchange и адрес EWS соответствуют установленному серверу и поддерживаемому способу входа.
Microsoft 365 / Exchange Online Уточнены действующий адаптер, OAuth-приложение и поддерживаемый путь обмена с учётом прекращения EWS.
Яндекс Почта, в том числе корпоративный домен Настроен почтовый провайдер, разрешён доступ внешним приложениям и получены данные для почты. OAuth-настройки Яндекс.Диска для этого не используются.

Наличие OAuth 2.0 в форме не подтверждает подключение любого IMAP/SMTP-провайдера. Для Microsoft 365 нужен поддерживаемый адаптер и зарегистрированное приложение; файловое подключение OneDrive не настраивает почту. Для первого базового сценария используйте согласованный корпоративный SMTP/IMAP-профиль с TLS.

Проверьте сеть и защищённое соединение

Выполняйте проверку из среды реального отправителя или синхронизатора: сервера приложения, Listener и участвующего контейнера. Доступность с рабочего компьютера администратора не подтверждает доступ службы. Общая подготовка DNS и сертификатов описана в статье «Сетевые подключения и закрытый контур».

Направление Типовой порт Защита и назначение
Отправляющий компонент → SMTP 587/TCP STARTTLS: SMTP-соединение переводится в TLS до передачи учётных данных.
Отправляющий компонент → SMTP 465/TCP TLS с момента установления соединения; используется вместо профиля 587, если так настроен сервер.
Синхронизатор → IMAP 993/TCP TLS; получение сообщений.
Синхронизатор → EWS 443/TCP HTTPS; только для выбранного профиля Exchange.
BPMSoft ↔ Listener По конфигурации поставки API синхронизации и отдельный HTTP(S) callback в приложение.
Listener → брокер и кэш По конфигурации поставки Внутренние соединения выбранной архитектуры.

Разрешайте только направления выбранного профиля. Порт 25 применяют для согласованного relay с ограничением источников; он не является рекомендуемым по умолчанию портом клиентской отправки. Получение по IMAP не требует открывать входящий SMTP-порт на сервере BPMSoft.

Проверьте TLS без передачи пароля. Команды ниже проверяют имя и доверенную цепочку сертификата в той среде, где они запущены:

timeout 15 openssl s_client \
  -starttls smtp -connect smtp.example.org:587 \
  -servername smtp.example.org -verify_hostname smtp.example.org \
  -verify_return_error </dev/null

timeout 15 openssl s_client \
  -connect imap.example.org:993 \
  -servername imap.example.org -verify_hostname imap.example.org \
  -verify_return_error </dev/null

Для SMTP 465 используйте непосредственный TLS без -starttls smtp. При корпоративном удостоверяющем центре установите его доверенную цепочку в среду службы и контейнера поддерживаемым способом. Успешная TLS-проверка ещё не подтверждает аутентификацию или разрешение отправки.

Подготовьте сервис синхронизации

При действующем Listener сохраните его конфигурацию, постоянные данные и версии компонентов. Для новой установки используйте внутренний порядок развёртывания Listener. API и worker обновляйте согласованно.

Официальная Docker-инструкция для сервиса 1.0.0 предусматривает запуск инфраструктурного Compose до основных компонентов. Применяйте этот порядок только к соответствующему архиву. Имена прежних ListenerAPI/ListenerWorker и состав их зависимостей не следует механически заменять компонентами другой версии.

В дизайнере системы откройте Системные настройки и проверьте:

Код Что указать
ExchangeListenerServiceUri Корневой адрес API Listener с окончанием /api/listeners.
BpmCrmExchangeEventsEndpointUrl Для .NET 8: https://bpm.example.org/ServiceModel/ExchangeListenerService.svc/NewEmail. В .NET Framework используется дополнительный сегмент /0/.

С сервера приложения проверьте GET /api/listeners/status по фактическому адресу API. В BPMSoft .NET 8 откройте /ClientApp/#/IntegrationDiagnostics/ExchangeListener; для .NET Framework добавьте /0 перед /ClientApp. Последовательно проверьте сервис, подписку ящика и обратный путь в BPMSoft, затем получение нового контрольного письма.

Проверяйте содержание ответа API: HTML-страница входа с кодом HTTP 200 не означает готовность Listener. В приёмке используйте контролируемые письма; вызов ProcessFullEmail создаёт данные и не подходит для простой проверки доступности.

Настройте провайдера и ящик

В приложении откройте /ClientApp/#/MailboxSettings, для .NET Framework учтите /0. Добавьте профиль корпоративного провайдера и заполните поля таблицы. Выберите TLS-режим и аутентификацию, реально разрешённые сервером.

Поле или блок Заполнение
Название сервиса Понятное название корпоративной почты.
Сервер входящей почты (IMAP) Адрес сервера, порт и безопасность — обычно 993 и SSL/TLS.
Сервер исходящей почты (SMTP) Адрес сервера, порт и безопасность — 587/STARTTLS либо 465/SSL/TLS.
Формат логина «Использовать email», «Использовать имя почтового ящика» или «Формировать вручную» — по требованию сервера.
Метод аутентификации Поддерживаемый профиль Basic или OAuth 2.0. Для OAuth — параметры приложения соответствующего провайдера.

При Basic используйте защищённый канал и пароль приложения, если его требует провайдер. При OAuth получите согласованный идентификатор приложения, значение секрета, разрешения и адрес возврата по инструкции выбранного адаптера. Секрет клиента и идентификатор секрета — разные значения.

  1. Откройте вкладку Email коммуникационной панели → меню настройки → Новая учетная запись. Введите email, выберите подготовленного провайдера, выполните вход.
  2. Для общего ящика включите Доступ для других пользователей. Отдельно назначьте права на доступ к письмам, отправку и настройку ящика. Право читать письма не заменяет право отправки.
  3. На вкладке Почта включите Загружать письма в BPMSoft, задайте небольшой период первой загрузки и нужные папки. Дочерние папки выбирайте отдельно.
  4. Проверьте MailboxSyncInterval. Включите Отправлять письма из BPMSoft, если ящик должен присутствовать в поле «От кого». Этот признак управляет выбором отправителя, а исправность SMTP подтверждается отдельной отправкой.
  5. Сохраните параметры. После успешного пилотного обмена расширьте период и папки до нужного объёма.

После добавления ящика откройте его права доступа и назначьте только нужных сотрудников. Проверьте под ними чтение и отправку. Затем выполните контроль отправки/получения ниже.

Свяжите ящик с Документооборотом

После ручной отправки и получения перейдите к настройке согласования по email. В SmrDocflowMailbox выберите подготовленный ящик, проверьте предусмотренный продуктом доступ пользователя Supervisor, настройте режим SmrEmailApprovalSetting и шаблон EmailApprovaTemplate. Для ссылок используется канонический адрес SiteUrl и маршруты службы согласования из соответствующей статьи.

Параметр IsNeedToEmailNotification и настройки вложений применяйте к нужному сценарию уведомлений. При отправке файла проверьте фактический состав письма и ограничения выбранного хранилища. Адрес согласующего должен однозначно соответствовать его контакту.

Проверьте полный обмен

Проверка Результат
Отправьте из BPMSoft письмо с уникальной темой на контрольный ящик Письмо получено; From, тема, текст и небольшое вложение корректны.
Ответьте с контрольного адреса Ответ загружен в нужный ящик BPMSoft.
Проверьте ручной и автоматический обмен отдельными письмами Оба письма появляются; повторная синхронизация не создаёт дубли.
Запустите тестовый этап согласования и выполните действие из уведомления Доставлено уведомление и изменился нужный этап маршрута. Получение ответа само по себе этого не подтверждает.
Повторите обмен после предусмотренного перезапуска DNS, TLS, подписки и настройки сохранились; новое письмо отправлено и получено.

Для проверки достаточно тестового документа, времени, идентификатора письма и ожидаемого результата. Храните отправку, получение и обработку решения как отдельные результаты. Пароли, токены и заголовки авторизации в протокол не включайте.

Найдите участок, на котором произошла ошибка

Симптом Что проверить сначала
Не удаётся добавить ящик Провайдер, формат логина, действительность данных входа, допустимый способ аутентификации.
Listener не отвечает URL, DNS и TLS из среды приложения; состояние всех компонентов, а не только API.
SMTP принял письмо, получатель его не видит Очередь почтового сервера, ограничения адресата, квоты и сообщения об отказе доставки.
Письмо есть в веб-почте, но отсутствует в BPMSoft Папку, период загрузки, подписку, обработчик очереди и callback.
Ответ получен, маршрут не изменился Тему и служебные данные ответа, контакт, актуальность этапа и выбранный шаблон.
Проблема появилась после перезапуска Постоянные DNS, секреты, сертификаты, правила сети и порядок запуска зависимостей.

Сопоставляйте журналы за время одного контрольного письма. Изменение шаблона не исправляет ошибку подключения к IMAP. Сохраняйте сообщения и состояние очередей при диагностике; очистка базы писем или кэша не является стандартным шагом подключения.

Заполнение корпоративного SMTP/IMAP-профиля по шагам

  1. Получите отдельный контрольный ящик, адреса SMTP/IMAP, формат логина, TLS-режим, разрешённый способ входа и ограничения размера. Доступ через веб-почту не подтверждает разрешение протоколов внешним приложениям.
  2. Подготовьте Listener и убедитесь, что API и worker работают. Корневой адрес API и callback в системных настройках должны соответствовать этой среде.
  3. В почтовых настройках BPMSoft создайте профиль провайдера. Для IMAP укажите имя, порт и TLS с начала соединения либо другой подтверждённый режим. Для SMTP не путайте 465/TLS с 587/STARTTLS.
  4. Выберите формат логина, реально принимаемый сервером. Если используется пароль приложения, не заменяйте его паролем веб-входа. При OAuth нужны поддерживаемый адаптер, зарегистрированное приложение и разрешения именно почтового сценария.
  5. Добавьте ящик под выбранным владельцем, проверьте адрес отправителя и права использования. Ограничьте папки и период первой загрузки, чтобы не импортировать случайно весь почтовый архив организации.
  6. Выполните платформенную проверку подключения и отправку контрольного письма. Затем создайте новое внешнее письмо с уникальной темой и дождитесь его появления в BPMSoft.
  7. Настройте выбранные уведомления/согласование Документооборота и проверьте отдельное действие маршрута. Это следующий этап после успешного платформенного обмена.

Проверки TLS до ввода учётных данных

Из среды, которая подключается к почте, можно проверить TLS-участок:

openssl s_client -connect mail.example.org:993 -servername mail.example.org -verify_hostname mail.example.org -verify_return_error < /dev/null
openssl s_client -starttls smtp -connect mail.example.org:587 -servername mail.example.org -verify_hostname mail.example.org -verify_return_error < /dev/null

Замените имя и порты. Первая команда относится к IMAP TLS, вторая — к SMTP STARTTLS. Ожидается корректная цепочка и имя. Они не подтверждают пароль, разрешение протокола или доставку. Не вводите пароль в интерактивный TLS-тест и не записывайте его в командную строку.

Разберите результат доставки

Для каждого письма сохраните время, уникальную тему, отправителя/получателя в закрытом журнале и ожидаемый этап. Проверьте отдельно: SMTP принял письмо; оно доставлено адресату; ответ появился в BPMSoft; задача согласования изменилась при нужном ответе. Отказ на любом этапе требует проверки соответствующего участника, а не повторной очистки всех очередей.

Для общего ящика проверьте доступ второго сотрудника: видимость, отправку от нужного адреса и ограничения. Не предоставляйте всем пользователям доступ ко всей переписке ради одного процесса согласования.

Был ли данный материал полезен вам? Да Нет