Известные устройства и сессии#

Список известных устройств#

Метод

GET https://login.company.com/blitz/api/v3/users/{subjectId}/uas

Получение списка устройств пользователя.

Необходимые разрешения: blitz_api_uapps или blitz_api_sys_uapps.

Возвращает

JSON, содержащий перечень устройств пользователя.

Пример

Запрос

GET /blitz/api/v3/users/af583e70-fe39-407d-a87e-06cd0ec1830c/uas HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Cache-Control: no-cache

Ответ

[
    {
        "name": "Chrome 96",
        "lastUsed": 1637249978,
        "tp": "Browser",
        "os": "macOS 10.15.7",
        "newlyCreated": false,
        "deviceType": "pc",
        "latestIp": "172.25.0.1",
        "subjectId": "af583e70-fe39-407d-a87e-06cd0ec1830c",
        "id": "SHA256_Z0x284K3qv313WViRuPfV5rglhDuYqSn4ztdxVKMBec",
        "trusted": false,
        "cls": true,
        "deviceId": "738f5ce91f912ddd4a0cc5fefa9e8c63",
        "device": "PC"
    }
]

Удаление устройства из списка#

Метод

DELETE https://login.company.com/blitz/api/v3/users/{subjectId}/uas/{id}

Удаление устройства из числа запомненных. В качестве id нужно передать полученный идентификатор устройства.

Необходимые разрешения: blitz_api_uapps_chg или blitz_api_sys_uapps_chg.

Заголовки

В пользовательском режиме необходимо передать заголовки с IP‑адресом пользователя и User-Agent.

Пример

Запрос#

DELETE /blitz/api/v3/users/d2580c98‑e584‑4aad‑a591‑97a8cf45cd2a/uas/SHA256_Z0x284K3qv313WViRuPfV5rglhDuYqSn4ztdxVKMBec HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
X-Forwarded-For: 200.200.100.100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5)

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

Метод

POST https://login.company.com/blitz/api/v3/users/{subjectId}/sessions/reset

Сброс сессий пользователя.

Необходимые разрешения: blitz_api_usec_chg или blitz_api_sys_usec_chg.

Заголовки

В пользовательском режиме необходимо передать заголовки с IP‑адресом пользователя и User-Agent.
Если выход пользователя с текущего устройства/браузера является нежелательным, необходимо передать от приложения заголовок IB-CI-UA-ID с идентификатором текущего устройства, чтобы сохранить на нем сессию.

Совет

Идентификатор текущего устройства пользователя можно получить из маркера идентификации.

Возвращает

В случае успешного вызова - код HTTP 204 No Content.

Внимание

Сброс сессий приведет к аннулированию ранее полученных маркеров доступа и маркеров обновления текущего пользователя.

Примеры запросов

Пользовательский режим#

POST /blitz/api/v3/users/c574a512-3704-4576-bc3a-3fe28b636e85/sessions/reset HTTP/1.1
Content-Type: application/json
X-Forwarded-For: 200.200.100.100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5)…
Authorization: Bearer wzb…Tw
IB-CI-UA-ID: {SHA256}rVWFmwgRKWeW_flH4CA4yuW7OhKZ32Da94m0kzwWsVs

Режим вызова сервиса системой#

POST /blitz/api/v3/users/c574a512-3704-4576-bc3a-3fe28b636e85/sessions/reset HTTP/1.1
Content-Type: application/json
Authorization: Bearer qwa…Ez