Учётная запись интеграции и права доступа
Учётная запись интеграции представляет сотрудника, от имени которого другая программа обращается к TesLab. Вход подтверждает его личность. Права определяют доступные методы и действия, а условия конкретного метода определяют доступные записи.
Успешный auth/check не разрешает автоматически создавать заявки, изменять протоколы или скачивать любые файлы. Ниже показано, как подготовить отдельную запись, выдать нужные права и проверить подключение. Адреса и номера в примерах условные.
В этой статье
Подготовить учётную запись
- Назначьте ответственного за подключение и составьте список нужных операций: список, карточка, создание, изменение, загрузка или скачивание файла.
- Создайте отдельную запись сотрудника по инструкции Новый сотрудник: регистрация учётной записи. Отдельного обязательного типа пользователя «Интеграция» для такого входа нет.
- Оставьте режим «Администратор» выключенным. Согласуйте с администратором TesLab минимальные права для выбранных операций.
- Получите точный адрес API нужной организации, включая порт и префикс пути, если они используются. Сохраните ожидаемый ID пользователя этой установки.
- Подготовьте разрешённые тестовые записи и заранее согласованные отрицательные сценарии. Определите, кто будет проверять обмен после изменения прав и отключать запись, когда подключение больше не нужно.
Проверяйте обмен под этой служебной записью. Успешный запрос администратора не подтверждает, что интеграционная запись настроена правильно.

Выбрать сервер и способ подключения
В приложении используется единая форма входа. Введите логин и сервер через @, например integration@ucheb, или email, привязанный к вашей учётной записи. Сначала приложение проверяет вход по логину и серверу.
Если введён корректный email, а сервер недоступен или для домена не найден адрес TesLab, приложение пробует вход по почте. При необходимости подтвердите email кодом из письма и выберите организацию. Код открывает доступ к выбору привязанной записи, пароль проверяет выбранный сервер TesLab. Неверный пароль, отказ в доступе и ограничения частоты не запускают подбор другой организации.

У одного email могут быть привязки к разным организациям. Проверяйте выбранную организацию и фактическую учётную запись. Права принадлежат записи в конкретной установке.
Для внешнего скрипта нужен точный адрес API. Запрос к auth/gettoken сам не повторяет автоматический подбор из формы приложения. Настройте сервер и получение токена по инструкции Авторизация по логину и паролю, затем сверяйте пару «адрес API + ID пользователя». Для HTTP Basic используйте отдельную инструкцию. Общий адрес страницы приложения и псевдоним входа могут отличаться от адреса API.
Выберите подходящий контур подключения:
- Основной API сотрудника. Использует запись сотрудника, его права и ограничения отдела. Это основной сценарий этой статьи.
- Кабинет контрагента. Использует отдельную авторизацию контактного лица и условия доступа его организации и собственных данных.
- Кабинет ОДС. Использует отдельный тип сессии и свои обработчики.
- Входящий обработчик по ключу. Принимает обращения настроенной АТС или другой интеграции. Ключ действует для своего входа и не заменяет пользовательский токен основного API.
Для портального контура используйте его конкретную спецификацию. Замена части URL основного метода на адрес портала не гарантирует тот же формат запроса и ответа.
Настроить основные и дополнительные права
- Администратор открывает нужного сотрудника в разделе «Сотрудники» и переходит к его правам доступа. Подробный порядок описан в статье Настройка прав доступа.
- Найдите точный метод через поиск по названию или API-пути. Отметка доступа к разделу не заменяет проверку нужных операций.
- Выдайте основное право и выберите подходящее ограничение. Например, у карточки лабораторной заявки есть варианты «Без ограничений» и «Только свои».
- Если метод имеет дополнительные отметки, включите только нужные действия. Сверьте права отдела и личные настройки сотрудника.

Основной уровень и дополнительные отметки учитываются отдельно. Когда личной настройки основного уровня нет, применяется право отдела. При наличии личной записи её уровень имеет приоритет. Дополнительные отметки отдела и сотрудника объединяются, но действуют вместе с разрешённым основным правом.
На примере ниже сотруднику разрешено редактирование протоколов. От отдела унаследована отметка «Ставить статус "В работе"», лично выдана отметка «Отправлять на утверждение». Набор прав выбирают под задачи конкретной интеграции.

