Коннектор, тип universalAPI

Название

Уникальное имя ресурса. Максимальная длина имени составляет до 128 символов в кодировке Unicode.

Обязательный параметр.

Тенант

Название тенанта, которому принадлежит ресурс.

Обязательный параметр.

Тип

Тип коннектора – universalAPI.

Обязательный параметр.

Теги

Теги для поиска ресурса.

Необязательный параметр.

Описание

Описание ресурса. Максимальная длина описания составляет до 4000 символов в кодировке Unicode.

URL

URL-адрес REST API сервера. Указывать протокол подключения (http или https) не нужно. Он определяется автоматически в зависимости от значения параметра tlsMode. Вы можете указать только один URL-адрес.

Обязательный параметр.

Интервал запросов (сек.)

Интервал опросов заданного URL, в секундах. Укажите число от 60 до 86 400 (то есть от 1 минуты до 24 часов). Значение по умолчанию: 3600.

HTTP метод

HTTP-метод запроса к API. Доступные значения:

• GET.
• POST.
• PUT.
• DELETE.

Обязательный параметр.

Авторизация

Способ авторизации для подключения к API. Доступны следующие способы авторизации:

• Выключена. Авторизация не используется.
• Обычная. Авторизация по логину и паролю. Нужно использовать секрет типа credentials.
• Токен. Авторизация по токену. Нужно использовать секрет типа token.

Подробную информацию можно найти в разделе о секретах.

Значение по умолчанию: Выключена.

Если на вкладке Дополнительные параметры в поле Режим TLS выбрано значение Нестандартный PFX, поле Авторизация будет недоступно.

Идентификатор секрета

Поле доступно, если в поле Авторизация выбрано значение Обычная. Нужно выбрать секрет типа credentials.

Обязательный параметр.

Токен

Поле доступно, если в поле Авторизация выбрано значение Token. Нужно выбрать секрет типа token.

Обязательный параметр.

Название токена

Поле доступно, если в поле Авторизация выбрано значение Token. Доступные значения:

• Bearer.
• OAuth.

Вы также можете указать название вручную.

Обязательный параметр.

Тело запроса

Тело HTTP-запроса. Вы можете также использовать переменные: $token, $username, $password, $identityValue.

Путь к данным в формате JSONPath

Путь к данным в структуре ответа API, указывающий на объект или список объектов.

Путь задается в формате JSONPath (например, $.data, $.data.edges[0].node.event, $.data.edges[*].node.event).

Если в ответе API ожидается обычная строка или число, укажите в качестве пути символ $. Если при этом будет выключен параметр Поле Identity и не будут настроены параметры итераций, то данные будут переданы в нормализатор без изменения.

Обязательный параметр.

Поле Identity

Переключатель для включения уникального идентификатора, по которому будут отбираться события. По умолчанию переключатель выключен.

Путь к полю в формате JSONPath

Поле доступно, если переключатель Поле Identity включен.

Путь к полю идентификатора в структуре элемента данных ответа API задается в формате JSONPath (например, $.id).

Обязательный параметр.

Тип

Поле доступно, если переключатель Поле Identity включен.

Тип поля идентификатора, по которому будут отбираться события. Доступные значения:

• int.
• float.
• string.
• date.

  Внутри системы значение хранится в виде метки времени в миллисекундах.

Обязательный параметр.

Формат даты

Поле доступно, если в поле Тип выбрано значение date.

Формат даты может содержать дату, время, доли секунды и временную зону, например YYYY-MM-DDTHH:mm:ssX.

Заданный формат применяется:

• Для парсинга начального значения идентификатора.
• Для парсинга значений идентификатора из ответов REST API. Если формат даты содержит временную зону, значение обрабатывается в указанной временной зоне. Если формат даты не содержит временную зону, значение обрабатывается в UTC.
• Для формирования строки даты для параметров запроса (например, $identityValue в queryParams, headers, body). Если формат даты содержит временную зону, строка формируется во временной зоне сервера. Если формат даты не содержит временную зону, строка формируется в UTC.

Начальное значение

Поле доступно, если переключатель Поле Identity включен.

Начальное значение поля идентификатора задается в виде строки в формате, соответствующем выбранному типу в поле Тип. Для типа date нужно указать значение в формате, указанном в поле Формат даты.

Значение может содержать символы Unicode. Минимальная длина – 1 символ.

Параметры итераций

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

Путь к полю с ключом итерации в формате JSONPath

Путь к полю ключа итерации в структуре элемента ответа API в формате JSONPath.

Обязательный параметр.

Интервал запросов в режиме итераций (сек.)

Интервал опроса URL в режиме итерации, в секундах. Максимальное значение: 86 400 (24 часа).

Значение по умолчанию: 60.

Параметр URL для ключа итерации

Имя параметра URL, в котором передается ключ итерации при запросе к API.

Необязательные параметры запроса

