Авторизация запросов к Облаку Эвотор

Редактировать

Все запросы к Облаку Эвотор осуществляются в рамках приложения. После установки приложения в Личном кабинете, Облако присваивает ему токен Облака Эвотор, уникальный для пары приложение-пользователь.

Передавайте этот токен в заголовке Authorization, чтобы авторизовать свои запросы к Облаку.

Токен Облака можно получить вручную или автоматически.

Добавьте корневой SSL-сертификат Минцифры

В марте 2022 года истекает срок действия текущего SSL-сертификата облака Эвотор. Для подготовки к миграции на отечественные сертификаты заранее добавьте в свои сервисы корневой сертификат Минцифры:

Получение токена Облака вручную

Чтобы получить токен Облака Эвотор вручную:

  1. В Личном кабинете разработчика выберите черновик необходимого приложения и перейдите на вкладку Интеграция.

  2. В разделе Настройки приложения, включите опцию Создать вкладку “Настройки” на странице приложения.

    Опция добавляет вкладку Настройки для приложения установленного в Личном кабинете пользователя Эвотор.

  3. Нажмите кнопку Текстовое поле, в поле Значение поля укажите ${token}.

  4. Сохраните изменения и переведите черновик в тестирование.

  5. В Личном кабинете пользователя Эвотор, на вкладке Мои приложения, выберите приложение, в котором были сделаны изменения.

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

  6. Перейдите на вкладку Настройки.

На вкладке будет отображаться поле с токеном Облака Эвотор.

Автоматическое получение токена Облака

Чтобы автоматически получать токен Облака Эвотор:

  1. Поддержите в своём сервисе эндпоинт https://<yourserver.ru>/api/v1/user/token.

    После установки приложения, на указанный адрес Облако передаёт токен Облака Эвотор. Запросы облака необходимо авторизовать с помощью токена приложения стороннего сервиса.

  2. В Личном кабинете разработчика выберите черновик необходимого приложения и перейдите на вкладку Интеграция.

  3. Включите опцию Токен приложения для доступа к REST API Эвотор.

  4. В поле URL, укажите адрес эндпоинта https://<yourserver.ru>/api/v1/user/token, на который Облако будет передавать токен.

  5. Выберите тип авторизации, с помощью которого ваш сервис будет авторизовать запрос от Облака Эвотор.

    • Если вы выбрали С помощью токена. В поле Токен, укажите токен стороннего сервиса.

      Облако передаёт токен в заголовке Authorization.

    • Если вы выбрали Запрос логина и пароля (Basic Auth). В полях Логин и Пароль укажите данные для доступа к стороннему сервису.

      Облако кодирует логин и пароль с помощью base64 и передаёт закодированные данные в заголовке Authorization.

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

После того, как пользователь Эвотора установит ваше приложение, Облако передаст токен на указанный эндпоинт.