---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/monitor-users-sessions-api
---



# Сессии пользователей

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Высокопроизводительный VCE
          theme: outlined
          url: https://docs.ideco.ru/api/vpp-v22/ru/ngfw/monitor-api/connections/
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/monitor/authorized-users
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

{% cut "Получение всех сессий" %}{#poluchenie-vseh-sessiy}

```
GET /monitor_backend/auth_sessions
```

{% note warning "" %}

Эндпоинт `/monitor_backend/auth_sessions` не поддерживает параметры фильтрации. Полученные данные необходимо фильтровать на стороне клиента, т.к. сервер возвращает полные данные.

{% endnote %}

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

```json5
{
  "id": "string",
  "auth_module": "string",
  "blocked_flags": "integer",
  "state_flags": "integer",
  "external_ip": "string" | null,
  "ip_is_dynamic": true | false,
  "lease_id": "integer",
  "login": "string",
  "mac": "string" | null,
  "name": "string",
  "subnet": "string",
  "start_ts": "integer",
  "user_object_id": "string",
  "uuid": "string",
  "two_factor": "string",
  "domain_type": "string",
  "group_name": "string",
  "group_object_id": "string",
  "country_code": "string" | null,
  "node_name": "string" | null,
  "hip_profiles": ["string"],
  "hip_profiles_changes": "integer",
  "phone_number": "string" | null,
  "mcert_dn": "string",
  "mcert_ca_id": "string",
  "mcert_ca_dn": "string",
  "mcert_binding": true | false
}
```

* `id` - идентификатор сессии пользователя;
* `auth_module` - тип авторизации:
  * `agent-ng` - подключение через Ideco Client без туннеля (из локальной сети);
  * `agent-vpn-ng` - подключение по Wireguard (Ideco Client);
  * `agent-vpn-tls` - подключение по TLS (Ideco Client);
  * `agent` - подключение через Ideco агент;
  * `ideco-vpn` - подключение через Ideco VPN;
  * `ikev2` - подключение по IKEv2;
  * `ip_and_mac_permanent` - постоянная авторизация по IP+MAC;
  * `ip_and_mac` - авторизация по IP+MAC;
  * `ip_permanent` - постоянная авторизация по IP;
  * `ip` - авторизация по IP;
  * `l2tp` - подключение по L2TP;
  * `log` - авторизация через журналы AD;
  * `mac` - авторизация по MAC;
  * `net` - авторизация по подсети;
  * `pptp` - подключение по PPTP;
  * `sstp` - подключение по SSTP;
  * `web` - веб-авторизация;
  * `win-terminal-agent` - авторизация терминального сервера Windows;
  * `win-terminal-user` - авторизация пользователя терминального сервера Windows.
* `blocked_flags` - статус сессии:
  * `1` - `deleted` - сессия удаляется;
  * `2` - `license_over_limit` - превышены ограничения лицензии;
  * `4` - `waiting_second_factor` - ожидание ввода второго фактора аутентификации;
  * `8` - `waiting_hip_profile_check` - ожидание проверки соответствия устройства заданному HIP-профилю;
  * `16` - `sessions_per_user_limit_exceeded` - превышен лимит сессий на одного пользователя.

Возможны комбинации нескольких статусов, например, `9` - сессия удаляется из-за несоответствия HIP-профилю.

* `state_flags` - состояние сессии:
  * `1` - `disconnected` - агент отключен, сессия ожидает переподключения.
* `external_ip` - IP-адрес удаленного пользователя при подключении по VPN;
* `ip_is_dynamic` - признак выдачи IP-адреса из пула свободных IP-адресов VPN-подсети:
  * `true` - IP-адрес выдан динамически;
  * `false` - IP-адрес назначен вручную.
* `lease_id` - идентификатор длительности сессии;
* `login` - логин пользователя;
* `mac` - MAC-адрес;
* `name` - имя пользователя;
* `subnet` - подсеть пользователя;
* `start_ts` - время подключения пользователя;
* `user_object_id` - идентификатор пользователя в формате с префиксом;
* `uuid` - универсальный идентификатор сессии;
* `two_factor` - тип второго фактора:
  * `smsaero` - SMS Aero;
  * `totp` - TOTP-токен;
  * `multifactor` - Мультифактор;
  * `not_required` - второй фактор не требуется.
* `domain_type` - тип пользователя (каталог):
  * `local` - локальный;
  * `ad` - Active Directory;
  * `ald` - ALD;
  * `freeipa` - FreeIPA;    
  * `radius` - RADIUS;
  * `device` - устройство.
* `group_name` - название группы, в которую входит пользователь;
* `group_object_id` - идентификатор группы с префиксом;
* `country_code` - код страны из базы GeoIP по значению из поля `external_ip`. Может быть `null`, если не удалось определить местоположение;
* `node_name` - имя узла, полученное от Ideco Client. Может быть `null`, если проверка не выполнялась;
* `hip_profiles` - список идентификаторов HIP-профилей, которым соответствует устройство. Может быть пустым, если проверка не выполнялась;
* `hip_profiles_changes` - счетчик изменения HIP-профилей. Для сессий, авторизованных через Ideco Client, счетчик всегда больше нуля, для остальных сессий - равен нулю;
* `phone_number` - номер телефона в международном формате для двухфакторной аутентификации. Может быть `null`, если у пользователя отсутствует номер телефона;
* `mcert_dn` - DN сертификата устройства. Строка пустая, если сертификат не использовался;
* `mcert_ca_id` - идентификатор УЦ сертификата устройства. Строка пустая, если сертификат не использовался;
* `mcert_ca_dn` - DN УЦ сертификата устройства. Строка пустая, если сертификат не использовался;
* `mcert_binding` - привязка CA-сертификата устройства к пользователю:
  * `true` - включена;
  * `false` - выключена.

{% endcut %}

{% cut "Удаление сессии" %}{#udalenie-sessii}

```
DELETE /monitor_backend/auth_sessions/<session_id>
```

* `session_id` - идентификатор сессии пользователя.

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

{% endcut %}

<!--Где смотреть инфу: https://stash.ideco.dev/projects/UTM/repos/monitor-backend/browse/docs/user_sessions.md -->
