Перейти к основному содержанию

Конфигурация системы

Около 3 мин

Конфигурация системы

StormBPMN использует двухуровневую систему настроек, которая обеспечивает гибкость конфигурации для различных сценариев развертывания.

Два уровня настроек

Уровень 1: Переменные окружения (ENV) - базовые настройки инфраструктуры Уровень 2: Административная панель - бизнес-логика и функциональность

Уровень 1: Переменные окружения (ENV)

Переменные окружения настраиваются до запуска контейнера и определяют базовую инфраструктуру системы. Эти параметры требуют перезагрузки приложения для применения изменений.

ПеременнаяОписаниеПример значенияОбязательно
JDBC_URLСтрока подключения к PostgreSQLjdbc:postgresql://192.168.0.6:5432/storm✅
JDBC_USERNAMEИмя пользователя базы данныхstormuser✅
JDBC_PASSWORDПароль пользователяsecure_password_123✅
JAVA_OPTSНастройки памяти для JVM"-Xmx8g"✅
SPRING_PROFILES_ACTIVEПрофиль Spring Bootprod✅
JWTSECRETСоль для шифрования паролейНе менее 15 случайных символов✅
LICENSE_KEYЛицензионный ключ EnterpriseeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...✅
MINIO_ENDPOINTURL S3-совместимого хранилищаhttp://192.168.0.4:9000Файлы
MINIO_ACCESSKEYКлюч доступа к S3stormbpmn-userФайлы
MINIO_SECRETKEYСекретный ключ S3secure-password-123Файлы
MINIO_DEFAULTBUCKETБакет по умолчаниюstorm-uploadsФайлы
PLANTUML_SERVERURL сервера PlantUMLhttp://192.168.0.5:8090/Опционально
GOTENBERG_URLURL сервиса Gotenberghttp://192.168.0.5:3001PDF
EMAIL_PROVIDERТип почтового провайдераlistmonk или smtp✅
LISTMONK_BASE_URLURL API ListMonkhttp://localhost:9000/api✅
LISTMONK_USERNAMEИмя API пользователяstormbpmn✅
LISTMONK_PASSWORDAPI токенapi-token-here✅
AUDIT_ENABLEDВключение аудита запросовtrueБезопасность
AUDIT_CHANNELКанал аудит-логовsyslogБезопасность
SYSLOG_SERVERSСписок syslog серверовlocalhost:514,192.168.78.53:601Безопасность
SYSLOG_SOURCEНазвание приложения в логахstormbpmnБезопасность

Важные замечания

  • PostgreSQL схема: Для подключения к определенной схеме используйте: jdbc:postgresql://localhost:5432/mydatabase?currentSchema=myschema
  • S3-хранилище: Без S3 ограничены возможности: нет миниатюр диаграмм, аватаров пользователей и работы с документами
  • EMAIL_PROVIDER: Для ListMonk укажите listmonk, для простого SMTP - SMTP
  • SMTP настройки: При использовании простого SMTP дополнительные параметры настраиваются в административной панели

Легенда обязательности

СимволЗначение
✅Обязательно - система не запустится без этих параметров
ФайлыДля файлов - нужно для работы с документами и изображениями
ОпциональноОпционально - для дополнительной функциональности
PDFДля PDF - требуется для генерации документов
БезопасностьДля безопасности - нужно для соответствия требованиям ИБ

Уровень 2: Административная панель

Настройки в административной панели управляют бизнес-логикой приложения и могут изменяться без перезагрузки системы.

Доступ к админке

Административная панель доступна по адресу: /app/admin Требуются права администратора команды.

Общие настройки системы

Базовые параметры

ПараметрОписаниеПример значенияОбязательно
baseUrlБазовый URL для ссылок в письмахhttps://stormbpmn.company.com✅

Настройки команд и пользователей

ПараметрОписаниеРекомендация
enableCommonAssetsОбщие элементы архитектуры для всех команд✅ Включить для больших организаций
enableCommonRolesОбщие роли для всех команд✅ Включить для унификации
enableCommonUsersОбщая организационная структура✅ Включить при централизованном управлении
autoJoinTeamIdID команды для автоматического добавления новых пользователейУкажите ID основной команды
disableTeamPopUpОтключить предложение создать команду✅ Включить при централизованном управлении
disableTeamCreationЗапретить создание команд✅ Включить при строгом контроле

Публичный доступ

