# Настройки файла конфигурации В этом разделе описано содержимое файла конфигурации `/core/app_config.json`. * `use_for_liveness` – опция применяется при использовании WebSDK операторами банка для съемки клиентов. Если `use_for_liveness` = `true`, при съемке лица на мобильных устройствах выбирается тыловая камера, на десктопе отключается флип; отключается обводка овала; * `preinit` – параметр включает предварительную загрузку библиотек и инициализацию, уменьшая время использования `plugin`. Параметр необязательный, значение по умолчанию `off` – загрузка скриптов и инициализация происходит после открытия `plugin` и вызова функции `OzLiveness.open()`. В таком режиме `plugin` не создает нагрузки на сайт (приложение), на котором он установлен, но сам `plugin` может открываться долго из-за описанных выше процессов. Значение `script` – предварительная загрузка только библиотек плагина. Значение `full` – предварительная загрузка библиотек и инициализация процесса определения лица. * `architecture` – выбор архитектуры, в которой используется WebSDK. Параметр необязательный, значение по умолчанию `normal`. * `normal` для включения полной версии Oz API; * `lite` для использования [Instant API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/instant-api-rezhim-raboty-bez-sokhraneniya-dannykh.md); * `capture` – [режим](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/zapusk-plagina/semka-video-i-opisanie-kollbeka-on_capture_complete.md) для работы с бэкэндом клиента напрямую. В этом случае возможно распространение Oz Liveness Web Plugin только через статические файлы, без адаптера (работает с версии 0.7.4); * `api_url` – адрес сервера Oz API, текстовый параметр; * `api_token` – токен для доступа к Oz API, текстовый параметр; * `api_use_token` – параметр, определяющий источник получения системой токена для доступа к Oz API. Возможные значения = `config`, `client`. * Если установлено значение `client`, то токен для доступа к Oz API ожидается от JS-плагина; * Если установлено значение `config`, то токен берется из параметра `api_token` файла `/core/app_config.json`. * `video_actions_list` – блок используемых в системе тегов файлов видео, текстовый массив. [Список актуальных тегов](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/media-tags.md#tegi-videofailov). * `photo_actions_list` – блок используемых в системе тегов файлов фотографий, текстовый массив. [Список актуальных тегов](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/media-tags.md#tegi-fotofailov). * `actions_default_importance` – возможность при запуске анализа переопределить массив действий из WEB-плагина. Возможные значения = `true`, `false`; * Если установлено `true`, то адаптер будет использовать массив действий из конфигурационного файла. * Если установлено `false`, то адаптер будет использовать массив действий, переданный из браузера методом `open(options)`. * `actions_default` – массив действий. Доступные параметры: * `video_count` – количество передаваемых видеофайлов, числовой параметр; * `photo_front` – наличие фронтальной страницы документа. Возможные значения = `true`, `false`; * `photo_back` – наличие оборотной страницы документа. Возможные значения = `true`, `false`. * `analyses` – блок настройки запуска анализов. Доступные параметры: * `quality` – запуск анализа Oz Liveness. Возможные значения = `true`, `false`; * `biometry` – запуск анализа Oz Biometry. Возможные значения = `true`, `false`; * `documents` – запуск анализа Oz Text. Возможные значения = `true`, `false`; * `collection_ids` (с версии 1.4.0) – массив идентификаторов коллекций для анализа по черному списку. * `extract_best_shot` – параметр, определяющий необходимость добавления в результат анализа прямой ссылки на лучший кадр, извлеченный из видео. Возможные значения = `true`, `false.` Если установлено `true`, в ответе в `output_images` (`results_media`) будет ссылка на извлеченное изображение; * `result_mode` – параметр, определяющий содержание ответа сервера с результатами проверки. Возможные значения: * `safe` – возвращается только состояние анализов (завершены или еще нет); * `status` – возвращаются результаты выполнения анализов; * `folder` – то же самое, что `status`, но дополнительно возвращается `folder_id.` * `result_codes` – блок кодов ответа с комментариями. * `delete_old_sessions` – если установлено `true`, старые сессии удаляются. * `delete_old_sessions_offset_minutes` – если установлено, старые сессии удаляются с соответствующим смещением в минутах. * `video_required_actions_list` – массив обязательных действий, которые снимающему нужно воспроизвести. См. [Active Liveness](/oz-knowledge-ru/obshaya-informaciya/readme/liveness-gestures.md#aktivnyi-liveness). ```json "video_required_actions_list": [ "video_selfie_smile" ], ``` * `save_lossless_frame`– если `true`, исходный кадр сохраняется без сжатия. * `video_file_format` – выбор формата видео, которое отправляется на `api`. Возможные значения – `zip` (рекомендуется), `mov` (менее безопасный вариант). Чтобы получить видео в MP4, воспользуйтесь инструкцией [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk/web-plugin/zapusk-plagina/semka-video-i-opisanie-kollbeka-on_capture_complete.md#obratite-vnimanie). * `debug` (с версии 1.1.0) – при значении `true` дает возможность открыть страницу /debug.php, на которой размещена информация о текущих конфигурации и лицензии. * `load_3d_mask` (с версии 1.2.1) – если установлено `true`, загружает модели для обработки видео, снятого с помощью 3D-маски. Значение по умолчанию – `false`; в этом случае модель не подгружается, и 3D-маску использовать нельзя (параметр `enable_3d_mask` игнорируется). * `enable_3d_mask` (с версии 1.2.1) – включает использование 3D-маски при съемке вместо овала. Параметр работает только в случае `load_3d_mask`= `true`; значение по умолчанию – `false`. * `master_license_signature` (с версии 1.3.1) – подпись мастер-лицензии; по умолчанию `null`. * `results_polling_interval` (с версии 1.4.0) – интервал опроса для получения результатов анализов, мс; значение по умолчанию — 1000. * `get_user_media_timeout` (с версии 1.5.0) – определяет время, по истечении которого отобразится подсказка о том, как получить доступ к камере, если к тому моменту доступ не был получен; `default_default` для всех браузеров и `android_facebook` для Facebook браузеров. ```javascript "get_user_media_timeout": { "default_default": 40, "android_facebook": 5 } ``` * `disable_adapter_errors_on_screen` (с версии 1.5.0) – выключает отображение ошибок в модальных окнах, оставляя возможность их просмотра только в коллбэке `on_error`. Значение по умолчанию – `False`. * `auth` (с версии 1.7.14) – указывает, используется ли авторизация, и если да, то каким способом: * `true` (по умолчанию) – включена авторизация на базе генерируемого ключа доступа; * `user:pass` – включена авторизация на базе логина и пароля; * `false` – авторизация выключена. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/nastroiki-faila-konfiguracii.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.