> 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/obshaya-informaciya/opisanie-sistemy-oz-forensics/general-info.md).

# Архитектура Oz

В этой статье вы найдете описание компонентов Oz, которые вы можете встроить в вашу инфраструктуру в различных сочетаниях — в зависимости от того, что вам требуется.

Самые распространенные сценарии интеграции описаны в разделе [Краткие руководства по интеграции](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii.md).

<figure><img src="/files/3r5V5aiCY5HGQ7bsfuX1" alt=""><figcaption></figcaption></figure>

### Oz API

Oz API — центральный компонент системы, RESTful API-интерфейс для доступа к основной функциональности анализов Liveness и Face Matching. Преимущества Oz API:

* Сохранение данных — ваши медиафайлы и анализы хранятся для будущего использования, пока вы самостоятельно их не удалите.
* Возможность работать и с фото, и с видео.
* Асинхронность анализов.
* Безопасная аутентификация.
* Гибкая настройка уровней доступа.

Дополнительную информацию вы можете найти в статьях [Ключевые понятия Oz API](/oz-knowledge-ru/obshaya-informaciya/opisanie-sistemy-oz-forensics/klyuchevye-ponyatiya-oz-api.md) и [Руководство разработчика: Oz API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api.md). Проверить, как работает Oz API, можно с помощью нашей коллекции Postman.

«Под капотом» Oz API работают следующие компоненты:

* Хранилище файлов и база данных, где сохраняется информация о медиафайлах, анализах и так далее,
* Модуль Oz BIO — он отвечает за работу специально обученных нейронных сетей, распознающих лица,
* Логика лицензирования.

Фронтенд-компоненты, такие как мобильные или Web SDK, подключаются к Oz API в процессе обработки серверных анализов. Они могут это делать и напрямую, и через бэкенд клиента.

### iOS и Android SDK

iOS и Android SDK вместе называются мобильными (или нативными) SDK. Первый написан на SWIFT, второй — на Kotlin/Java. Оба они созданы для интеграции в ваши мобильные приложения.

Интерфейс мобильных SDK легко и гибко настраивается под ваши нужды, не влияя на основную функциональность: удобный для пользователей процесс съемки видео в оптимальном для последующих анализов качестве.

После записи Liveness-видео вы можете запустить анализы или на сервере, или на устройстве.

**Анализ на сервере** проводится либо с помощью соответствующих методов SDK, либо через Oz API — в этом случае вам нужно будет вызывать его методы из вашего мобильного приложения, либо опять же через Oz API, но уже с вашего бэкенда, куда предварительно передаются готовые видеоролики. Базовый сценарий интеграции описан [здесь](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-mobilnoe-prilozhenie.md).

**Анализ на устройстве** (Liveness и Face matching) не требует взаимодействия с Oz API и даже подключения к интернету, он выполняется прямо на телефоне. Такой анализ применим при высоких требованиях к конфиденциальности, когда вы не хотите, чтобы какая-либо информация «ушла» с телефонов пользователей.

{% hint style="info" %}
Мы рекомендуем использовать режим анализа на сервере, поскольку он обеспечивает более точные результаты по сравнению с анализом на устройстве.
{% endhint %}

### Web SDK

Web SDK состоит из Web Adapter и Web Plugin. Web SDK также разработан для интеграции в ваше приложение — в его веб-версию. Функциональность Web SDK аналогична таковой для iOS и Android: удобный для пользователей процесс съемки видео в оптимальном для последующих анализов качестве.

Web Adapter — часть Web SDK, которая устанавливается и конфигурируется на сервере. Web Plugin работает в контексте браузера: его вызывает ваше веб-приложение. Plugin взаимодействует с Adapter, а тот. В свою очередь — с Oz API. Дополнительное преимущество Web Plugin — защита от инъекционных атак:

1. Обнаружение атак путем сбора информации о контексте браузера и свойствах камеры — таким образом можно засечь виртуальную камеру или другие инструменты инъекционных атак.
2. Запись видео в формате, в котором запущенные на сервере нейронные сети могут наиболее эффективно отследить атаку в уже записанном видео.

Базовые сценарии интеграции Web SDK описаны [здесь](/oz-knowledge-ru/obshaya-informaciya/kratkie-rukovodstva-po-integracii/proverka-liveness-na-servere/kak-integrirovat-servernuyu-proverku-liveness-v-vashe-web-prilozhenie.md), а в [этом разделе](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/sdk/websdk.md) вы можете ознакомиться с руководством разработчика.

### Web UI (веб-консоль)

Web UI — веб-консоль для удобного просмотра хранящихся в API данных. Сама по себе она никакую информацию не записывает, а только предоставляет графический интерфейс для легкого взаимодействия с базой. Описание работы с интерфейсом Web UI вы найдете [здесь](/oz-knowledge-ru/rukovodstva/rukovodstvo-polzovatelya/oz-webui.md).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/opisanie-sistemy-oz-forensics/general-info.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.