ПараметрОписаниеРекомендация
allDiagramsAnonAccessАнонимный доступ ко всем диаграммам❌ Отключить для безопасности
enableAnonSearchPageПоиск для анонимных пользователейПо требованию бизнеса

Лицензирование

ПараметрОписаниеРекомендация
autoEnableEnterpriseLicenseАвтоматическая выдача лицензий✅ Включить для упрощения

Настройки простого SMTP

Требуется перезагрузка

Все настройки SMTP применяются только после перезагрузки приложения.

ПараметрОписаниеПример значения
simpleEmailEnabledВключить простой SMTPtrue
simpleSmtpHostSMTP хостsmtp.company.com
simpleSmtpPortSMTP порт587
simpleSmtpUsernameSMTP пользовательstormbpmn@company.com
simpleSmtpPasswordSMTP парольsecure-password
simpleSmtpFromEmail отправителяstormbpmn@company.com

Настройки шаблонов ListMonk

При использовании ListMonk для красивых писем:

ПараметрТип уведомленияПодстановки
commentEmailTemplateIdНовый комментарий{comment_author}, {diagram_name}, {diagram_url}, {html_text}
approvalTemplateIdЗапрос на согласование{invite_author}, {diagram_name}, {diagram_url}
restorePasswordTemplateIdВосстановление пароля{restoreCode}
approvalCompletedTemplateIdСогласование завершено{diagram_name}, {diagram_url}
userActivationTemplateIdАктивация пользователя{activation_token}
secureUpdateTemplateIdПриглашение к диаграмме{invite_author}, {diagram_name}, {diagram_url}
inviteDiagramAndRegisterTemplateIdПриглашение + регистрация{invite_author}, {diagram_name}, {diagram_url}, {register_url}
teamInviteTemplateIdПриглашение в команду{invite_author}, {team_name}
teamInviteAndRegisterTemplateIdПриглашение в команду + регистрация{invite_author}, {team_name}, {register_url}

Дополнительные настройки

Для сложных сетевых конфигураций

ПараметрОписаниеПример значения
gotenbergOverrideBaseUrlПрямой адрес для обхода балансировщиковhttp://corp.storm.internal

Порядок конфигурации

1. Настройка ENV переменных

  1. Обязательные параметры для запуска:

    JDBC_URL=jdbc:postgresql://db:5432/stormbpmn
JDBC_USERNAME=stormbpmn_user
JDBC_PASSWORD=secure_password
JAVA_OPTS="-Xmx8g"
SPRING_PROFILES_ACTIVE=prod
JWTSECRET=your-secret-key-here
LICENSE_KEY=your-license-key

  2. Дополнительные сервисы (по необходимости):

    # S3-хранилище
MINIO_ENDPOINT=http://minio:9000
MINIO_ACCESSKEY=stormbpmn-user
MINIO_SECRETKEY=secure-password

# Почта
EMAIL_PROVIDER=listmonk
LISTMONK_BASE_URL=http://listmonk:9000/api
LISTMONK_USERNAME=stormbpmn
LISTMONK_PASSWORD=api-token

  3. Перезапустите контейнер для применения изменений

2. Настройка через админку

  1. Войдите в административную панель: /app/admin
  2. Настройте базовые параметры:
    • baseUrl - обязательно для корректных ссылок
    • Политики команд и пользователей
  3. Настройте интеграции:
    • Шаблоны писем (для ListMonk)
    • SMTP параметры (для простой почты)
  4. Сохраните изменения - применяются мгновенно

Проверка конфигурации

Проверочный список

Распространенные проблемы

ПроблемаПричинаРешение
Приложение не запускаетсяНеверные JDBC параметрыПроверьте подключение к БД
Нет миниатюр диаграммНеверные MINIO параметрыПроверьте доступность S3
Не приходят письмаНеверные почтовые настройкиПроверьте EMAIL_PROVIDER и параметры
Ошибки лицензииНеверный LICENSE_KEYОбратитесь к менеджеру
Не скачивается PDFНенастроен GotenbergПроверьте GOTENBERG_URL и доступность сервиса

Связанная документация

Нужна помощь?

Если возникли вопросы по конфигурации, обратитесь к help@stormbpmn.com или вашему менеджеру.

Настройка видимости

В административной панели параметр "Настройка видимости" разрешает передачу значений на фронтенд. НЕ включайте его для паролей и конфиденциальных данных!