Настройка узла REST

Окно настроек узла REST содержит три вкладки: Входные данные, Выходные данные, Общие.

Вкладка Входные данные позволяет выбрать источники данных для параметров curl запроса, представленных в столбце Ключ.

rest config1.rus

Если опция По умолчанию включена, то столбец Имя колонки становится неактивным. В таком случае для работы узла необходимо, чтобы имя ключа совпадало с именем колонки исходной таблицы данных.

Следующие параметры curl запроса используются в столбце Ключ:

  • Authentification by agent - libcurl пытается подключиться к ssh-агенту или pageant и предоставляет агенту возможность попытки аутентификации.

  • Any authentification - если включено, PolyAnalyst подбирает подходящую битовую маску из других флагов аутентификации.

  • Authentification by password- битмаска для константы password.

  • Authentification by public key - битмаска для константы publickey.

  • Connect timeout - таймаут установления соединения; по умолчанию значение берется из настроек сервера.

  • Request cookies - куки, передающиеся в запрос, через точку с запятой, например extdebug=0; sid=6383038353749804524; underdev=1.

  • Follow_location - длинный параметр, имеющий значение 1, выполняет переадресацию заголовка Location, который сервер отправляет как часть заголовка HTTP при ответе 3xx. Заголовок Location может указать относительный или абсолютный URL для переадресации.

  • Request headers - любые заголовки запроса, например content-type: application/json.

  • Any HTTP authentification - вспомогательный макрос, устанавливающий все биты, при этом libcurl выбирает нужный бит. libcurl автоматически выбирает наиболее безопасный.

  • Any safe HTTP authentification - вспомогательный макрос, устанавливающий все биты, кроме Basic, при этом libcurl выбирает нужный бит. libcurl автоматически выбирает наиболее безопасный.

  • HTTP basic authentification - базовая аутентификация; выбирается по умолчанию; используется и поддерживается практически повсеместно; отправляет имя пользователя и пароль по сети в виде простого текста.

  • HTTP bearer (JWT) authentification - аутентификация HTTP по токену Bearer, которая используется в основном в протоколе OAuth 2.0.

  • HTTP digest authentification - дайджест-аутентификация HTTP; дайджест-аутентификация определяется в RFC 2617 и является более безопасным способом аутентификации в публичных сетях по сравнению с традиционным методом базовой аутентификации.

  • HTTP digest authentification (IE-compatible) - дайджест-аутентификация HTTP с IE ; дайджест-аутентификация определяется в RFC 2617 и является более безопасным способом аутентификации в публичных сетях по сравнению с традиционным методом базовой аутентификации. Добавление IE приводит к тому, что libcurl использует особую хитрость, которая использовалась в IE до 7 версии и которая требуется от некоторых клиентов.

  • HTTP negotiate authentification - аутентификация HTTP Negotiate (SPNEGO); negotiate-аутентификация определяется в RFC 4559 и является наиболее безопасным способом аутентификации по HTTP.

  • HTTP NTLM authentification - аутентификация HTTP NTLM; протокол, разработанный и используемый Microsoft. Во избежание перехвата пароля используется аутентификация с запросом и ответом и хеширование, похожие на дайджест-аутентификацию.

  • HTTP NTLM authentification with Winbind* - аутентификация NTLM с помощью хелпера winbind. Аутентификация выполняется отдельным бинарным приложением, которое запускается при необходимости. Имя приложения определяется на этапе компиляции, обычно это /usr/bin/ntlm_auth.

  • HTTP only cookies - метасимвол. ИЛИ это значение вместе со значением единичной специальной аутентификации приводит к тому, что libcurl пытается выполнить неограниченную аутентификацию, и при неудачной попытке принимается только этот алгоритм с единичной аутентификацией.

  • Insecure - определяет, используется ли сертификат с HTTPS: если аргумент равен "yes", то для использования защищенного протокола HTTPS не требуется корректный сертификат.

  • Cookies container - передает куки между вызовами curl. В аргументе указывается имя куки-контейнера в проекте.

  • Maximum delay - максимальная задержка в миллисекундах, которая должна быть выдержана между подключениями к одну и тому же серверу; минимальное время равно половине максимального времени.

  • Maximum redirections - устанавливает максимальное количество принимаемых редиректов.

  • HTTP method - используемый метод HTTP, по умолчанию GET.

  • Password - устанавливает пароль для аутентификации, завершающееся нулевым символом.

  • Post data - любые данные запроса, которые передаются не в командной строке. Запрос автоматически становится POST-запросом.

  • Transfer_timeout - таймаут передачи данных, по умолчанию значение берется из настроек сервера.

  • URL - адрес ресурса.

  • User name - устанавливает имя пользователя для аутентификации, завершающееся нулевым символом.

  • User name and password - определяет строку с информацией о входе в систему для подключения в формате [имя пользователя]:[пароль].

  • OAuth 2.0 bearer token - задает токен доступа OAuth 2.0 Bearer Access Token для использования с серверами HTTP, IMAP, POP3 и SMTP, поддерживающими фреймворк авторизации OAuth 2.0.

При выборе источника данных в столбце Имя колонки для запроса будет использовано значение заголовка указанной колонки из исходной таблицы данных.

Если поставлена галочка в столбце Значение, то для запроса используется содержание указанной колонки из исходной таблицы данных.

В качестве примера на скриншоте ниже из выпадающего меню выбраны колонки из исходной таблицы данных для соответствующих ключей:

rest input data.rus

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

rest config2.rus
  • Response Cookies, formatted as array (Файлы cookie ответа в формате массива JSON). По умолчанию имя колонки Cookies.

  • Response headers, formatted as array (Заголовки ответа в формате массива JSON). По умолчанию имя колонки Headers.

  • Raw content as returned from the remote service (Необработанное содержимое, возвращаемое удаленной службой). По умолчанию имя колонки Raw.

  • Valuable text, extracted from the response (Подходящий текст, извлеченный из ответа). По умолчанию имя колонки Text.