# Установка и лицензирование

{% hint style="warning" %}
Если вы используете Oz Web SDK по модели SaaS, с вопросами по установке и лицензированию, пожалуйста, обращайтесь к нашим инженерам.
{% endhint %}

## Установка <a href="#h.uau5jhfpzc7g" id="h.uau5jhfpzc7g"></a>

Установить SDK можно двумя способами: либо инженеры Oz Forensics делают все вручную, либо используется [стационарный установщик](https://doc.ozforensics.com/oz-knowledge-ru/other/old-docs/ustanovka-modulei-oz/standalone). В последнем случае потребуется вовлечение ваших специалистов. При установке Oz Web SDK Web Adapter сгенерирует нужные файлы Web Plugin: такие, как файл со стилями (`ozliveness.css`) и основной скрипт плагина (`plugin_liveness.php`).&#x20;

## Лицензирование <a href="#h.ybr487kg4ab4" id="h.ybr487kg4ab4"></a>

{% hint style="info" %}
Этот раздел относится в первую очередь к обновлению лицензии, так как при установке Oz Web SDK лицензия также устанавливается, однако в случае надобности вы можете произвести первичную установку лицензии по такому же  алгоритму.
{% endhint %}

Для выпуска лицензии потребуется информация о доменных именах сайтов, где будет использоваться Web SDK. Можно также указывать поддомены.

{% hint style="info" %}
Чтобы узнать доменный адрес, в режиме разработчика выполните `window.origin` на странице, где будет запускаться Web SDK. При использовании Web SDK на localhost / 127.0.0.1 лицензия может работать без информации о доменных именах.
{% endhint %}

1. Распакуйте полученный файл.

```bash
unzip license.0000aaaa-00aa-00aa-00aa-00000aaaaa.WebSDK_your_website.2022-10-11.json.zip
```

2\. Скопируйте JSON-файл лицензии на хост, где развернут контейнер из образа `ozforensics/oz-webliveness-dev:latest`.&#x20;

**Пример**

```bash
scp -i ~/ozforensics/keys/id_rsa-test-hostname-vm license.0000aaaa-00aa-00aa-00aa-00000aaaaa.WebSDK_your_website.2022-10-11.json user@hostname:/opt/oz/web-sdk
```

* `-i ~/ozforensics/keys/id_rsa-test-hostname-vm` – путь к публичному ssh-ключу хоста
* `0000aaaa-00aa-00aa-00aa-00000aaaaa.WebSDK_your_website.2022-10-11.json` – файл лицензии в формате JSON.
* `user` – имя пользователя на хосте.
* `hostname` – псевдоним хоста.
* `/opt/oz/web-sdk` – каталог на хосте, где развернут контейнер Web SDK.

3\.  Замените файл лицензии.

**Пример**

```bash
ssh user@hostname -i ~/ozforensics/keys/id_rsa-test-hostname-vm sudo cp -v /opt/oz/web-sdk/license.license.0000aaaa-00aa-00aa-00aa-00000aaaaa.WebSDK_your_website.2022-10-11.json /opt/oz/web-sdk/license.json
```

4\. Перезапустите контейнер Web SDK.

**Пример**

```bash
ssh user@hostname -i ~/ozforensics/keys/id_rsa-test-hostname-vm sudo docker restart web-sdk
```

* `web-sdk` – название контейнера, созданного из образа `ozforensics/oz-webliveness-dev:latest`.

Проверьте, как установилась лицензия: например, пройдите по доменному имени хоста и выполните действие Liveness -> Simple selfie.

Далее при каждом запуске Web SDK система будет проверять валидность лицензии. Чтобы выполнить проверку вручную, воспользуйтесь методом `[GET] /check_license.php`.&#x20;

### Возможные ошибки лицензирования

| **Ошибка**                                                        | **Описание**                                                                |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------- |
| License error. License at <> not found                            | Файл лицензии не найден                                                     |
| License error. Cannot parse license from <>, invalid format       | Невозможно прочитать лицензию (файл содержит ошибки)                        |
| License error. Current date is later than license expiration date | Срок действия лицензии истек, необходимо обновление                         |
| License error. Origin is not in the list permitted by license     | Адрес домена или субдомена не найден в списке адресов, указанных в лицензии |


---

# 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/ustanovka-i-licenzirovanie.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.