> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge-ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/nastroiki-faila-konfiguracii.md).
# Настройки файла конфигурации
В этом разделе описано содержимое файла конфигурации `/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` (Поддержка анализа Documents прекращается. С 1 июля 2027 года анализ будет недоступен.);
* `collection_ids` (с версии 1.4.0) — массив идентификаторов коллекций для анализа по черному списку.
* `extract_best_shot` — параметр, определяющий необходимость добавления в результат анализа прямой ссылки на лучший кадр, извлеченный из видео. Возможные значения = `true`, `false.` Если установлено `true`, в ответе в `output_images` (`results_media`) будет ссылка на извлеченное изображение;
* `extract_action_shot` — параметр, используемый в сценарии с несколькими жестами, когда человек выполняет несколько жестов один за другим. Если параметр имеет значение `true`, он позволяет получить кадр из каждого видео с жестом, например, кадр с закрытыми глазами при моргании. Для каждого жеста сохраняется отдельный кадр.
* `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/opisanie-sistemy-oz-forensics/liveness-gestures.md#aktivnyi-liveness).
```json
"video_required_actions_list":
[
"video_selfie_smile"
],
```
* `debug` (с версии 1.1.0) — при значении `true` дает возможность открыть страницу /debug.php, на которой размещена информация о текущих конфигурации и лицензии.
* `tm_url` (с версии 1.2.0) — адрес сервера телеметрии;
* `tm_token` (с версии 1.2.0) — токен для телеметрии;
* `load_3d_mask` (с версии 1.2.1) — если установлено `true`, загружает модели для обработки видео, снятого с помощью 3D-маски. Значение по умолчанию — `false`; в этом случае модель не подгружается, и 3D-маску использовать нельзя (параметр `enable_3d_mask` игнорируется). Внимание: с 1 января 2027 года мы отключаем возможность использования 3D-маски. Пожалуйста, спланируйте [миграцию](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/instrukcii-po-migracii/web-sdk-perekhod-s-3d-maski.md) заранее.
* `enable_3d_mask` (с версии 1.2.1) — включает использование 3D-маски при съемке вместо овала. Параметр работает только в случае `load_3d_mask`= `true`; значение по умолчанию — `false`. Внимание: с 1 января 2027 года мы отключаем возможность использования 3D-маски. Пожалуйста, спланируйте [миграцию](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/instrukcii-po-migracii/web-sdk-perekhod-s-3d-maski.md) заранее.
* `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": 40000,
"android_facebook": 20000
}
```
* С помощью следующих параметров (добавлены в 1.7.15) вы можете управлять поведением SDK при зависании `getUserMedia()`:
* `get_user_media_promise_timeout_ms` — по истечении установленного здесь таймаута (в мс) SDK вызовет ошибку или покажет инструкцию для пользователя. Этот параметр представляет собой объект с ключами: `"platform_browser"`, `"browser"`, `"platform"`, `"default"`(приоритет соответствует последовательности).
* `get_user_media_promise_timeout_throw_error` — определяет, что именно демонстрирует SDK после таймаута, ошибку (если `true`) или инструкцию (если `false`).
* `get_user_media_deny_permission_throw_error` (добавлен в 2.2.0) — при значении `true` встроенная экранная форма с инструкцией не отображается. Вместо него вызывается коллбэк `on_error` с `error_no_camera` / `error_no_camera_ios` / `error_no_camera_android`. Значение по умолчанию — `False`.
* `disable_adapter_errors_on_screen` (с версии 1.5.0) — выключает отображение ошибок в модальных окнах, оставляя возможность их просмотра только в коллбэке `on_error`. Значение по умолчанию — `False`.
* `auth` (с версии 1.7.14) — указывает, используется ли авторизация, и если да, то каким способом:
* `true` (по умолчанию) — включена авторизация на базе генерируемого ключа доступа;
* `user:pass` — включена авторизация на базе логина и пароля;
* `false` — авторизация выключена.
* `use_wasm_container` (с версии 1.9.2) – при значении `true` включает использование [контейнера данных OzCapsula](/oz-knowledge-ru/obshaya-informaciya/opisanie-sistemy-oz-forensics/konteiner-dannykh-ozcapsula.md). Значение по умолчанию — `False`.
* `api_use_session_token` (с версии 1.9.2) — определяет, как SDK получает и передает session token. `client` (по умолчанию) — вы запрашиваете токен у Oz API, как описано [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/rabota-s-konteinerom-dannykh-ozcapsula.md#poluchenie-session-token).
* logo (с версии 1.9.7) — URL для изображения с логотипом. Работает, только если это указано в [лицензии](/oz-knowledge-ru/obshaya-informaciya/opisanie-sistemy-oz-forensics/varianty-licenzirovaniya.md) (за дополнительную плату). Форматы: SVG (рекомендуется), PNG, JPG.
* `feature_stateless_adapter` (с версии 2.0.0) — режим для развертываний с несколькими инстансами, при котором мы не сохраняем состояние сессии на диске, а возвращаем его в каждом ответе в виде зашифрованного blob-объекта.
* `feature_face_detector_attempt_timeout_ms` (с версии 2.3.0) — тайм-аут одной попытки детектора лиц. При его превышении выполняется повторная попытка, сессия не прерывается. Значение по умолчанию: `5000`.
* `feature_face_detector_retry_budget_ms` (с версии 2.3.0) — общее время, отведенное на повторные попытки. Если оно истекло, сессия завершается с ошибкой `error_face_detector_no_result`. Значение по умолчанию: `15000`; должно превышать тайм-аут одной попытки.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-administratora/web-adapter/nastroiki-faila-konfiguracii.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.