В ответе получения токена карта находится в access. Значения по API-путям задают уровни, ключи rx__ содержат дополнительные отметки. Эта карта помогает настроить интерфейс; окончательное решение принимает сервер при каждом предметном запросе. Сохранённая карта может устареть после изменения прав.
Не используйте одну числовую шкалу для всех методов. Ограничение может означать авторство, участие или закреплённые объекты. Доступ к списку не означает доступ к правке, а дополнительная отметка не заменяет основное право.
Сопоставить права с операциями
Для каждой операции проверьте право, область данных и предметные условия. Примеры:
| Операция | Право | Дополнительные условия |
|---|---|---|
| Карточка контрагента | customers/info | Сведения могут учитывать историю реквизитов и запускать сверку с ЕГРЮЛ. |
| Карточка заявки ИЛ | laboratory/requests/info | Ограничение «Только свои» сужает выборку по автору. Чтение может пересчитывать состояние и запускать автоматическое формирование акта. |
| Создание диспетчерской заявки | maintenance/requests/add | Нужен существующий лифт. Требование действующего договора зависит от настройки «Заявки на лифты без действующего договора»; действуют и другие проверки заявки. |
| Правка диспетчерской заявки | maintenance/requests/edit | Могут учитываться закрепление, участок, дежурство, закрытие и отдельные действия. |
| Обмен с 1С | 1c | Одно предметное право на модуль обмена, включая его очереди. Выдавайте его только записи, которой поручен этот обмен. |
Дополнительно учитывайте лицензию нужного модуля и текущее состояние записи. Изменять договорные правила или расширять права только ради исчезновения ошибки не следует.
Проверить личность и права
Сначала проверьте сеанс. Направьте запрос на согласованный сервер:
POST https://lab.example/api/auth/check
auth: YOUR_AUTH_TOKEN
Lang: ru
Out: json
Проверьте HTTP-код, JSON и ожидаемый ID пользователя. У auth/check данные пользователя находятся в корне ответа. Сокращённый пример:
{
"id": 900301,
"login": "integration-demo",
"adm": 0
}
Сравните id с ID подготовленной интеграционной записи на этом сервере. Сам HTTP 200 не подтверждает нужную личность. Проверка сеанса обновляет служебные сведения о его использовании и может продлевать токен, но не выдаёт дополнительные права на методы.
Затем проверьте согласованную предметную операцию. Перед примером ниже выберите тестовую лабораторную заявку: открытие laboratory/requests/info может пересчитать её состояние и при определённых условиях запустить формирование акта.
POST https://lab.example/api/laboratory/requests/info
auth: YOUR_AUTH_TOKEN
Content-Type: application/json
Lang: ru
Out: json
{"id":900101}
В успешном ответе этого метода карточка находится в res. Проверьте, что res.id совпадает с запрошенным ID, а данные относятся к нужной записи.
- Проверьте разрешённую запись и нужный результат под интеграционной учётной записью.
- В согласованном тестовом сценарии проверьте отказ по методу, на который право не выдавалось.
- При ограниченной области проверьте запись вне этой области. Например, чужая лабораторная заявка при «Только свои» может возвращаться как ненайденная.
- Повторите проверку после изменения прав или отдела. Для отключения записи проверьте, что прежняя сессия больше не допускает рабочие операции.
Пример запроса и разбор первого ответа подробнее приведены в статье API TesLab: адрес сервера и первый запрос. Отказ доступа обрабатывайте как нормальный предусмотренный результат, без автоматического расширения роли.
Разобрать отказ в доступе
- Неверные данные входа. Проверьте учётную запись, выбранную организацию и пароль. Отказ пароля может сопровождаться HTTP 403 и причиной
AUTH_INVALID_CREDENTIALS. Выдача дополнительных прав здесь не поможет. - 401 или 419 при обращении с токеном. Проверьте состояние пользователя и сеанса, блокировку, отзыв и срок токена.
- 403 при предметной операции. Проверьте право на точный метод и дополнительное действие. Учитывайте ограничения IP и режим обслуживания сервера.
- 404. Проверьте путь, ID и область доступных записей. Такой ответ возможен и для существующей записи вне разрешённой области.
- 400. Проверьте параметры и предметные условия. Например, отсутствие подходящего договора может быть ошибкой условий создания заявки, а не отсутствием права.
- 429 или сообщение о лимите. Соблюдайте указанную паузу и остановите частые повторы. Ограничение проверки адреса или почты не является поводом перебирать организации.
- 5xx или ответа нет. Проверьте доступность сервера. Если результат записывающей операции неизвестен, сначала выясните, была ли она выполнена.
Для портального контура дополнительно проверьте доступ организации и контактного лица. При диагностике сохраняйте сервер, время, метод, HTTP-код и безопасные поля reason, title, mess. Не передавайте пароль, токен и полное содержимое рабочей записи.
Проверить готовность рабочего обмена
- Назначены ответственный и отдельная действующая учётная запись.
- Зафиксированы точный сервер API и ожидаемый ID пользователя.
- Выданы только согласованные основные права и дополнительные действия.
- Проверены разрешённый результат и ожидаемые отказы на тестовых данных.
- Определены обработка ошибок, проверка неизвестного результата и порядок повторной проверки после изменения доступа.
- Подготовлен порядок завершения сессии и отключения учётной записи, когда обмен больше не нужен.
До рабочего обмена проверьте сценарий в согласованной тестовой среде. Управление токеном описано в статье Срок действия токена, проверка и завершение сессии, отключение и восстановление записи в статье Увольнение и восстановление сотрудника.
Связанные материалы
- Авторизация по логину и паролю
- Новый сотрудник: регистрация учётной записи
- Настройка прав доступа
- Срок действия токена, проверка и завершение сессии
- HTTP Basic для серверных интеграций
- Параметры запросов: JSON, формы, типы и заголовки
- Каталог методов по разделам и выбор нужной операции
- Ключи входящих интеграций