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

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Подготовка среды с нуля
  6. Перевод BPMSoft на HTTPS

Перевод BPMSoft на HTTPS

Переходите к HTTPS после успешного локального запуска BPMSoft. Выберите имя сайта, настройте его разрешение с рабочего места и получите сертификат с этим именем в SAN. На рабочих местах должна быть доверена цепочка CA.

Windows и IIS

На сервере IIS откройте PowerShell от имени администратора. Команды импортируют PFX в хранилище компьютера, добавляют HTTPS-привязку с SNI и назначают сертификат. Подставьте своё имя и путь к защищённому файлу.

Import-Module WebAdministration
$name = 'bpm-app.test'
$password = Read-Host 'Пароль PFX' -AsSecureString
$certificate = Import-PfxCertificate -FilePath 'C:\Install\BPMSoft\server.pfx' -CertStoreLocation Cert:\LocalMachine\My -Password $password
New-WebBinding -Name BPMSoft -Protocol https -Port 443 -HostHeader $name -SslFlags 1
(Get-WebBinding -Name BPMSoft -Protocol https | Where-Object bindingInformation -eq "*:443:$name").AddSslCertificate($certificate.Thumbprint,'My')

Для теста можно выпустить сертификат командой New-SelfSignedCertificate -DnsName 'bpm-app.test' -CertStoreLocation Cert:\LocalMachine\My и присвоить возвращённый объект переменной $certificate вместо импорта. Экспортируйте только публичную часть через Export-Certificate и добавьте её в доверенные корневые сертификаты только на выделенном рабочем месте. Откройте TCP 443 для нужной сети, проверьте вход и после этого уберите локальную HTTP-привязку, если она больше не нужна.

Подготовьте сертификат на Ubuntu

На Ubuntu установите nginx командами sudo apt-get update и sudo apt-get install -y nginx либо из подготовленного офлайн-набора. Установщик может сразу запустить стандартный сайт nginx, поэтому до настройки ограничьте входящие подключения к веб-портам. На узле nginx подготовьте серверный PEM с цепочкой и закрытый ключ. Команда ниже создаёт закрытый каталог. Сертификат сохраните как bpm-fullchain.pem, ключ как bpm-key.pem с режимом 0600.

sudo install -d -m 750 /etc/nginx/tls

Для изолированного теста можно выпустить короткоживущий самоподписанный сертификат. Команда создаёт ключ и сертификат с именем из SAN. Используйте новый каталог и фактическое DNS-имя.

sudo sh -c 'umask 077; openssl req -x509 -newkey rsa:3072 -nodes -days 14 -subj "/CN=bpm-app.test" -addext "subjectAltName=DNS:bpm-app.test" -keyout /etc/nginx/tls/bpm-key.pem -out /etc/nginx/tls/bpm-fullchain.pem'

В тесте доверяйте публичному сертификату только на выделенном рабочем месте. Закрытый ключ остаётся на сервере.

Linux. Подготовьте конфигурацию nginx и Kestrel

Файлы сертификата приложения находятся в /etc/nginx/tls/bpm-fullchain.pem и bpm-key.pem, подготовлены по ветке Linux. Имя ниже замените своим. На сервере приложения откройте файл через sudoedit /etc/nginx/sites-available/bpmsoft и сохраните конфигурацию ниже.

server {
    listen 443 ssl;
    server_name bpm-app.test;
    ssl_certificate /etc/nginx/tls/bpm-fullchain.pem;
    ssl_certificate_key /etc/nginx/tls/bpm-key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    client_max_body_size 100m;
    location = /ConnectionStrings.config { return 404; }
    location = /appsettings.json { return 404; }
    location ~* ^/(db|DataProtectionKeys)(/|$) { return 404; }
    location ~* \.(config|deps\.json|runtimeconfig\.json|pfx|key|backup|bak|sql)$ { return 404; }
    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 300s;
    }
}

100 MiB — выбранный лимит примера, его согласуют с размером загрузки и лимитом приложения. Не закрывайте весь conf: оттуда могут загружаться необходимые ресурсы интерфейса. Блокируются чувствительные файлы/папки, а не все JSON/JS.

На том же узле через sudoedit /opt/bpmsoft/app/appsettings.json включите обработку forwarded-заголовков только от локального nginx:

"ForwardedHeaders": {
  "Enable": true,
  "ForwardedForHeaderName": "X-Forwarded-For",
  "KnownProxiesIP": ["127.0.0.1"]
}

Не заменяйте весь appsettings этими строками и не доверяйте proxy-заголовкам от любой сети.

Linux. Включите сайт после запуска BPMSoft

На сервере приложения с правом sudo выполните команды после успешной локальной проверки службы. Если ссылка уже существует и ведёт к нужному файлу, начните с sudo nginx -t.

sudo ln -s /etc/nginx/sites-available/bpmsoft /etc/nginx/sites-enabled/bpmsoft
sudo nginx -t &&
sudo systemctl restart bpmsoft &&
sudo systemctl enable --now nginx &&
sudo systemctl reload nginx

Ссылку создавайте только при отсутствии, другие сайты не удаляйте. Откройте TCP 443 из пользовательской/административной сети. При ошибке nginx -t не применяйте конфигурацию. При 502 проверьте локальный Kestrel и журнал приложения отдельно от внешнего TLS.

Приёмка с рабочего места

В Linux:

curl --fail --silent --show-error --output /dev/null https://bpm-app.test/
openssl s_client -connect bpm-app.test:443 -servername bpm-app.test -verify_hostname bpm-app.test -verify_return_error < /dev/null

На Windows используйте curl.exe с --output NUL либо браузер без обхода ошибок сертификата. Нужно правильное имя и доверенная цепочка; код 200/302 не должен быть страницей другого сервиса.

Проверьте /ConnectionStrings.config, /appsettings.json, /db/, /DataProtectionKeys/: ожидается отказ/отсутствие ресурса. При неожиданном 200 не печатайте содержимое в журнал, остановите публикацию и исправьте фильтрацию. Затем выполните вход, открытие конфигурации и компиляцию.

Эксплуатация

Сохраняйте сроки CA/серверных сертификатов, владельца и защищённые копии. После смены имени/схемы проверьте письма, callback и OAuth; они подключаются позже, но должны использовать окончательный адрес.

Продление не выполняется созданием нового CA поверх старого. Подготовьте новую серверную пару отдельно, проверьте её, замените в окно работ и повторите TLS/вход/служебные обмены. HTTP допускается лишь как локальный upstream в указанной схеме, а не как замена внешней защите.

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