Настройка узла REST
Окно настроек узла REST содержит три вкладки: Входные данные, Выходные данные, Общие.
Вкладка Входные данные позволяет выбрать источники данных для параметров curl запроса, представленных в столбце Ключ.
Если опция По умолчанию включена, то столбец Имя колонки становится неактивным. В таком случае для работы узла необходимо, чтобы имя ключа совпадало с именем колонки исходной таблицы данных.
Следующие параметры 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.
При выборе источника данных в столбце Имя колонки для запроса будет использовано значение заголовка указанной колонки из исходной таблицы данных.
Если поставлена галочка в столбце Значение, то для запроса используется содержание указанной колонки из исходной таблицы данных.
В качестве примера на скриншоте ниже из выпадающего меню выбраны колонки из исходной таблицы данных для соответствующих ключей:
Вкладка Выходные данные позволяет задать имена выходных колонок узла. Если включена опция По умолчанию, то используются значения по умолчанию.
-
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.