Для Bpium
Настройка конфигурационного файла (config.env)
Bpium использует переменные окружения для хранения настроек. Если переменные окружения не заданы, то Bpium считывает их из файла config.env из папки приложения.
Не указывайте в нём параметры, если их значения совпадают со значениями по умолчанию.
Системные настройки
DB_CONNECTION_STRING(обязательный)
string
Строка подключения к базе данных Бипиума.
Формат: postgres://логин:пароль@адрес:порт/бд
Пример:postgres://user:password@localhost:5432/bpium_db
SERIAL_NUMBER
(обязательный)
string
Серийный номер продукта для активации.
При его отсутствии будет доступна только одна учетная запись администратора.
PUBLIC_WWW_DIR
string
Относительный путь к директории публичных файлов. Используется для хранения дополнительных модулей.
По умолчанию: www.
Безопасность
COOKIE_SECRET
(обязательный)
string
Уникальная строка, используется для шифрования авторизованных сессий сотрудников.
Придумайте строку.
SCRIPTS_TOKEN_SECRET(обязательный)
string
Уникальная строка, используется для формирования кода доступа к API без авторизации. Такой доступ использует сервер процессов. Придумайте строку.
Сетевые настройки и защищенный канал связи.
Для работы приложения и модуля телефонии
HOST
string
Адрес (домен) сервера для доступа из внешних ресурсов. Например, писем с приглашениями на регистрацию.
Формат: domen.ru или 213.48.87.211
PORT_HTTP
int
Порт веб-сервера Bpium для HTTP.
Если пуст, то сервер не принимает запросы по HTTP.
По умолчанию: 80.
PORT_HTTPS
int
Порт веб-сервера Bpium для HTTPS.
Используется для безопасного соединения при установленном флаге HTTPS. По умолчанию: 443.
HTTPS
bool
Использовать протокол HTTPS.
Значения: true/false. По умолчанию: false.
HTTPS_FORCE
bool
Включить редирект с PORT_HTTP на PORT_HTTPS.
Значения: true/false. По умолчанию: = HTTPS.
REDIRECT_CLIENT_TO_HTTPS
bool
Включить редирект с PORT_HTTP на PORT_HTTPS
для выдачи приложения (при этом API продолжит работать без редиректа). Используется для принудительного переключения на HTTPS и для конфигурации, когда приложение стоит за веб-сервером обеспечивающим работу по HTTPS.
Значения: true/false.
HTTPS_CERTIFICATE_PATH
string
Путь к файлу сертификата (crt).
HTTPS_KEY_PATH
string
Путь к файлу с ключом сертификата (key).
Настройка почтовой службы.
Для опциональной отправки приглашений сотрудникам на почту.
EMAIL_SERVICE
string
EMAIL_LOGIN
string
Адрес эл. почты для авторизации по SMTP
EMAIL_PASSWORD
string
Пароль от эл. почты
Настройка авторизации
Настройки для проверки пароля через сторонние сервисы, например Active Directory.
AUTH_TYPE
string
Тип авторизации: local — через Бипиум, ldap — через Active Directory. По умолчанию: local.
AUTH_LDAP_URL
string
URL-сервера. Пример: ldap://192.168.0.100
AUTH_LDAP_BINDDN
string
Соединение к DN под администратором.
Пример: CN=bpiumauth,CN=Users,DC=bpium
AUTH_LDAP_PASSWORD
string
Пароль доступа к AUTH_LDAP_BINDDN
AUTH_LDAP_SEARCHBASE
string
Базовый DN, в котором искать пользователей.
Пример: CN=users,DC=bpium
AUTH_LDAP_SEARCHFIELD
string
Поле пользователя AD, в котором содержится логин.
По умолчанию: cn.
AUTH_LDAP_SEARCHFILTER
string
Фильтр для поиска пользователя.
По умолчанию: {{username}}.
AUTH_LDAP_SESSION_AGE
int
Время жизни авторизационной сессии с AD.
Проверка пароля через LDAP операция долгая. Если проверять пароль каждый раз, это замедлит работу сотрудника. Поэтому Бипиум запоминает авторизацию на некое время и периодически перепроверяет её валидность. Если пользователя удалили в AD или изменили пароль, то он продолжит работать в Бипиуме в течение этого времени. Задается в миллисекундах.
По умолчанию: 300000. (5 мин)
Настройка файлового сервера
Настройки для доступа на сервер Amazon S3 или локальный сервер-хранилище Bpium S3.
S3_LOCAL
bool
Использовать локальное хранилище или Amazon.
true — локальное, false — Amazon.
По умолчанию: true.
S3_HOST(обязательный)
string
Публичный (локальный) адрес хранилища, доступный с компьютеров сотрудников (localhost не допустим).
Пример: files.company.ru или 211.129.48.11.
Для Amazon формируется сам.
S3_PORT
int
Порт локального хранилища. По умолчанию: 2020.
Для Amazon формируется сам.
S3_REGION
string
Регион дата-центра Amazon. Не используется для локального хранилища.
S3_BUCKET
string
Идентификатор хранилища. По умолчанию: storage.
S3_KEY(обязательный)
string
Публичный ключ доступа.
Для Amazon предоставляется Amazon.
Для локального хранилища — придумайте строку.
S3_SECRET(обязательный)
string
Секретный код доступа.
Для Amazon предоставляется Amazon.
Для локального хранилища — придумайте строку.
S3_HTTPS
bool
Использовать SSL-сертификаты и протокол HTTPS.
Значения: true/false. По умолчанию: false.
Настройка сервера процессов
Настройка для запуска на исполнение процессов через сервер Bpium BPM.
BPM_HOST
string
Публичный/локальный адрес сервера.
Пример: bpm.company.ru или 211.129.48.11.
BPM_PORT
int
Порт сервера процессов. По умолчанию: 2030.
BPM_SECRET
string
Секретный код доступа.
Придумайте уникальную строку.
BPM_HTTPS
bool
Использовать SSL-сертификаты и протокол HTTPS.
Значения: true/false. По умолчанию: false.
Лимитирование запросов к API
Для предотвращения перегрузки сервера
LIMIT_USER_REQUEST_DURATION
int
Интервал оценки числа запросов от одного аккаунта.
В миллисекундах. По умолчанию: 30000.
LIMIT_USER_MAX_REQUESTS
int
Макс. число запросов от одного аккаунта за интервал. По умолчанию: 100.
LIMIT_IP_REQUEST_DURATION
int
Интервал оценки числа запросов с одного IP-адреса.
В миллисекундах. По умолчанию: 30000.
LIMIT_IP_MAX_REQUESTS
int
Макс. число запросов с одного IP-адреса за интервал. По умолчанию: 1000.
Лимитирование запросов авторизации
Для предотвращения перебора паролей
LOGIN_LIMIT_MAX_AUTH_INTERVAL
int
Каждая неудачная попытка авторизации логарифмически увеличивает время до разрешенной следующей попытки.
Макс. время блокировки попыток авторизации.
В миллисекундах. По умолчанию: 300000. (5 мин)
LOGIN_LIMIT_MAX_AUTH_ATTEMPTS
int
Макс. число неудачных попыток авторизации под одним логином. По умолчанию: Infinity. (бесконечно)
Кеш
COMPANY_CACHE_LIFE_TIME
int
Бипиум кеширует служебные данные для увеличения производительности. Параметр определяет время жизни данных в кеше (в мс). 0 — не использовать.
По умолчанию: не задан (бесконечно).
Лайфхаки
Любую переменную окружения можно передать с префиксом BPIUM_ или без префикса. Если указаны оба, то приоритет за тем что с префиксом. Примеры:
Без префикса:
С префиксом:
NODE_TLS_REJECT_UNAUTHORIZED
int
Параметр позволяет Бипиуму отправлять запросы (вебхуки) к системе с самоподписным сертификатом. Не безопасно! Для активации укажите: 0.
Last updated