# Лицензирование

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/server-management/license-management
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::


{% cut "Регистрация сервера" %}

```
POST /license/register
```

**Json-тело запроса:**

```json5
{
    "token": "string"
}
```

* `token` - получить токен лицензии можно в отделе продаж, токен высылается в активационном письме;

**Ответ на успешный запрос:** 200 ОК

Чтобы добавить enterprise-demo лицензию, необходимо сначала получить токен лицензии в личном кабинете. Для этого выполните действия:

1\. Авторизуйтесь в личном кабинете [MY.IDECO](https://my.ideco.ru/):

```
POST /api/v3/login
```

**Json-тело запроса:**

```json5
{
    "login": "string",
    "password": "string",
    "g_recaptcha_response": "string" | null
}
```

2\. Выполните запрос на регистрацию сервера:

```
PUT /api/v3/<company_id>/go_to_product 
```

*  `company_id` - идентификатор компании пользователя, который можно получить по запросу `GET /api/v3/companies`.

**Ответ на успешный запрос:**

```json5
{
    "token": "string"
}
```

Используйте полученный токен в теле запроса при регистрации Ideco NGFW Novum.

{% endcut %}

{% cut "Получение информации о лицензии" %}

```
GET /license/info
```

**Пример ответа на успешный запрос:**

```json5
{
    "modules": {
        "active_directory": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_web": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "kaspersky_av_for_mail": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "application_control": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "suricata": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "advanced_content_filter": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "standard_content_filter": {
            "available": false,
            "expiration_date": 0
        },
        "ips_advanced_rules": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "cluster": {
            "available": true,
            "expiration_date": 1712400382.0
        },
        "icsd": {
            "available": true,
            "max_users_count": 10000
        }
    },
    "general": {
        "available": true,
        "reason": "",
        "not_upgrade_after": 1712400382.0,
        "tech_support_end": 1712400382.0,
        "start_date": 1708944382.2658572,
        "expiration_date": 1712400382.0
    },
    "license_type": "enterprise-demo",
    "license_id": "UTM-3883264353",
    "server_name": "UTM",
    "last_update_time": 1708944385.1747465,
    "company_id": "Ideco",
    "server_id": "OQHsviy10sEOOQXWs-8c7tnwJb4AaOvplT2iJc-im677",
    "registered": true,
    "unreliable": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}
```

**Если лицензия для данного сервера отсутствует:**

```json5
{
    "registered": false,
    "has_connection": true,
    "license_server": "https://my.ideco.ru"
}
```

{% endcut %}

{% cut "Получение информации о механизме обновления лицензии" %}

```
GET /license/update-type
```

**Ответ на успешный запрос:**

```json5
{
    "update_type": "auto" | "manual"
}
```

* `auto` - при автоматическом получении лицензии;
* `manual` - при ручной загрузке лицензии.

{% endcut %}

{% cut "Изменение механизма обновления лицензии" %}

```
PATCH /license/update-type
```

**Json-тело запроса:**

```json5
{
    "update_type": "auto" | "manual"
}
```

**Ответ на успешный запрос:** 200 ОК

{% endcut %}

{% cut "Получение ссылки для офлайн-регистрации" %}

```
GET /license/license-get-offline-registration-url
```

**Ответ на успешный запрос:**

```json5
{
    "registration_url": "https://my.ideco.ru/ngfw?server_name=...hwid=...version=..."
}
```
* `server_name` - имя сервера Ideco NGFW Novum;
* `hwid` - HWID сервера;
* `version` - версия сервера.

Получение ссылки для офлайн-регистрации сервера возможно только при ручном механизме обновления лицензии.

{% endcut %}

{% cut "Загрузка файла с лицензией на NGFW" %}

```
PUT /license/license-upload
```

**Тело запроса:** файл с лицензией в формате jwt, который можно скачать в [MY.IDECO](https://my.ideco.ru/). Более подробная информация представлена в [статье](https://docs.ideco.ru/v22/ru/ngfw/settings/server-management/server-update).

**Ответ на успешный запрос:** 200 ОК

{% endcut %}