Дополнительные параметры запроса в формате map[string][]string. Вы можете также использовать переменные: $token, $username, $password, $identityValue.

Для добавления параметра нажмите на кнопку + Добавить и заполните поля Ключ и Значение. Для удаления параметра установите рядом с ним флажок и нажмите на кнопку Удалить.

Если включена итерация и в состоянии есть ключ итерации, он автоматически подставляется в параметры запроса.

Заголовки запроса

Опциональные заголовки HTTP-запроса в формате map[string][]string. Вы можете также использовать переменные: $token, $username, $password, $identityValue.

Для добавления параметра нажмите на кнопку + Добавить и заполните поля Ключ и Значение. Для удаления параметра установите рядом с ним флажок и нажмите на кнопку Удалить.

Дополнительные поля

Дополнительные поля, которые добавляются в каждый элемент данных, в формате map[string][]string.

Для добавления полей нажмите на кнопку + Добавить и заполните поля Название поля и JSONPath. Для удаления поля установите рядом с ним флажок и нажмите на кнопку Удалить.

Отладка

Переключатель, включающий режим отладки для коннектора. По умолчанию выключен.

Кодировка символов

Кодировка символов. По умолчанию выбрано значение UTF-8.

Прокси-сервер

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

Режим TLS

Режим шифрования TLS. При использовании шифрования TLS вы не можете указать IP-адрес в поле URL на вкладке Основные параметры. Доступные значения:

• Выключено – не использовать шифрование TLS. Это значение выбрано по умолчанию.
• Включено – использовать шифрование TLS, но без верификации сертификатов.
• Нестандартный CA – использовать шифрование TLS с верификацией сертификата, подписанного центром сертификации. При выборе этого значения в раскрывающемся списке Нестандартный CA укажите секрет с сертификатом, подписанным центром сертификации. Вы можете выбрать существующий секрет или создать новый секрет. Для создания нового секрета выберите значение Создать.

  Если вы хотите изменить параметры существующего секрета, нажмите рядом с ним на значок карандаша .

  Как создать сертификат, подписанный центром сертификации?

  Вы можете создать сертификат, подписанный центром сертификации, на сервере Ядра KUMA (в примерах команд ниже используется OpenSSL).

  Чтобы создать сертификат, подписанный центром сертификации:

  1. Создайте ключ, который будет использоваться центром сертификации, например:

     openssl genrsa -out ca.key 2048

  2. Создайте сертификат для созданного ключа, например:

     openssl req -new -x509 -days 365 -key ca.key -subj "/CN=<общее имя хоста центра сертификации>" -out ca.crt

  3. Создайте приватный ключ и запрос на его подписание в центре сертификации, например:

     openssl req -newkey rsa:2048 -nodes -keyout server.key -subj "/CN=<общее имя хоста сервера KUMA>" -out server.csr

  4. Создайте сертификат, подписанный центром сертификации. Вам нужно включить в переменную subjectAltName доменные имена или IP-адреса сервера, для которого вы создаете сертификат, например:

     openssl x509 -req -extfile <(printf "subjectAltName=DNS:domain1.ru,DNS:domain2.com,IP:192.168.0.1") -days 365 -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial -out server.crt

  5. Загрузите созданный сертификат server.crt в веб-интерфейсе KUMA в секрет с типом certificate, после чего в раскрывающемся списке Нестандартный CA выберите секрет с типом certificate.
• Нестандартный PFX – использовать шифрование TLS с PFX-секретом. Вам нужно сформировать PFX-сертификат с закрытым ключом в формате PKCS#12-контейнера, после чего загрузить PFX-сертификат в веб-интерфейс KUMA в виде PFX-секрета. При выборе этого значения в раскрывающемся списке Нестандартный PFX укажите PFX-секрет с сертификатом, подписанным центром сертификации. Вы можете выбрать существующий PFX-секрет или создать новый PFX-секрет. Для создания нового PFX-секрета выберите значение Создать.

  Если вы хотите изменить параметры существующего секрета, нажмите рядом с ним на значок карандаша .

  Как создать PFX-секрет

  Чтобы создать PFX-секрет:

  1. В поле Название введите название PFX-секрета.
  2. Нажмите на кнопку Загрузить PFX и выберите файл в формате PKCS#12-контейнера, в который вы экспортировали файл PFX с закрытым ключом.
  3. В поле Пароль введите пароль для защиты файла PFX, указанный в мастере экспорта PFX.
  4. Нажмите на кнопку Создать.

  PFX-секрет будет создан и отобразится в раскрывающемся списке PFX секрет.

Время ожидания запроса (сек.)

Период ожидания ответа на запрос к API, в секундах. По умолчанию время ожидания ответа составляет 30 секунд.

Количество повторных запросов

Количество повторных попыток выполнить запрос при появлении ошибки.

Значение по умолчанию: 1.

Интервал повторных запросов (сек.)

Интервал между повторными попытками запроса, в секундах.

Значение по умолчанию: 0.