Перед установкой Документооборота выберите режим работы контура и проверьте соединения, необходимые используемым функциям: почте, редакторам, хранилищам, электронной подписи и обмену с внешними системами. Учитывайте запросы серверов приложения, вспомогательных служб и браузеров сотрудников.
1. Выберите режим работы
| Режим | Порядок подготовки |
|---|---|
| Полная изоляция | Используйте внутренние сервисы для нужных функций. Начните с загрузки и скачивания файлов, локального предпросмотра доступных форматов и редактирования в Word через Informer. Онлайн-редактор включайте после подготовки всех его локальных ресурсов и проверки сохранения версии; образы и пакеты доставьте заранее. |
| Ограниченный доступ к внешним службам | Зафиксируйте конкретные назначения, инициаторов и передаваемые данные. Разрешите только выбранные сервисы по правилам организации. |
| Облачный редактор | Подтвердите допустимость передачи файла и пользовательской авторизации провайдеру; настройте согласованный коннектор и возврат версии. |
Яндекс.Диск в этой документации означает интеграцию с файлами и редактором Диска. Она не включает автоматически почту, календарь, пользователей, SSO или административные API Яндекс 360. Аналогично OneDrive не означает подключение всех служб Microsoft 365.
Функции API Яндекс.Диска и Microsoft Graph относятся к соответствующим внешним платформам. Для каждой операции Документооборота требуется поддерживаемая реализация её коннектора.
2. Составьте перечень разрешённых соединений
Зафиксируйте версии BPMSoft и Документооборота, выбранные интеграции и фактические адреса их компонентов. Для каждого направления укажите:
- функцию и инициатора соединения: браузер, Informer, сервер приложения, Listener, редактор или другой сервис;
- имя и адрес назначения, протокол, порт, а для HTTP(S) — используемые пути и методы;
- прохождение через proxy, балансировщик или сетевой экран, способ аутентификации и требования к сертификату;
- передаваемые данные: файл, письмо, сведения о пользователе, подпись или служебный запрос;
- результат проверки, дату и необходимость постоянного доступа либо доступа только при обслуживании.
Таблицы ниже перечисляют направления для описанных в документации сценариев. Включайте только используемые функции. Порты приведены как типовые: фактические значения берите из настроек установленной системы. Для доработанных бизнес-процессов и дополнительных коннекторов добавьте их собственные соединения.
Стрелка обозначает инициатора нового соединения. Ответ на запрос и отдельный обратный вызов — разные направления: доступ BPMSoft к редактору или Listener не открывает им доступ в BPMSoft. Закрытый контур может включать несколько внутренних сетей и контейнерных сетей; проверьте правила на каждом переходе. Публикация сайта в Интернет не обязательна для внутренних пользователей и сервисов.
3. Проверьте соединения платформы
Проверьте публикацию BPMSoft и HTTPS
Убедитесь, что сайт открывается по согласованному HTTPS-адресу, сертификат доверен и работают WebSocket-соединения. Для подготовки используйте настройку публикации Windows/Linux.
При смене схемы или имени сайта проверьте ссылки в письмах, callback редакторов и почты, а также адреса возврата OAuth. Обратное переключение на HTTP выполняйте только по поддерживаемой процедуре своей версии; HTTP передаёт данные без защиты TLS. Не отключайте проверку сертификата для устранения ошибки соединения.
| Когда требуется | Инициатор → назначение | Протокол и порт | Проверяемый результат |
|---|---|---|---|
| Работа пользователей | Браузер или мобильный клиент → точка публикации BPMSoft | HTTPS, обычно TCP 443; HTTP — только по принятой схеме | Вход и работа с документом выполняются из пользовательской сети; имя и сертификат корректны. |
| Если есть proxy или балансировщик | Точка публикации → узлы приложения BPMSoft | HTTP(S), внутренний порт из конфигурации | Доступен каждый обслуживающий узел; сохраняются путь, метод и исходная схема запроса. Внутренний порт приложения не доступен из несогласованных сетей. |
| Уведомления и функции с постоянным соединением | Браузер или Informer → BPMSoft через все proxy | WebSocket: WSS при HTTPS, порт публикации | Соединение устанавливается и не обрывается при работе. Поддержка WebSocket проверена на каждом промежуточном узле. |
| Работа приложения | Каждый сервер BPMSoft → СУБД | TCP, порт выбранной СУБД; обычно PostgreSQL 5432 или SQL Server 1433 | Приложение подключается со своей учётной записью и выполняет операции; нет ошибок соединения или авторизации. |
| Кэширование | Компоненты, использующие кэш → сервер кэширования | Протокол и порт из конфигурации; для Redis без TLS обычно TCP 6379 | Доступны нужный экземпляр и БД кэша, выполняются аутентификация и TLS, если они настроены. |
| Если используется брокер сообщений | Приложение и микросервисы → брокер | По конфигурации; AMQP обычно TCP 5672, AMQP с TLS — 5671 | Сообщения поступают в нужные очереди и обрабатываются потребителями. Работоспособность административной страницы брокера не заменяет эту проверку. |
| Если включён глобальный поиск | Приложение и компоненты поиска → сервис поиска и его зависимости | По схеме развёртывания BPMSoft | Индексация завершается, поиск возвращает контрольную запись. Для поиска по содержимому файлов дополнительно находится фраза внутри поддерживаемого вложения. |
| Если подключён каталог | BPMSoft → AD/LDAP | LDAPS обычно TCP 636; LDAP/STARTTLS — 389 только при поддержке выбранного профиля | Выполняются подключение, чтение тестовой группы и синхронизация. Порт 389 сам по себе не включает TLS. См. подключение каталога. |
| Если используется единый вход или OAuth | Браузер и участвующие серверные компоненты → поставщик удостоверений; браузер → адрес возврата BPMSoft | Обычно HTTPS, TCP 443 | Вход и возврат в приложение завершаются; серверный обмен токена и обновление доступа работают для выбранного адаптера. |
БД, кэш, брокер и внутренние API микросервисов не открывайте для пользовательских компьютеров, если это не предусмотрено отдельным согласованным сценарием. Состав зависимостей сервиса берите из его установленной версии; например, почтовый сервис может использовать собственные брокер и хранилище состояния.
4. Проверьте весь путь почтового обмена
Почтовые уведомления, регистрация документов из писем и согласование используют подготовленную почту BPMSoft. Успешная отправка письма не подтверждает получение ответов и обработку решения. Проверьте направления выбранного профиля по настройке почты.
| Назначение | Инициатор → назначение | Протокол и порт | Проверяемый результат |
|---|---|---|---|
| Отправка | Отправляющий компонент BPMSoft или почтового сервиса → SMTP-сервер | Обычно TCP 587 с STARTTLS либо 465 с TLS. Порт 25 — для согласованного relay | Письмо с контрольным вложением доставлено адресату. |
| Получение по IMAP | Синхронизатор → IMAP-сервер | Обычно TCP 993 с TLS | Новое письмо из выбранной папки загружено в BPMSoft автоматически. |
| Профиль Exchange/EWS | Компонент обмена → Exchange | HTTPS, обычно TCP 443 | Отправка и получение работают с поддерживаемым способом входа. Для Microsoft 365 подтвердите действующий адаптер; OAuth сам по себе не заменяет EWS на Graph. |
| Управление синхронизацией | BPMSoft → API Exchange Listener | HTTP(S), адрес и порт ExchangeListenerServiceUri |
Доступен сервис и корректно обрабатываются подписки почтовых ящиков. |
| Доставка событий и писем в приложение | Exchange Listener → BPMSoft | HTTP(S), адрес BpmCrmExchangeEventsEndpointUrl и пути доставки установленной версии |
Новые письма поступают в нужный ящик BPMSoft; proxy сохраняет метод, тело и путь запроса, не возвращает страницу входа вместо ответа сервиса. |
| Внутренняя работа Listener | Компоненты почтового сервиса → его брокер, кэш и иные зависимости поставки | По конфигурации сервиса | Работают все необходимые компоненты и обработчики очередей; сообщения не остаются необработанными. |
Проверьте API и worker Listener, подписку ящика, получение нового письма и обратную доставку в BPMSoft по почтовой инструкции. Тесты создают письма — используйте контрольный ящик.
После проверки платформенной почты выполните нужные сценарии Документооборота: уведомление, отправку файла, регистрацию документа из письма, согласование по email. При согласовании по ссылке браузер получателя должен открывать BPMSoft; при согласовании ответным письмом нужен исправный входящий обмен. Отдельно подтвердите изменение этапа маршрута.
5. Проверьте подключения функций Документооборота
| Функция | Инициатор → назначение | Протокол и порт | Проверяемый результат |
|---|---|---|---|
| Р7 или ONLYOFFICE: интерфейс редактора | Браузер → сервер редактора | HTTPS и WSS, обычно TCP 443 | Загружаются скрипты и документ, работает совместный сеанс; внешние ресурсы не блокируются политикой контура. |
| Загрузка исходного файла и обратный вызов редактора | Сервер редактора → BPMSoft или фактический адрес источника файла | HTTP(S) по адресам, сформированным коннектором | Редактор получает исходный файл и передаёт событие сохранения; запросы проходят предусмотренную проверку доступа. |
| Получение результата редактирования | BPMSoft или компонент хранилища, выполняющий сохранение → адрес готового файла редактора | HTTP(S) по адресу результата | После завершения сеансов новая версия доступна в карточке и содержит правку. См. прямое подключение ONLYOFFICE и подключение Р7. |
| Nextcloud | BPMSoft → Nextcloud; браузер → Nextcloud и адрес возврата авторизации | HTTPS, обычно TCP 443 | Работают авторизация, загрузка и скачивание. При редактировании через Nextcloud отдельно проверены его соединения с редактором, источником файла и получателем результата. |
| S3 | BPMSoft → настроенный S3 API; другие участники — только если им выдаются прямые ссылки в выбранном профиле | HTTP(S), порт и имя из ServiceUrl |
Работают запись, чтение и предусмотренное удаление в нужных бакетах. Прямые ссылки доступны именно тому участнику, который их использует. |
| SharePoint как хранилище | BPMSoft и участники авторизации → сайт компании и службы доступа установленного коннектора | HTTPS, адреса и порт выбранного сайта | Файл записывается в нужный сайт и скачивается из BPMSoft. Возможности версий и редактора проверены отдельно по ограничениям хранилищ; способ доступа определяется коннектором. |
| Внешняя папка | Процесс приложения → локальный путь либо смонтированное сетевое хранилище | Для локального пути отдельного соединения нет; для сетевого ресурса — протокол его подключения | Служба приложения читает и записывает файлы. Сетевой ресурс остаётся доступным после перезапуска; прямой доступ браузеров к папке не требуется. |
| Облачные редакторы и хранилища | Браузер и серверные участники выбранного коннектора → API, авторизация и файловые адреса провайдера | Обычно HTTPS, TCP 443 | Для Яндекс.Диска, Microsoft 365/OneDrive или другого подтверждённого профиля выполнен полный цикл сохранения. Эти подключения не становятся локальными из-за размещения BPMSoft внутри организации. |
| Предпросмотр | Браузер → ресурсы просмотра; внешний viewer → адрес файла, если выбран внешний обработчик | HTTP(S), обычно HTTPS TCP 443 | Каждый нужный формат открывается при действующих ограничениях. Локальный DOCX-просмотр проверен отдельно от внешнего просмотра и от загрузки браузерных библиотек. |
| Informer и локальное редактирование | Приложение Informer на рабочем месте → BPMSoft; браузер → локальное приложение предусмотренным способом | Адрес публикации BPMSoft и WebSocket; локальное взаимодействие — по профилю клиента | Выполняются вход, получение задач, открытие DOCX в Word и возврат изменённой версии. Не открывайте произвольный локальный порт без требований установленного клиента. |
| Контур.Диадок | Компонент интеграции BPMSoft → API и службы авторизации оператора; браузер → сервисы оператора для пользовательских действий | HTTPS, обычно TCP 443; назначения — по установленному адаптеру | Работают получение и отправка контрольного документа. Доступ рабочего места к веб-интерфейсу Диадока не подтверждает доступ интеграции из BPMSoft. |
| МЧД ФНС | Компонент проверки МЧД → распределённый реестр; браузер → сайт ФНС при переходе «Проверить в ФНС» | HTTPS, адреса используемого сервиса | При загрузке МЧД получены сведения и состояние; переход на сайт ФНС работает отдельно. Источник серверного запроса и точный адрес сверяйте с настройками и журналом коннектора. |
| Электронная подпись | Браузер → локальные компоненты КриптоПро; компонент проверки сертификата → адреса цепочки и проверки отзыва, если требуются политикой | Локальное взаимодействие плагина; CRL/OCSP и получение цепочки — протоколы и адреса из сертификата и политики проверки | Подпись создаётся и проверяется, цепочка и статус сертификата определяются без ошибок доступа. Наличие файла сертификата не подтверждает доступность проверки его статуса. |
| Доработанные процессы и дополнительные интеграции | Инициатор из реализации → API, webhook или другая система; при входящем вызове — обратное направление в BPMSoft | По контракту конкретной интеграции | Запрос выполняется и достигает бизнес-результата; права и сетевые ограничения соответствуют согласованной операции. |
При подписи, печатных формах, водяных знаках и поиске по файлам сначала определите используемый обработчик. Локальная библиотека не требует отдельного сетевого порта. Если используется выделенный сервис конвертации, печати, распознавания или проверки, добавьте его фактические подключения и зависимости. Не открывайте внешний сервис только по названию функции.
Для callback разрешайте необходимые пути и методы конкретного коннектора с предусмотренной им проверкой доступа. Общая браузерная форма входа перед каждым служебным запросом может нарушить обмен. Не открывайте анонимно целиком /ServiceModel/ или /rest/; параметры маршрутов берите из инструкции интеграции для своей версии.
Адреса внешних сервисов
Разрешите подключения к адресам используемых сервисов. Учитывайте выбранный способ авторизации, адрес организации и дополнительные адреса файлов, возвращаемые провайдером.
| Функция | Инициатор → адрес назначения | Порт и путь | Что учитывать |
|---|---|---|---|
| Получение сведений о МЧД из ФНС | Сервер BPMSoft → m4d.nalog.gov.ru |
HTTPS, TCP 443; GET /api/v0/poar-portal/public/poa/{идентификатор_МЧД}/public |
Адрес берётся из SmrM4DCheckFnsUrlPattern. Запрос выполняется серверным компонентом, поэтому одного доступа с компьютера пользователя недостаточно. |
| Проверка статуса МЧД на сайте ФНС | Браузер → m4d.nalog.gov.ru |
HTTPS, TCP 443; /EMCHD/check-status?guid={идентификатор_МЧД} |
Это отдельный переход пользователя, а не тот же запрос, которым приложение получает сведения о МЧД. |
| API Диадока | Сервер BPMSoft → diadoc-api.kontur.ru |
HTTPS, TCP 443; методы API по операции | Для пользовательских переходов также разрешите доступ к diadoc.kontur.ru. |
| Авторизация Диадока через OpenID Connect | Браузер и сервер BPMSoft → identity.kontur.ru |
HTTPS, TCP 443; /connect/authorize и /connect/token |
Вход в браузере и серверный обмен кода на токен требуют разных направлений доступа. Обратный адрес приложения приведён ниже. |
| Авторизация Яндекс.Диска | Браузер → oauth.yandex.ru и страницы входа Яндекса; BPMSoft → oauth.yandex.ru |
HTTPS, TCP 443; /authorize и /token |
Для входа разрешите переходы на passport.yandex.ru. Проверьте весь путь авторизации из пользовательской сети. |
| Файлы и редактор Яндекс.Диска | BPMSoft → cloud-api.yandex.net; браузер → disk.yandex.ru |
HTTPS, TCP 443; API /v1/disk/resources и операции upload, publish, download; адрес редактора — из SmrYandexDiskEditUrl |
Проверьте также адреса загрузки и скачивания, возвращённые API. Доступность страницы Диска или перенаправление на проверку пользователя не подтверждают запуск редактора и возврат версии. |
| Авторизация Microsoft для OneDrive/SharePoint | Браузер и сервер BPMSoft → login.microsoftonline.com |
HTTPS, TCP 443; пути OAuth /common/oauth2/v2.0/authorize и /common/oauth2/v2.0/token |
Для профиля с конкретным каталогом используются его адреса авторизации. Не переносите эти настройки файлового коннектора на почтовый адаптер. |
| Файловый API Microsoft | BPMSoft → graph.microsoft.com; участники обмена → выбранный сайт SharePoint и адреса файлов, возвращённые провайдером |
HTTPS, TCP 443; пути файлового API OneDrive: /v1.0/me/drive/ и /v1.0/drives/ |
Сайт SharePoint определяется SharePointSiteUrl. Домены файлов и загрузки уточняйте после авторизации в выбранной организации, не заменяя их произвольным общим доступом в Интернет. |
| Внешний предпросмотр Microsoft | Браузер → view.officeapps.live.com; сервис просмотра → сформированный URL файла BPMSoft |
HTTPS, TCP 443; /op/embed.aspx?src={URL_файла} |
Внешний сервис должен получить файл по выданной ссылке. Доступа браузера к Microsoft недостаточно, если источник файла доступен только внутри организации. Учитывайте перенаправления на r.office.microsoft.com. |
| Внешний предпросмотр Google | Браузер → drive.google.com; сервис просмотра → сформированный URL файла BPMSoft |
HTTPS, TCP 443; /viewerng/viewer?url={URL_файла} |
Подключение требуется при выборе внешнего обработчика Google для нужного формата. Для полной изоляции используйте поддерживаемый локальный просмотр. |
| JavaScript страницы Р7/ONLYOFFICE | Браузер → ajax.googleapis.com и cdnjs.cloudflare.com |
HTTPS, TCP 443; jQuery и CryptoJS по адресам ниже | Если страница редактора загружает библиотеки с CDN, эти адреса должны быть доступны браузеру. Локальное размещение Р7/ONLYOFFICE не заменяет подготовку браузерных ресурсов для закрытого контура. |
Для загрузки библиотек страницы редактора через CDN требуются:
ajax.googleapis.com/ajax/libs/jquery/— библиотека jQuery;cdnjs.cloudflare.com/ajax/libs/crypto-js/— файлыcrypto-js.min.js,hmac-sha256.min.jsиenc-base64.min.js.
Версия библиотеки входит в полный URL файла. Если сетевые правила ограничивают не только домен, но и путь, возьмите полные адреса из запросов страницы редактора во вкладке «Сеть» (Network).
Для полностью изолированного развёртывания подготовьте поддерживаемую локальную поставку этих ресурсов и проверьте загрузку страницы без внешних запросов.
Адреса выше не заменяют проверку зависимых доменов авторизации, перенаправлений и URL скачивания, выдаваемых провайдером. В реестр разрешений включайте фактические назначения выбранного подключения. Публичные DNS-адреса не закрепляйте раз и навсегда за IP, полученным при одной проверке.
Пути служебных HTTP(S)-запросов
Разрешите запросы подключённых сервисов к нужным операциям BPMSoft. Параметры в фигурных скобках заполняет коннектор. Проверьте регистрацию сервисов, права и предусмотренную проверку доступа. Пути ниже приведены для .NET Core/.NET 8; особенности .NET Framework учитывайте по инструкции соответствующей интеграции.
| Направление или сценарий | Метод и путь в BPMSoft | Назначение |
|---|---|---|
| Р7/ONLYOFFICE или внешний обработчик, использующий такую ссылку | GET /ServiceModel/DocumentsService.svc/GetFile/{схема}/{идентификатор_файла}; для предусмотренного варианта ссылки — дополнительный сегмент /{временный_параметр} |
Получение исходного файла. Адрес должен разрешаться и открываться из среды редактора, а не только из браузера сотрудника. |
| Р7/ONLYOFFICE | POST /ServiceModel/DocumentsService.svc/HandleCallback |
Передача результата сеанса. После уведомления о готовом результате BPMSoft скачивает файл по URL из callback — для этого требуется отдельный исходящий доступ приложения к адресу результата. |
| Браузер после входа в Nextcloud, Яндекс, OneDrive или SharePoint | GET /rest/PtOauthService/NextCloudAuthCode, YandexDiskAuthCode, OneDriveAuthCode или SharePointAuthCode в том же сервисе |
Возврат кода авторизации. В настройках провайдера и приложения должны совпадать схема, имя сайта, путь и выбранный метод авторизации. |
| Браузер после авторизации Диадока | GET /rest/SmrDiadocIntegrationService/AuthorizationCallback |
Завершение авторизации Диадока через OpenID Connect. Не проверяйте его случайным вызовом без штатного сеанса авторизации. |
| BPMSoft → Listener | ExchangeListenerServiceUri, обычно API /api/listeners; проверка состояния /api/listeners/status |
Базовый адрес API относится к установленной версии Listener; проходят штатные обращения к подпискам, а не только проверка состояния. |
| Listener → BPMSoft | BpmCrmExchangeEventsEndpointUrl, в руководстве вендора — /ServiceModel/ExchangeListenerService.svc/NewEmail; доставка письма также использует методы службы, например ProcessBinarySerializedEmail |
Разрешены пути и методы фактической доставки; настройка одного NewEmail не подменяет проверку всего обмена. |
| Согласование из письма | /ServiceModel/SmrEmailApprovalService.svc |
Фактическая ссылка и запрос к нужной операции проходят по инструкции согласования; результат отражён в маршруте документа. |
| ONLYOFFICE Docs | /healthcheck, /web-apps/apps/api/documents/api.js, адреса сеанса и результата |
Проверка состояния и загрузка скрипта успешны; отдельно проходят редактирование и сохранение. Эти два пути не образуют полный список соединений редактора. |
При согласовании по ссылке адрес BPMSoft должен быть доступен из браузера получателя письма. Доступ сервера почты к стенду этого не заменяет. Решение по согласованию проверяйте на тестовом этапе маршрута, не вызывая ссылку действия ради сетевой диагностики.
Для облачных редакторов, S3, Диадока, МЧД и дополнительных коннекторов включите в разрешённый список конкретные назначения из настроек и штатного обмена установленного адаптера. Не переносите пути, способы авторизации и адреса одного коннектора на другой.
Проверьте обработчик предпросмотра
Для DOCX в продукте предусмотрена настройка IsOfflineDocxPreviewEnable. При использовании внешнего просмотра средствами Microsoft требуется доступ соответствующего сервиса к файлу; это иной сетевой сценарий, чем локальный просмотр. Описание форматов и поведения находится в статье «Предпросмотр файлов».
Проверьте отдельный файл каждого используемого формата в чистом браузерном сеансе. Зафиксируйте, какой обработчик открыл файл и откуда он получает данные. Доступ к документу должен сохранять принятую модель прав; публикация всего хранилища для внешнего viewer не является способом настройки предпросмотра.
Для PDF, DOCX и изображений, заявленных в локальном сценарии, проверяйте фактическую работу нужной сборки без внешних запросов. Наличие переключателя offline не доказывает автономность всех ресурсов страницы или других форматов.
6. Учтите служебные зависимости закрытого контура
Зафиксируйте версии пакетов и образов, происхождение и контрольные суммы. Подготовьте внутренний репозиторий или согласованный канал передачи. Установка из офлайн-образа и автономная работа всех функций требуют отдельных проверок.
| Назначение | Соединения | Что проверить |
|---|---|---|
| Разрешение имён | Все участники → разрешённые DNS-серверы; обычно UDP/TCP 53 | Нужные имена разрешаются из пользовательской, серверной и контейнерной сетей в правильные адреса. |
| Точное время | Узлы, которым нужна синхронизация → принятый источник времени; для NTP обычно UDP 123 | Время синхронизировано. Расхождение не нарушает вход, срок действия токенов и проверку сертификатов. |
| Доверие сертификатам | Проверяющий компонент → необходимые адреса цепочки, CRL/OCSP согласно политике | Доверие настроено на рабочих местах, серверах и в контейнерах. Установка корневого сертификата не заменяет проверку отзыва, если она обязательна. |
| Ресурсы интерфейса | Браузер → источники JavaScript, стилей, шрифтов, изображений и iframe | В новом браузерном сеансе все необходимые ресурсы загружаются из разрешённых источников. Для полной изоляции используется поддерживаемая локальная поставка ресурсов. |
| Установка, сборка и обслуживание | Компонент установки или сборки → репозитории ОС, NuGet/npm, реестры образов и каналы обновлений выбранных компонентов | Пакеты и зависимости доступны из внутреннего источника либо заранее перенесены утверждённым способом; исходная и последующая сборки проходят в контуре. |
| Лицензирование и обновления | Участники выбранной процедуры → адреса поставщика, только если процедура требует сети | Подтверждён способ выдачи и применения лицензий, обновления и продления для всех используемых компонентов. Порядок загрузки пакета не доказывает наличие или отсутствие постоянного сетевого обращения. |
Для полной изоляции используйте внутренние сервисы для нужных функций. Если функция требует внешней облачной службы, предусмотрите согласованный сетевой путь либо исключите её из выбранного режима работы.
- Проверьте источники ресурсов страницы редактора по списку внешних адресов. Если остаются внешние CDN, прямое подключение редактора не готово к полной изоляции. Используйте поставку коннектора с локальными ресурсами и её порядок установки; если такой поставки нет, оставьте этот онлайн-сценарий выключенным.
- Сохраните постоянные параметры среды, тома, сертификаты и секреты. Для контейнерного редактора проверьте их сохранность после пересоздания.
- Проверьте требования выбранных редакций к лицензированию и обновлениям и подготовьте их выполнение в контуре.
Для переноса образа в изоляцию сохраните его на подготовленном узле командой docker save -o editor.tar ИМЯ_ОБРАЗА:ТЕГ, перенесите файл и загрузите docker load -i editor.tar. Сверьте контрольную сумму. Доставка образа не подтверждает автономность коннектора и страницы редактора.
7. Проверьте каждое направление из среды инициатора
Выполняйте проверку с того узла, который устанавливает соединение. Для контейнерного Listener проверка на хосте не заменяет проверку в его контейнерной сети; для браузера используйте рабочее место сотрудника. При нескольких узлах приложения проверьте каждый узел.
- DNS: убедитесь, что имя разрешается в нужную точку публикации или сервис. Проверьте все реально используемые адреса, включая IPv6 при наличии соответствующей записи.
- Маршрут и порт: убедитесь, что соединение разрешено сетевыми экранами, proxy и политиками контейнерной среды.
- TLS: проверьте срок сертификата, соответствие имени и полную цепочку доверия в среде инициатора. Требования к клиентскому сертификату проверяйте отдельно, если он используется.
- Протокол и доступ: выполните штатную диагностику или операцию с настроенной аутентификацией. Доступный TCP-порт не подтверждает вход, а HTTP 200 со страницей авторизации не подтверждает работу API.
- Результат: проверьте появление письма, файла, версии, записи или решения в нужной системе. Сопоставьте время операции с журналами участников обмена.
Чтобы проверить разрешение имени и HTTPS в Linux, введите в терминале среды инициатора команды, заменив docs.example.org и адрес на фактические значения:
getent ahosts docs.example.org
curl --silent --show-error --output /dev/null --connect-timeout 5 --max-time 20 --write-out 'HTTP=%{http_code} TLS=%{ssl_verify_result}\n' https://docs.example.org/
openssl s_client -connect docs.example.org:443 -servername docs.example.org -verify_hostname docs.example.org -verify_return_error < /dev/null
В Windows PowerShell используйте:
Resolve-DnsName docs.example.org
curl.exe --silent --show-error --output NUL --connect-timeout 5 --max-time 20 --write-out 'HTTP=%{http_code} TLS=%{ssl_verify_result}\n' https://docs.example.org/
Для приведённой проверки curl ожидается TLS=0 и предусмотренный сайтом HTTP-ответ. При перенаправлении отдельно проверьте конечный адрес и доступ к нему. Для OpenSSL проверка имени и цепочки должна завершиться без ошибок. Если нужная утилита отсутствует, используйте утверждённое в контуре средство диагностики из той же среды.
Эти результаты подтверждают транспортный участок. Почтовый ящик, S3, LDAP, редактор и другие сервисы проверяйте их штатными операциями. Пароли, токены, закрытые ключи и полные строки подключения не включайте в команды, снимки и открытые обращения.
Проверьте состояние Listener и его зависимостей
С сервера приложения откройте /api/listeners/status и /healthz по адресу API Listener. Убедитесь, что статус сервиса — Started, а проверки его зависимостей — Healthy. Проверьте состояние обоих компонентов Listener: API и обработчика сообщений.
Из среды Listener проверьте доступ к адресу BPMSoft и доставку нового контрольного письма по почтовой инструкции. Отдельно проверьте подключение к SMTP/IMAP или Exchange с настроенной аутентификацией. Работа API и доступность БД, кэша или брокера не заменяют проверку отправки и получения писем.
8. Подтвердите работу при действующих сетевых ограничениях
После установки пакета и первичной настройки выполните проверки обычным пользователем на тестовых данных:
- вход, открытие документа, загрузку и скачивание файла;
- предпросмотр каждого используемого формата, локальное или онлайн-редактирование и возврат новой версии;
- отправку и получение почты, затем нужные почтовые сценарии Документооборота;
- поиск, подпись, МЧД, Диадок и другие включённые интеграции — каждую отдельно;
- повтор нужных операций после согласованного перезапуска и обновления соединений; для OAuth — также предусмотренное обновление доступа.
В новом профиле браузера проверьте вкладки «Сеть» (Network) и «Консоль» (Console) инструментов разработчика. Не должно быть недоступных необходимых ресурсов, блокировки HTTP-ресурсов на HTTPS-странице или неожиданных внешних запросов. Кэшированный скрипт может скрыть отсутствующий доступ при первом запуске на другом компьютере.
| Симптом | Что проверить |
|---|---|
| Имя не найдено или тайм-аут | DNS, маршрутизацию и разрешение порта из среды инициатора, включая контейнерную сеть и proxy. |
| Ошибка сертификата | Имя, срок, цепочку, доверие и необходимые проверки статуса в конкретной среде. Не используйте отключение TLS-проверки. |
| 401, 403 или страница входа вместо ответа API | Аутентификацию, права, токен, правила доступа и промежуточную авторизацию на proxy. |
| 404, ошибочный адрес или перенаправление | Путь, метод запроса, схему публикации, адрес возврата и настройки выбранного коннектора. Ответ при переходе браузером не заменяет проверку служебного POST-запроса. |
| 413, 502 или 504 | Соответственно лимиты размера запроса, доступность приложения за proxy, время выполнения и таймауты по всему пути. |
| Письмо отправляется, но не загружается ответ | Входящий протокол, подписку, очереди Listener и обратную доставку в BPMSoft. |
| Редактор открылся, но версия не сохранилась | Получение исходника, завершение сеансов, обратный вызов и скачивание результата участником, выполняющим сохранение. |
В перечне соединений отметьте результат каждого включённого сценария, фактические адреса и порты, время проверки и неисправный участок при ошибке. Неиспользуемые подключения отметьте как неприменимые. Готовность закрытого контура подтверждается работой выбранных функций при его штатных ограничениях, а не общим доступом сервера в Интернет. Для каждого соединения укажите также передаваемые данные: содержимое файла, URL, сведения пользователя или служебные ресурсы; значения токенов не записывайте. Убедитесь, что данные обрабатываются только в согласованных сервисах.