Настройка аутентификации в "Визионе"

При взаимодействии ядра "Спектра" с API "Визиона" используется аутентификация по токену. Для настройки аутентификации необходимо выполнить следующие действия:

  1. Получить токен аутентификации "Визиона". Для этого нужно выполнить API-запрос с типом POST на адрес:

    URL_ВИЗИОНА/vision/api/v1/auth/token/?name=ИМЯ_ТОКЕНА

    Имя токена можно выбрать произвольное.

    Ответ на успешный запрос должен иметь следующее содержание:

    {
      "status": "success",
      "data": {
        "jti": "03a4...",
        "name": "ИМЯ_ТОКЕНА",
        "created_at": "2024-06-04T11:15:05.809707+03:00",
        "token": "ТОКЕН_АУТЕНТИФИКАЦИИ"
      },
      "pagination": null,
      "message": null,
      "error": null
    }
  2. Если токен отсутствует, его можно создать через интерфейс "Визиона".

    Для создания токена в интерфейсе пользователя "Визион" перейти в раздел Безопасность  Токены доступа, где необходимо ввести имя токена и нажать кнопку Сгенерировать, которая становится активной после ввода имени токена. Будет отображено поле со значением сгенерированного токена:

    image$vision token

    Сгенерированный токен необходимо сразу скопировать и использовать в дальнейшем при настройке "Спектра", так как впоследствии он не будет отображаться, в разделе "Токены доступа" будут отображаться только имена созданных токенов.

    Подробнее о создании токенов см. Руководство пользователя "Визион", раздел Токены для внешних систем  Создание токена.

  3. Сохранить значение токена в файле с секретами.

    В файл с зашифрованными секретами, расположенный на хосте "Спектра" по пути /opt/skala-r/spectrum/.vault_store, необходимо добавить строку:

    vision_token: ТОКЕН_АУТЕНТИФИКАЦИИ

    Для этого выполнить следующие команды:

    source /opt/skala-r/spectrum/python-modules/bin/activate
    ansible-vault edit /opt/skala-r/spectrum/.vault_store
  4. Ввести пароль хранилища, после чего будет открыт текстовый редактор.

    После сохранения файла нужно проверить корректность настройки секции "Визион" в файле конфигурации spectrum-api /opt/skala-r/etc/spectrum/spectrum-api/config.conf. Секция "Визион" должна иметь вид:

    [vision_config]
    host=192.168.191.61
    port=8088
    base_url=/vision/api/v1/tsdb
    cert=
    ;client_cert=/opt/skala-r/spectrum/certs/client.crt
    ;client_key=/opt/skala-r/spectrum/certs/client.key
  5. Перезапустить сервис spectrum-api с помощью команды:

    systemctl restart spectrum-api.service