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

Настройка сервиса#

Настройте Selinux и Firewall, чтобы они не блокировали работу сервиса.

Перейдите в директорию /lunapassapi:

cd /var/lib/luna-pass/current/lunapassapi

В конфигурационные файлы lunapassapi.config.toml, lunapassvideo.config.toml, lunapassvideo.task.py внесите необходимые настройки, соответствующие актуальным параметрам (Таблица 9).

Таблица 9. Параметры конфигурации LUNA PASS

Параметр

Описание

Параметры конфигурации LUNA PASS

env

Режим:

  • development — режим отладки со всеми данными;

  • production — основной режим работы со скрытием чувствительных данных.

Подробнее см. раздел "Логирование и отладка"

По умолчанию: production

host

IP адрес, на котором будет запущен сервис

По умолчанию: 0.0.0.0

port

Порт, на котором будет запущен сервис

По умолчанию: 8321

logLevel

Уровень логирования

Доступные значения:

  • 0 — запись только ошибок;

  • 1 — запись ошибок и информационных сообщений;

  • 2 — запись ошибок, информационных сообщений и отладочной информации

По умолчанию: 2

logFile

Файл логирования

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

По умолчанию: -

Параметры конфигурации FACEENGINE

sdkBindingsPath

Путь к Python bindings

По умолчанию: /fsdk/pythonBindings/build

sdkDataPath

Путь к каталогу данных

По умолчанию: /fsdk/data

sdkLicensePath

Путь к файлу лицензии.

По умолчанию: /fsdk/data/license.conf

Параметры конфигурации LUNA_PASS.JWT

algorithm

Алгоритм шифрования успешного кадра

По умолчанию: HS256

key

Секрет шифрования успешного кадра

По умолчанию: secret

Параметры конфигурации LIVENESS

maxAttempts

Максимальное количество кадров, пришедших в рамках 1 сессии.

При превышении значения отправляется текущий кадр как есть и соединение прерывается.

В случае отсутствия значения кадры проверяются до тех пор, пока не будет успешно пройденного Liveness

По умолчанию: 100

maxLivenessAttempts

Максимальное количество кадров, дошедших до проверки Liveness.

При превышении значения отправляется текущий кадр как есть и соединение прерывается.

В случае отсутствия значения кадры проверяются до тех пор, пока не будет успешно пройденного Liveness

По умолчанию: 75

aggregateFrames

Количество кадров, по которым необходимо агрегировать. Значение должно быть не менее 1

По умолчанию: 5

Пороги проверки LIVENESS.THRESHOLDS

blur

Смазанность фотоизображения

По умолчанию: 0.61

light

Засвеченность фотоизображения

По умолчанию: 0.57

dark

Затемненность фотоизображения

По умолчанию: 0.5

illumination

Равномерность освещения изображения, 0 – равномерно, 1 – есть пересветы

По умолчанию: 0.1

specularity

Наличие бликов на изображении, 0 – бликов нет, 1 – есть блики

По умолчанию: 0.1

ags

Прогнозная оценка того, насколько поступившее изображение подойдёт для последующего сравнения

По умолчанию: 0.8

Параметры лица

faceWidth

Ширина рамки лица

По умолчанию: 150

faceHeight

Высота рамки лица

По умолчанию: 150

yaw

Поворот вокруг вертикальной оси головы

По умолчанию: 20

pitch

Поворот вокруг поперечной оси головы

По умолчанию: 20

roll

Поворот вокруг продольной оси головы

По умолчанию: 20

mouth

Требуемая точность оценки статуса рта

По умолчанию: 0.4

glasses

Наличие очков. Доступные значения:

  • GlassesEstimation.NoGlasses — очки отсутствуют;

  • GlassesEstimation.EyeGlasses — очки;

  • GlassesEstimation.SunGlasses — солнцезащитные очки.

По умолчанию: [GlassesEstimation.NoGlasses, GlassesEstimation.EyeGlasses]

acceptOneEyeOpen

Разрешить прохождение проверки открытости глаз по одному глазу:

  • 0 - проверка статуса глаз проводится по обоим глазам;

  • 1 - проверка статуса глаз проводится по одному глазу.

По умолчанию: 0

deepfake

Требуемая точность оценки Deepfake

По-умолчанию проверка включена. Для отключения проверки закомментируйте строку с соответствующим порогом

По умолчанию: 0.7

livenessScore

Пороговое значение результата проверки OneShot Liveness, при котором человек будет считаться «живым»

По умолчанию: 0.7

multifacePolicy

Политика выбора лица для проверки Liveness. Доступные значения:

  • 0 — допустимо отправить только одно лицо с кадра;

  • 1 — отправляется самое крупное лицо в кадре;

  • 2 — отправляется самое близкое к центру лицо в кадре

По умолчанию: 0

Параметры для задания зоны распознавания лиц LIVENESS.THRESHOLDS.ROI

centerX

Центр зоны ROI по оси X

По умолчанию: 50

Единица измерения координаты по оси Х задаётся параметром centerXUnit. Возможные значения:

  • percent — измерение в процентах от размера пришедшего кадра;

  • px — измерение в пикселях, независимо от размера кадра

