Раздел login

Сервер BOOCO Astra (v 2.x) / Конфигурационный файл booco.yml

В разделе login указаны настройки авторизации и подсказок в форме входа.

⚠️
После внесения изменений в разделе login в booco.yml необходимо перезагрузить микросервис bosql и сервер BOOCO.

Поля раздела login

Название
Тип
По умолчанию
Описание
boolean

true

Разрешено ли восстановление пароля (если false — запрещено)

number

Временной интервал, за который учитываются попытки входа (указывается в минутах, например: "1 min"). Если не указан, то считается, что проверка на подбор пароля/кода отключена, выводится сообщение в аудит при инициализации bosql

number

5

Разрешенное количество попыток входа за интервал времени, при превышении которого последует блокировка пользователя

number

"5 min"

Длительность блокировки пользователя при превышении количества попыток входа (указывается в минутах, например: "5 min")

object

Подсказки в форме входа (если используются). Примечание. Подсказки общие для всех методов авторизации

object

Общие методы авторизации (по умолчанию)

object

Поддерживаемые методы логина через веб-интерфейс

object

Поддерживаемые методы логина в мобильном приложении

object

Настройка кодов авторизации

object

Поддерживаемые методы логина на панелях бронирования

Поля подраздела helpers

Название
Тип
Описание
string

Подсказка под полем ввода логина для версии RU

string

Подсказка под полем ввода логина для версии EN

string

Подсказка под полем ввода пароля для версии RU

string

Подсказка под полем ввода пароля для версии EN

Поля подраздела methods

Название
Тип
По умолчанию
Описание
boolean

true

Если true — включен метод авторизации по паролю, если false — отключен

boolean

false

Если true — включен метод авторизации через LDAP (AD), если false — отключен

boolean

false

Если true — разрешен метод авторизации по одноразовому коду, если false — отключен

boolean

false

Если true — разрешен метод авторизации с помощью Keycloak, если false — отключен

💡
Если и для password, и для auth-code указано false — включен вход по паролю, а в Журнале отображается предупреждение о неправильных настройках. Если и для auth-code, и дляpassword указаноtrue — включена двухфакторная аутентификация.

Поля подразделов mobile, legacy

Название
Тип
По умолчанию
Описание
boolean

true

Если true — разрешено восстановление пароля, если false — запрещено

object

Методы для данного типа клиента (имеют приоритет). Примечание. В подразделах web и mobile в methods могут использоваться все 3 метода авторизации, которые описаны в таблице Поля подраздела methods). В подразделе legacy в methods технически не поддерживается вход по одноразовому коду, но могут использоваться остальные 2 метода. Если метод не указан — значит, он отключен

Поля подраздела web

Название
Тип
По умолчанию
Описание
boolean

true

Если true — разрешено восстановление пароля, если false — запрещено

string

'10 min'

Срок жизни authToken’а, выданного пользователю при авторизации (authToken используется для обращения сервиса booco к bosql). Указывается в формате: '10 min'

string

Срок жизни refreshToken’а, который используется для обновления authToken’а. Определяет, в течение какого времени с момента закрытия сервера BOOCO пользователь может зайти без повторной авторизации. Должен быть больше, чем auth-expiration-time. Указывается в формате: '30 days'

object

Методы для данного типа клиента (имеют приоритет). Примечание. В подразделах web и mobile в methods могут использоваться все 3 метода авторизации, которые описаны в таблице Поля подраздела methods). В подразделе legacy в methods технически не поддерживается вход по одноразовому коду, но могут использоваться остальные 2 метода. Если метод не указан — значит, он отключен

object

Настройки авторизации с помощью Keycloak

Поля подраздела external

Название
Тип
Описание
string

Client ID клиента в Keycloak

string

Название реалма

string

URL-адрес домена Keycloak сервера

Поля подраздела auth-code

Название
Тип
По умолчанию
Описание
string

URL для отправки одноразового кода

number

Количество символов в коде авторизации

string

Время жизни одноразового кода. Указывается в формате: “1 min”, “1m”, “10s”, “40h”

string

'Код авторизации BOOCO'

Тема письма с одноразовым кодом, разрешаются подстановки

string

Ваш код авторизации: {code}

Тело письма с одноразовым кодом. {code} будет заменен на одноразовый код (если содержится)

string

Если используется, то будет указан в качестве адреса отправителя. Сервер должен поддерживать замену отправителя

Пример:

login:
  password-recovery: true
  interval-attempts: "1 min"
  allowed-attempts: 5
  timeout-duration: "5 min"
  helpers: 
    login: 
      title_ru: "Вход по логину и паролю"
      title_en: "Login using login and password"
    password: 
      title_ru: "Подсказка под паролем"
      title_en: "Password hint"
  methods:
    password: true
    saml: false
    google: false
    ldap: true
    auth-code: false
    external: true
  legacy:
    password-recovery: true
    methods:
      password: true
      auth-code: false
  web:
    password-recovery: true
    auth-expiration-time: '1 min'
    refresh-expiration-time: '30 days'
    methods:
      ldap: true
      password: true
      auth-code: false
      external: true
    external:
      clientId: keycloack-auth
      realm: front-realm
      url: https://keycloak.booco.ru
  mobile:
    password-recovery: true
    methods:
      ldap: true
      password: true
      auth-code: false
  auth-code:
    mailer-url: 'http://dev.booco.ru:3004/sendEmail'
    code-length: 6
    expiration-time: '1 min'
    subject: 'Код авторизации BOOCO'
    body: 'Ваш код авторизации: {code}'