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

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

* `ADMIN` – Администратор системы. Имеет неограниченный доступ ко всем ресурсам системы через API, кроме принятия решений по анализам;
* `OPERATOR` – Системный оператор. Имеет неограниченный доступ на просмотр заявок и может принимать решения по анализам, с помощью кнопки **Принять решение** (обычно используется в случае появления [статуса](https://doc.ozforensics.com/oz-knowledge-ru/rukovodstva/rukovodstvo-razrabotchika/api/oz-api/statuses) `OPERATOR_REQUIRED)`;
* `CLIENT` – Клиентская учетная запись. В рамках своей компании имеет доступ к загрузке медиафайлов, запуску анализов, просмотру результатов в своих папках, выгрузке отчетности по заявке;
  * `is_admin` – если установлен, пользователь получает доступ к данным всех пользователей внутри своей компании
  * `can_start_analyse_biometry` – дополнительный флаг для ограничения доступа к проведению биометрии (по умолчанию разрешено)
  * `can_start_analyse_quality` – дополнительный флаг для ограничения доступа к проведению анализов Liveness (по умолчанию разрешено)
* `CLIENT ADMIN` – администратор компании, который может управлять пользователями и аккаунтом своей компании. `CLIENT ADMIN` может просматривать данные всех пользователей и редактировать их, просматривать статистику, удалять файлы в папках, шаблоны отчетов вместе с вложениями, сами отчеты и отдельные анализы, а также может добавлять шаблоны отчетов и изображения в ЧС.
* `CLIENT OPERATOR` – имеет такие же права, как и `OPERATOR`, но в рамках своей компании.
* `CLIENT SERVICE` – сервисный аккаунт для автоматических соединений. При авторизации под таким пользователем выдаётся токен с долгим временем жизни (по умолчанию 5 лет). Время жизни токенов для обычных пользователей составляет 15 минут (параметризуется), по умолчанию время жизни токенов продлевается при каждом обращении (параметризуется).

<details>

<summary>Для версий API &#x3C; 6.0</summary>

В версиях 5.3 и ниже для создания пользователя с правами администратора или сервисного пользователя назначьте ему роль `CLIENT` и установите true в соответствующем флаге:

* `is_admin` дает пользователю права администратора в рамках своей компании.
* &#x20;`is_service` предназначен для создания сервисных пользователей учётных записей для входа автоматизированным способом. При авторизации под таким пользователем выдаётся токен с долгим временем жизни (по умолчанию 5 лет). Время жизни токенов для обычных пользователей составляет 15 минут (параметризуется), по умолчанию время жизни токенов продлевается при каждом обращении (параметризуется).

</details>

Подробное описание уровней доступа приведено ниже.

#### Компания

<table data-header-hidden><thead><tr><th></th><th width="111"></th><th width="150"></th><th width="132"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>-</td><td>+</td><td>-</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>данные своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>-</td><td>данные своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>-</td><td>данные своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>-</td><td>данные своей компании</td><td>данные своей компании</td><td>данные своей компании</td></tr></tbody></table>

#### Папка

<table data-header-hidden><thead><tr><th width="172"></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>+</td><td>+</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>свои папки</td><td>свои папки</td><td>свои папки</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Шаблон отчета

<table data-header-hidden><thead><tr><th width="171"></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>+</td><td>+</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>в рамках своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>-</td><td>в рамках своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Приложения к шаблону отчета

<table data-header-hidden><thead><tr><th width="170"></th><th width="192"></th><th width="158"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>+</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Отчет

<table data-header-hidden><thead><tr><th width="169"></th><th width="148"></th><th width="164"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>+</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>по своим папкам</td><td>в своих папках</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Анализ

<table data-header-hidden><thead><tr><th width="163"></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>+</td><td>+</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>в своих папках</td><td>в своих папках</td><td>-</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Коллекция

<table data-header-hidden><thead><tr><th></th><th width="125"></th><th width="154"></th><th width="132"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>-</td><td>+</td><td>-</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>в рамках своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>-</td><td>в рамках своей компании</td><td>-</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Персона

<table data-header-hidden><thead><tr><th width="164"></th><th width="160"></th><th></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>-</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Фото персоны

<table data-header-hidden><thead><tr><th width="161"></th><th width="148"></th><th width="176"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>-</td><td>+</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>-</td><td>в рамках своей компании</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>

#### Пользователь

<table data-header-hidden><thead><tr><th width="162"></th><th width="116"></th><th width="140"></th><th width="149"></th><th></th></tr></thead><tbody><tr><td><br></td><td>Создание</td><td>Чтение</td><td>Обновление</td><td>Удаление</td></tr><tr><td>ADMIN</td><td>+</td><td>+</td><td>+</td><td>+</td></tr><tr><td>OPERATOR</td><td>-</td><td>+</td><td>свои данные</td><td>-</td></tr><tr><td>CLIENT</td><td>-</td><td>свои данные</td><td>свои данные</td><td>-</td></tr><tr><td>CLIENT SERVICE</td><td>-</td><td>в рамках своей компании</td><td>свои данные</td><td>-</td></tr><tr><td>CLIENT  OPERATOR</td><td>-</td><td>в рамках своей компании</td><td>свои данные</td><td>-</td></tr><tr><td>CLIENT ADMIN</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td><td>в рамках своей компании</td></tr></tbody></table>


---

# 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-razrabotchika/api/oz-api/user-roles.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.
