Переходите к 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 в указанной схеме, а не как замена внешней защите.