Подключите почтовый сервис, настройте ящик и проверьте отправку и получение через 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 получите согласованный идентификатор приложения, значение секрета, разрешения и адрес возврата по инструкции выбранного адаптера. Секрет клиента и идентификатор секрета — разные значения.
- Откройте вкладку Email коммуникационной панели → меню настройки → Новая учетная запись. Введите email, выберите подготовленного провайдера, выполните вход.
- Для общего ящика включите Доступ для других пользователей. Отдельно назначьте права на доступ к письмам, отправку и настройку ящика. Право читать письма не заменяет право отправки.
- На вкладке Почта включите Загружать письма в BPMSoft, задайте небольшой период первой загрузки и нужные папки. Дочерние папки выбирайте отдельно.
- Проверьте
MailboxSyncInterval. Включите Отправлять письма из BPMSoft, если ящик должен присутствовать в поле «От кого». Этот признак управляет выбором отправителя, а исправность SMTP подтверждается отдельной отправкой. - Сохраните параметры. После успешного пилотного обмена расширьте период и папки до нужного объёма.
После добавления ящика откройте его права доступа и назначьте только нужных сотрудников. Проверьте под ними чтение и отправку. Затем выполните контроль отправки/получения ниже.
Свяжите ящик с Документооборотом
После ручной отправки и получения перейдите к настройке согласования по email. В SmrDocflowMailbox выберите подготовленный ящик, проверьте предусмотренный продуктом доступ пользователя Supervisor, настройте режим SmrEmailApprovalSetting и шаблон EmailApprovaTemplate. Для ссылок используется канонический адрес SiteUrl и маршруты службы согласования из соответствующей статьи.
Параметр IsNeedToEmailNotification и настройки вложений применяйте к нужному сценарию уведомлений. При отправке файла проверьте фактический состав письма и ограничения выбранного хранилища. Адрес согласующего должен однозначно соответствовать его контакту.
Проверьте полный обмен
| Проверка | Результат |
|---|---|
| Отправьте из BPMSoft письмо с уникальной темой на контрольный ящик | Письмо получено; From, тема, текст и небольшое вложение корректны. |
| Ответьте с контрольного адреса | Ответ загружен в нужный ящик BPMSoft. |
| Проверьте ручной и автоматический обмен отдельными письмами | Оба письма появляются; повторная синхронизация не создаёт дубли. |
| Запустите тестовый этап согласования и выполните действие из уведомления | Доставлено уведомление и изменился нужный этап маршрута. Получение ответа само по себе этого не подтверждает. |
| Повторите обмен после предусмотренного перезапуска | DNS, TLS, подписки и настройки сохранились; новое письмо отправлено и получено. |
Для проверки достаточно тестового документа, времени, идентификатора письма и ожидаемого результата. Храните отправку, получение и обработку решения как отдельные результаты. Пароли, токены и заголовки авторизации в протокол не включайте.
Найдите участок, на котором произошла ошибка
| Симптом | Что проверить сначала |
|---|---|
| Не удаётся добавить ящик | Провайдер, формат логина, действительность данных входа, допустимый способ аутентификации. |
| Listener не отвечает | URL, DNS и TLS из среды приложения; состояние всех компонентов, а не только API. |
| SMTP принял письмо, получатель его не видит | Очередь почтового сервера, ограничения адресата, квоты и сообщения об отказе доставки. |
| Письмо есть в веб-почте, но отсутствует в BPMSoft | Папку, период загрузки, подписку, обработчик очереди и callback. |
| Ответ получен, маршрут не изменился | Тему и служебные данные ответа, контакт, актуальность этапа и выбранный шаблон. |
| Проблема появилась после перезапуска | Постоянные DNS, секреты, сертификаты, правила сети и порядок запуска зависимостей. |
Сопоставляйте журналы за время одного контрольного письма. Изменение шаблона не исправляет ошибку подключения к IMAP. Сохраняйте сообщения и состояние очередей при диагностике; очистка базы писем или кэша не является стандартным шагом подключения.
Заполнение корпоративного SMTP/IMAP-профиля по шагам
- Получите отдельный контрольный ящик, адреса SMTP/IMAP, формат логина, TLS-режим, разрешённый способ входа и ограничения размера. Доступ через веб-почту не подтверждает разрешение протоколов внешним приложениям.
- Подготовьте Listener и убедитесь, что API и worker работают. Корневой адрес API и callback в системных настройках должны соответствовать этой среде.
- В почтовых настройках BPMSoft создайте профиль провайдера. Для IMAP укажите имя, порт и TLS с начала соединения либо другой подтверждённый режим. Для SMTP не путайте 465/TLS с 587/STARTTLS.
- Выберите формат логина, реально принимаемый сервером. Если используется пароль приложения, не заменяйте его паролем веб-входа. При OAuth нужны поддерживаемый адаптер, зарегистрированное приложение и разрешения именно почтового сценария.
- Добавьте ящик под выбранным владельцем, проверьте адрес отправителя и права использования. Ограничьте папки и период первой загрузки, чтобы не импортировать случайно весь почтовый архив организации.
- Выполните платформенную проверку подключения и отправку контрольного письма. Затем создайте новое внешнее письмо с уникальной темой и дождитесь его появления в BPMSoft.
- Настройте выбранные уведомления/согласование Документооборота и проверьте отдельное действие маршрута. Это следующий этап после успешного платформенного обмена.
Проверки 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; задача согласования изменилась при нужном ответе. Отказ на любом этапе требует проверки соответствующего участника, а не повторной очистки всех очередей.
Для общего ящика проверьте доступ второго сотрудника: видимость, отправку от нужного адреса и ограничения. Не предоставляйте всем пользователям доступ ко всей переписке ради одного процесса согласования.