# Архитектура 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/readme/klyuchevye-ponyatiya-oz-api.md) и [Руководство разработчика: Oz API](/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api.md). Проверить, как работает Oz API, можно с помощью нашей [коллекции Postman](https://doc.ozforensics.com/oz-knowledge-ru/obshaya-informaciya/readme/pages/-MSOBK0raWwPgM-1yqFO#4.0).

«Под капотом» 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: удобный для пользователей процесс съемки видео в оптимальном для последующих анализов качестве.

&#x20;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: 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/obshaya-informaciya/readme/general-info.md?ask=<question>
```

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.