С версии 20.56 Платформы НЕЙРОСС добавлена поддержка API-токенов — безопасного способа авторизации внешних систем и интеграций без передачи пароля пользователя.
Зачем это нужно
Доступ к HTTP API Платформы возможен двумя способами: по учётной записи (логин и пароль) или по API-токену. Для программных интеграций второй вариант удобнее и безопаснее:
- Без пароля — во внешние системы не передаётся пароль учётной записи;
- Ограниченные права — токен наследует права выбранного пользователя;
- Гибкое управление — для одного пользователя можно выпустить несколько токенов с разными сроками действия;
- Простой отзыв — скомпрометированный токен удаляется без смены пароля.
Что даёт API
При наличии соответствующей лицензии API Платформы НЕЙРОСС позволяет:
- Работать с функциональными элементами — мониторинг состояний и управление элементами сети;
- Работать с событиями — вычитывание «живых» и архивных событий (СКУД, ОТС и др.);
- Работать с медиаданными — получение «живого» видео, снимков и видеоархивов, PTZ-управление (в том числе переключение препозиций), экспорт видеофрагментов, создание и удаление задач на запись.
API-токен — рекомендуемый способ авторизации для таких сценариев: внешняя система получает доступ к нужным функциям, не используя пароль пользователя.
Как это работает
- Администратор создаёт API-токен в приложении Пользователи, роли и права.
- Выбирает учётную запись, задаёт название и при необходимости — срок действия.
- Копирует сгенерированный токен — он отображается один раз.
- Внешняя система передаёт токен в HTTP-заголовке при каждом запросе.
Авторизация срабатывает только если лицензия активна и срок токена не истёк. По умолчанию токены не создаются — их выпускает администратор вручную.
Безопасность
Для обмена данными рекомендуется HTTPS. В составе Платформы есть встроенный HTTPS-сервер: при установке автоматически генерируются сертификат удостоверяющего центра и серверный сертификат. Сертификат CA в формате .crt доступен для скачивания через веб-сервер Платформы.
Как начать
- Убедитесь, что в лицензии включён параметр «Использование API-токенов авторизации».
- Откройте Пользователи, роли и права → раздел API-токенов.
- Нажмите Создать токен, выберите пользователя, задайте название и срок действия.
- Скопируйте токен сразу — восстановить его нельзя.
Относится к | Платформа НЕЙРОСС |
|---|---|
Документация |