По умолчанию: percent

centerY

Центр зоны ROI по оси Y

По умолчанию: 50

Единица измерения координаты по оси Y задаётся параметром centerYUnit. Возможные значения:

  • percent — измерение в процентах от размера пришедшего кадра;

  • px — измерение в пикселях, независимо от размера кадра

По умолчанию: percent

width

Ширина зоны ROI

По умолчанию: 90

Единица измерения ширины зоны задаётся параметром widthUnit. Возможные значения:

  • percent — измерение в процентах от размера пришедшего кадра;

  • px — измерение в пикселях, независимо от размера кадра

По умолчанию: percent

height

Высота зоны ROI

По умолчанию: 90

Единица измерения высоты зоны задаётся параметром heightUnit. Возможные значения:

  • percent — измерение в процентах от размера пришедшего кадра;

  • px — измерение в пикселях, независимо от размера кадра

По умолчанию: percent

Параметры конфигурации плагинов запросов

Плагин MIDDLEWARES.REQUEST.BasicAuth

isEnabled

BASIC авторизация

По умолчанию: 0

args.username

Логин для Basic Auth

По умолчанию: -

args.password

Пароль для Basic Auth

По умолчанию: -

args.origin

ORIGIN заголовок для защиты от Cross-Site WebSocket Hijacking.

Может представлять собой ip-адрес сервера при доступе по ip-адресу или домен при доступе по доменному имени

По умолчанию: -

Плагин MIDDLEWARES.WS.FaceMatcher

isEnabled

Данная функция увеличивает потребление ресурсов и может приводить к снижению производительности

Количество лиц, допустимых в рамках одной сессии:

  • 0 — в рамках сессии допускается смена основного лица;

  • 1 — в рамках сессии допустимо только одно основное лицо (зависит от multifacePolicy). В случае смены основного лица сессия прекращается.

По умолчанию: 1

args.similarity

Порог схожести. Если значение схожести ниже порогового, то считается, что в кадрах разные лица и сессия прерывается

По умолчанию: 0.85

Плагин MIDDLEWARES.WS.VirtualCameraChecker

isEnabled

Проверять кадры на использование виртуальной камеры По умолчанию: 1

Плагин MIDDLEWARES.WS.FileLogger

isEnabled

Сохраняет в файл все входящие фотографии и результаты их эстимации в рамках одной сессии

По умолчанию: 1

args.path

Путь для сохранения файловых логов

По умолчанию: ./LOGS

Плагин MIDDLEWARES.WS.ActiveLiveness

isEnabled

Активный Liveness

По умолчанию: 1

args.cooldown FramesCount

Минимальное количество кадров, после прохождения активного Liveness

По умолчанию: 0

args.interactionsList

Используемые проверки:

  • blink — моргание глаз;

  • yawLeft — поворот головы влево;

  • yawRight — поворот головы вправо;

  • pitchUp — наклон головы вверх;

  • pitchDown — наклон головы вниз;

По умолчанию: [blink, yawLeft, yawRight, pitchUp, pitchDown]

args.interactionCount

Количество используемых взаимодействий с пользователем. Максимальное количество не должно превышать количество проверок, указанных в args.interactionList

По умолчанию: 2

args.interactionOrder

Порядок взаимодействия проверок:

  • random — произвольный. Из списка args.interactionList произвольно выбирается количество проверок, соответствующих значению args.interactionCount;

  • strict — строгий. Из списка args.interactionList последовательно выбирается количество проверок, соответствующих значению args.interactionCount.

По умолчанию: random

args.yawStartDeg

Начальный угол поворота, при котором возможно начать взаимодействие на повороты головы

По умолчанию: 10

args.yawThresholdDeg

Порог угла поворота, при котором взаимодействие на повороты головы считается выполненным

По умолчанию: 20

args.pitchStartDeg

Начальный угол запрокидывания головы, при котором возможно начать взаимодействие на запрокидывание головы

По умолчанию: 10

args.pitchThresholdDeg

Порог угла запрокидывания головы, при котором взаимодействие на запрокидывание головы считается выполненным

По умолчанию: 20

MIDDLEWARES.WS.VideoRedis

isEnabled

Плагин для склейки видео и отправки кадров сессии в Redis.

По умолчанию: 1

args.connectionString

Строка подключения к Redis

По умолчанию: redis://127.0.0.1:6379

args.queueName

Имя очереди Redis для работы с видео

По умолчанию: default

args.resultTtl

Как долго в Redis хранится информация об успешности задач и их результатах

По умолчанию: 500s

args.failureTtl

Как долго в Redis хранится информация о неуспешных задачах

По умолчанию: 1y

args.sessionTimeout

Количество секунд для старта сборки видео после завершения сессии при отсутствии bestshot

По умолчанию: 300

args.workerTask

Имя задачи, которую запустит lunapassworker при получении задачи на сборку видео

По умолчанию: task.run

args.framesLimit

Ограничение на максимальное количество кадров в видео:

  • При значении 0 ограничение не применяется;

  • При значениях больше 0 для видео берётся последние N кадров

По умолчанию: 0