ХОТКЕИ

F1 - Проверить проект
CTRL+S - Сохранить проект
CTRL+SHIFT+S - Сохранить проект на сервере
CTRL+R - Восстановить последний сохраненный проект
CTRL+SHIFT+R - Скачать и загрузить последний сохраненный проект на сервере
CTRL+F - Поиск по всем запросам

ПЕРЕМЕННЫЕ

|PARS| - Обычный парсер, нужно указывать индекс.
|REGEX| - Парсер по регулярке, нужно указывать индекс.
|REGEXGLUE| - Склеивает регулярки по индексам и добавляет разделитель между ними, количество индексов не ограничено. Пример: |REGEXGLUE|[1, | ,2, \ ,3]
|SIMPLEGLUE| - Склеивает регулярку по индексу и какое-то значение. Пример: |SIMPLEGLUE|[1, Пароль - |PWD|]
|REGEXCYCLE| - Цикличный парсер из результатов парсинга по регулярке, нужно указывать индекс полученного результата от парсера по регуляркам.
|PARSCYCLE| - Цикличный парсер по результатам обычного парсинга, нужно указывать индекс.
|CYCLE| - Создает цикличный запрос с диапазоном от и до. Пример: |CYCLE|[1-9]
|CUSTOMCYCLE| - Создает цикличный запрос по значениям, которые ввел клиент. Пример: https://google.com/?req=|CUSTOMCYCLE|[|DYNAMICSTR|(Ваша динамическая настройка)|DL|(разделитель для значений),]
|REGEXCOUNT| - Достает количество строк в результате от парсера по регулярке, нужно указывать индекс.
|VALUE| - Обращение к частям входных данных. Пример: |VALUE|[1] (Логин).
|LOGIN| - Логин.
|PWD| - Пароль.
|LOGIN|D| - Домен логина.
|LOGIN|ND| - Логин с убранным доменом.
|IP| - IP прокси сервера.
|PORT| - Порт прокси сервера.
|PROXYTYPE| - Тип прокси сервера.
|PROXY| - Возвращает полную строку прокси сервера (ip:port:user:password|type).
|PROXYLOGIN| - Возвращает логин прокси сервера.
|PROXYPWD| - Возвращает пароль прокси сервера.
|PROXYURI| - Возвращает полную строку прокси сервера в формате protocol://user:password@ip:port.
|REDIRECT| - Ссылка на последний редирект.
|USERAGENT| - Текущий юзерагент.
|RANDOMSTRING| - Хранит все сгенерированные данные командой |RANDOM|. Пример: |RANDOMSTRING|[2] - выдаст второй по счету сгенерированный текст.
|DV| - Обращение к динамической переменной. Пример: |DV|[Test].
|SB| - Обращение к динамической переменной для вставки куска кода в Скрипт-бокс. Пример: |SB|[Test].

ОПРЕДЕЛЕНИЯ

Полностью наследуют логику, все определения пишутся точно так же, как и логические операции.

|RESPONSE| - Ответ от сервера.
|HEADERS| - Заголовки от сервера.
|COOKIES| - Сохраненные куки.
|ALLOTHER| - Все другие ответы являются плохими (Применяется только в определении для плохого запроса).
|ID| - Идентификатор (Указывается при определениях). Пример: |ID|block|.

ЛОГИЧЕСКИЕ ОПЕРАТОРЫ

|OR| - Или. Пример: 1|>|2|OR|2|>|1. Результат: Истина, т.к. 2 больше 1.
|AND| - И. Пример: 1|>|2|AND|2|>|1. Результат: Ложь, т.к. 1 не больше 2.
|>| - Больше. Пример: 1|>|2 (Только численные значения). Результат: Ложь, т.к. 1 не больше 2.
|<| - Меньше. Пример: 1|<|2 (Только численные значения). Результат: Истина, т.к. 1 меньше 2.
|>=| - Больше равно. Пример: 1|>=|2 (Только численные значения). Результат: Ложь, т.к. 1 не больше равно 2.
|<=| - Меньше равно. Пример: 1|<=|2 (Только численные значения). Результат: Истина, т.к. 1 меньше равно 2.
|pos=0| - Подстрока не существует в строке. Пример: @mail.ru|pos=0|[email protected]. Результат: Ложь, т.к. значение @mail.ru находится в строке [email protected].
|pos>0| - Подстрока существует в строке. Пример: @mail.ru|pos>0|[email protected]. Результат: Истина, т.к. значение @mail.ru находится в строке [email protected].
|=| - Равно. Пример: 1|=|2 (Также можно использовать строковые значения). Результат: Ложь, т.к. 1 не равно 2.
|<>| - Не равно. Пример: 1|<>|2 (Также можно использовать строковые значения). Результат: Истина, т.к. 1 не равно 2.
( ) - Операторы, которые позволяют совершать сложные логические операции. Пример:
- Поиск писем|pos>0|Авторизация-Чекер-Поиск писем|OR|Авторизация-Чекер-Поиск писем|=|@mail.ru|pos>0|[email protected]|OR|@bk.ru|pos>0|[email protected]|OR|@list.ru|pos>0|[email protected]|OR|@mail.ua|pos>0|[email protected]|OR|@inbox.ru|pos>0|[email protected]
- Результат: Истина, т.к. подстрока “Поиск писем” существует в строке “Авторизация-Чекер-Поиск писем” и подстрока "@mail.ru" существует в строке "[email protected]".
|LFNC| - Экранизация символа (.
|RFNC| - Экранизация символа ).
|DOLOGIC| - Ставит блок лога под условие и выводит его в случае истины. Пример:
- |DOLOGIC|Чекер|pos>0||METHOD||ENDLOGIC|Баланс - |PARS|[1]|DOLOGIC|
- Если указан “Чекер” в динам настройках, тогда данный блок лога выведет в результат.
|LLR| - Хранит в себе историю результатов от логических операций. Пример: |LLR|[1]. Возвращает True или False, определения не сохраняют историю.
|LNS| - Запрещает сохранение истории. Пример: 1|>|2|OR|2|>1|LNS|. История в массиве |LLR| не сохранится.
|THIS| - Текущий парсер для логических правил парсеров.
|| - Начало линейного логического блока в Скрипт-боксе (он не выполняется прежде всего, а ждет своей очереди).

В логических операциях доступны все виды функций, переменных, а также значения динамических настроек.
Есть возможность вписать чисто одну команду. Пример: |DV|[logicField] - в данной динамической переменной хранится логическая операция, она рекурсивно интерпретируется и интерпретатор логических операций примет данную команду как логическую операцию.
Все результаты от логических операций хранятся в команде |LLR|. Команда |LNS| запрещает сохранение истории. Пример: 1|>|2|OR|2|>1|LNS|. История в массиве |LLR| не сохранится.

ЛОГИЧЕСКИЕ БЛОКИ

Логическая операция состоит из блоков. Пример:
1|>|2|OR|2|>|1. То, что между оператором |OR| является логическими блоками.

Логические блоки имеют свои команды:

|USEAG| - Указывается при определениях, обозначает, что при найденном проверяемом значении будет использоваться модуль.
|AGREPORT| - Указывается при определениях, обозначает, что если капча была введена неверно, тогда отправляется жалоба на нее в указанный сервис.

СКРИПТ-БОКС

Скрипт-бокс позволяет выполнять логические операции, логические блоки, функции и парсеры различных видов. Ниже описаны основные возможности и примеры использования.

Теги для многострочного кода

#beginScript - начало блока многострочного кода.
#endScript - конец блока многострочного кода.

Пример:
#beginScript
|PARS|[1] = test
message
#endScript
В итоге |PARS|[1] будет содержать значение - test
message

Операторы

Присваивание

Линейные логические блоки

|| - начало линейного логического блока. После него идет логическая операция.
Пример:
|||PARS|[1]|>|2
|PARS|[1] = |PARS|[1] руб.
|PARS|[2] = |PARS|[2] руб.
||END
||END - конец линейного логического блока. Если не указать данную команду, только первая строка будет считаться частью блока.

Критическая секция

Результаты

|CONCLUSION| - обозначение результата.

0 - плохой результат
1 - хороший результат
3 - капча/блок
99 - не подходящие под настройки

Пример: |CONCLUSION| = 0 устанавливает результат как “плохой”.

Пример полноценного скрипта

|DOLOGIC||PARS|[1]|>|0|ENDLOGIC|
|PARS|[1] = Есть баланс
|DOLOGIC|

|DOLOGIC||PARS|[1]|<>|Есть баланс|AND||PARS|[1]|<|0|ENDLOGIC|
|CONCLUSION| = 0
|DOLOGIC|

Пояснение:

В первом блоке: если парсер 1 больше 0, тогда |PARS|[1] присваивается значение “Есть баланс”.
Во втором блоке: если парсер 1 не равен “Есть баланс” и парсер 1 меньше 0, тогда результат равен 0 (плохой результат).

Работает только при хорошем ответе и в самую последнюю очередь (до вывода лога).

Подключение кода из динамических переменных

Для подключения кода, хранящегося в динамической переменной, используйте префикс |SB| вместо |DV|.

Специальная функция

|SCRIPTBOX| - позволяет использовать функционал Скрипт-бокса, включая все описанные возможности.

РАСШИРЕННАЯ СТАТИСТИКА

Пример настройки статистики:

Последняя строка |DEL||VALUE|[1];|VALUE|[2]
Колонки разделяются командой |DEL|

Расширенная статистика обновляется раз в 50 миллисекунд.
Если вы подсчитываете какие-либо данные, например: кол-во строк с цифрами, обязательно используйте глобальные переменные.

КОНТЕЙНЕР

Цикл WHILE - Повторяет запросы в контейнере до тех пор, пока срабатывает логическая операция.
Цикл FOR - Интервал значений, повторяет запросы в контейнере от значения и до значения. Значения разделяются командой |TO|. Пример: 1|TO||DV|[pagesCount] (цикл FOR резервирует переменную |COUNTER|, в которой хранится текущая итерация). Также разрешен интервал по убыванию чисел. Пример: 9|TO|1
Оператор IF - Ставит под условие запросы в контейнере.

Контейнер может распаковываться даже если результат будет плохой (|CONCLUSION| = 0), так как существует условие использования запроса в случае плохого результата. Если у вас до распаковки контейнера (именно первый запрос до запроса с контейнером) результат может выйти плохим, делайте условие при распаковке контейнера (|CONCLUSION||=|1, оператор IF) и в таком случае он будет распаковываться только в случае хорошего результата.

ФУНКЦИИ

Начальная функция должна указваться в скобках
Пример с несколькими функциями - (|MD5||BASE64||LOGIN||BASE64||MD5|)

Функции можно использовать в логических операциях:
((|UPPER||PARS|[1]||UPPER|)|=|ASD|OR||PARS|[1]|=|asd)|AND|(|PARS|[2]|=|DSA|OR|(|LOWER||PARS|[2]|
LOWER|)|=|dsa)

Функции могут принимать такой вид:
|MD5||BASE64||LOGIN||BASE64| - |MD5||PWD||MD5||MD5|
Фукнция(функция() функция())
Две функции внутри одной функции, так же в этих функциях тоже могут быть функции

Самые простые виды:
(|BASE64||LOGIN||BASE64|) - 1 параметр
(|UUIDV4||UUIDV4|) - без параметров
При вызове функции только начальная должна иметь скобки, для экранизации скобок используйте |LFNC| - “(” и |RFNC| - “)”

|MD5|

Описание:
Шифрование выделенной строки данным тегом в MD5.

|BASE64|

Описание:
Шифрование выделенной строки данным тегом в Base64.

|SHA1|

Описание:
Шифрование выделенной строки данным тегом в Sha1.

|SHA256|

Описание:
Шифрование выделенной строки данным тегом в Sha256.

|SHA512|

Описание:
Шифрование выделенной строки данным тегом в Sha512.

|FILETOBASE64|

Описание:
Шифрование файла по ссылке в Base64.

Пример использования:

|FILETOBASE64|https://captcha.com/images/captcha/botdetect3-captcha-ancientmosaic.jpg|FILETOBASE64|

|RANDOM|

Описание:
Генерирует рандомное значение по своей маске с длиной по диапазону.

Пример использования:

|RANDOM|ABC123(АЛФАВИТ СИМВОЛОВ)|1-9(ДИАПАЗОН ДЛИНЫ)|RANDOM|

Примеры:

Русский алфавит символов: |RANDOM|абвгдеёжзийклмнопрстуфхцчшщъыьэюяАБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ|1-9|RANDOM|
Английский алфавит символов: |RANDOM|abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ|1-9|RANDOM|
Алфавит цифр: |RANDOM|1234567890|1-9|RANDOM|

|LOWER|

Описание:
Перевод выделенной строки данным тегом в нижний регистр.

|UPPER|

Описание:
Перевод выделенной строки данным тегом в верхний регистр.

|FUPPER|

Описание:
Ставит первый символ в верхнем регистре.

|REMOVENUM|

Описание:
Убирает все цифры из строки.

|URLENCODE|

Описание:
URL-кодирует строку.

|URLDECODE|

Описание:
Декодирует строку в URL формате.

|FDSPACE|

Описание:
Удаляет все пустые символы с начала строки.

|EDSPACE|

Описание:
Удаляет все пустые символы с конца строки.

|SCRIPT|

Описание:
Запрос к скрипту на сервер, указанный в настройках.

|DEMPTYSTR|

Описание:
Удаляет пустые строки.

|DUPDEL|

Описание:
Удаляет дубликаты.

|GETLINE|

Описание:
Возвращает указанную строку.

Пример использования:

|GETLINE||PARS|[1],5|GETLINE|

|GETCHAR|

Описание:
Возвращает указанный символ.

Пример использования:

|GETCHAR||PARS|[1],5|GETCHAR|

|GETCOUNT|

Описание:
Достает количество строк.

|MATH|

Описание:
Математические уравнения, возможно делать очень сложные вычисления.

Пример уравнения:

21*v(34)+((58)/(12^13))*sin((343)/(?))

Дополнительная информация:
Используется библиотека TMS Analytix. Ссылка на документацию: TMS Analytix

Принимает дополнительный аргумент:

removeChars. Он будет удалять из строки уравнения все символы кроме: 1234567890±*/,()^

Пример использования:

|MATH|431+(123-431-(-43+45)),removeChars|MATH|

|LENGTH|

Описание:
Возвращает длину указанной строки.

|SIMPLEPARS|

Описание:
Парсит значение из строки, имеет свои команды: |FROM|, |TO|, |IN|, |INDEX|

Команды:

|FROM| - Первый тег для парса (От)
|TO| - Второй тег для парса (До)
|IN| - Из какой строки парсить (Где)
|INDEX| - Индекс среди повторяющихся значений, если оставить пустым (или не указывать совсем), то будет указан 1

Также принимает команды:

|FIRSTCHAR|
|LASTCHAR|

Пример использования:

|SIMPLEPARS||FROM|value="|FROM||IN||RESPONSE||IN||TO|"|TO||INDEX|2|INDEX||SIMPLEPARS|

|REGEXPARS|

Описание:
Парсит значения по регулярке, имеет свои команды: |GROUP|, |EXPR|, |IN|

Команды:

|IN| - Из какой строки парсить (Где)
|GROUP| - Группа, если оставить пустым (или не указывать совсем), то будет указана группа 1
|EXPR| - Регулярное выражение

Пример использования:

|REGEXPARS||EXPR|value="(.*?)"|EXPR||IN||RESPONSE||IN||REGEXPARS|

|REPLACESTR|

Описание:
Заменяет все найденные значения в строке, имеет свои команды: |FROM|, |TO|, |IN|, |IGNORECASE|

Команды:

|FROM| - Заменяемая строка (Что заменяем)
|TO| - Новая строка (На что заменяем)
|IN| - В какой строке заменяем (Где)
|IGNORECASE| - Если указана эта команда, то регистр текста будет игнорироваться

Пример использования:

|REPLACESTR||IN||PARS|[1]|IN||FROM||ANSI|13||ANSI|10||FROM||TO|, |TO||IGNORECASE||REPLACESTR|

|REGREPLACE|

Описание:
Заменяет все найденные значения в строке, имеет свои команды: |EXPR|, |TO|, |IN|

Команды:

|EXPR| - Регулярное выражение заменяемой строки (Что заменяем)
|TO| - Новая строка (На что заменяем)
|IN| - В какой строке заменяем (Где)

Пример использования:

|REGREPLACE||IN||PARS|[1]|IN||EXPR||ANSI|13||ANSI|10||EXPR||TO|, |TO|

|EVAL|

Описание:
Запускает интерпретацию JavaScript-кода с помощью движка QuickJS, применяя глобальный контекст исполнения без использования ES6 модулей. Для активации устаревшего JavaScript-движка вставьте команду |USEOLDJS| внутри вызова |EVAL|.

Дополнительная информация:
В устаревшем движке, чтобы функция что-то возвратила, вам нужно перенести ваш JS скрипт в функцию и возвратить нужное значение и потом вызывать эту функцию.

|JSESCAPE|

Описание:
Экранирует строку для вставки в JS код.

Пример использования:

|EVAL|myFunction("|JSESCAPE||PARS|[1]|JSESCAPE|")|EVAL|

|SCRIPTBOX|

Описание:
Функционал Скрипт-бокса. Описание выше (конечная функция, желательно чтобы она была и начальной, возвращает пустоту).

|DLL|

Описание:
Вызов функции из DLL.

Дополнительная информация:
Принимаются только нативные библиотеки. Все параметры (если они есть) и возвращаемые значения должны быть типа PChar\PWideChar и также должна быть указана директива stdcall.

Команды:

dllName - Имя библиотеки (без .dll)
funcName - Имя функции
parametrs - Параметры функции, разделяются командой |PDEL| (parametrs delimiter)

Пример использования:

|DLL|dllName:myDll;funcName:myFunc;parametrs:|PARS|[1]|PDEL||PARS|[2];|DLL|

Для обзора плагинов должны быть указаны:

info_getAuthor - Имя автора
info_getVersion - Версия
info_getDescription - Описание

|SLEEP|

Описание:
Ждет указанное время (время указывается в миллисекундах).

Пример использования:

|SLEEP|5000|SLEEP| (ждем 5 секунд)

|REPEAT|

Описание:
Повторяет текущий запрос. Есть два вида повторений: local и обычный (пустой, не нужно ничего указывать).

Команды:

local - Повторяет конкретно запрос (если например у вас циклический запрос, в таком случае не будет идти все с самого начала, а начнет с того же запроса). Работает только перед и после отправки запроса.
обычный (пустой) - Повторяет запрос целиком (в таком случае циклический запрос начнет свою работу с самого начала).

Пример использования:

|REPEAT||REPEAT| (повторяем текущий запрос полностью)
|REPEAT|local|REPEAT| (повторяем отправление запроса)

|STOP|

Описание:
Останавливает работу проекта с возможностью вывода сообщения.

Пример использования:

|STOP||STOP| (без сообщения)
|STOP|Сообщение|STOP| (можно вывести сообщение)

|PAUSE|

Описание:
Приостанавливает работу проекта с возможностью вывода сообщения.

Пример использования:

|PAUSE||PAUSE| (без сообщения)
|PAUSE|Сообщение|PAUSE| (можно вывести сообщение)

|ADDID|

Описание:
Добавляет идентификатор в список идентификаторов. Возвращает пустоту.

Пример использования:

|ADDID|BLOCK|ADDID|

|DELID|

Описание:
Удаляет идентификатор из списка идентификаторов. При успешном удалении (если идентификатор был найден) возвращает success, иначе not found.

Пример использования:

|DELID|BLOCK|ADDID|

|DELPROXY|

Описание:
Удаляет текущую проксю.

Пример использования:

|DELPROXY||DELPROXY|, но ваша текущая прокся не изменилась. Для этого необходимо вызывать |NEXTPROXY| (если хотите продолжать работу по списку запросов)

|FREEZEPROXY|

Описание:
Замораживает текущую проксю на указанное время в секундах.

Пример использования:

|FREEZEPROXY|60|FREEZEPROXY|, прокся замораживается на 60 секунд. Ваша текущая прокся не изменилась, для этого необходимо вызывать |NEXTPROXY| (если хотите продолжать работу по списку запросов)

|NEXTPROXY|

Описание:
Меняет проксю на следующую по списку. Возвращает новую проксю.

Пример использования:

|NEXTPROXY||NEXTPROXY|

|UNIXTODATE|

Описание:
Преобразовывает UNIX значение с указанным форматом в дату.

Пример использования:

|UNIXTODATE|1571994528|UNIXTODATE| - стандартный формат преобразования - dd/mm/yy
|UNIXTODATE|1571994528|dd/mm/yy|UNIXTODATE|

Дополнительная информация:
Список форматов можно посмотреть здесь: Delphi Basics

|USEPROXY|

Описание:
Использовать указанную прокси.

Пример использования:

|USEPROXY|127.0.0.1:80,HTTPS|USEPROXY| (Типы - HTTPS, SOCKS4, SOCKS5)

|PRINT|

Описание:
Выводит в лог указанный текст (только в студии).

|REGEXGLUE|

Описание:
Функция |REGEXGLUE| склеивает данные из |REGEX| по индексам с добавлением разделителя.

Пример использования: 1, | ,2, \ ,3

Входные параметры:

1{индекс парсера}, - Разделитель, 2{индекс парсера}, - Разделитель, 3{индекс парсера}

Возвращаемое значение:

Итоговое значение, в котором ко всем значениям в |REGEX|[1], |REGEX|[2] и |REGEX|[3] будет добавлен указанный разделитель. Количество указанных индексов неограничено.

|SIMPLEGLUE|

Описание:
Функция |SIMPLEGLUE| склеивает данные из |REGEX| по индексу и значению.

Пример использования: 3, Значение

Входные параметры:

3{индекс парсера}, - Значение

Возвращаемое значение:

Итоговое значение, в котором ко всем значениям в |REGEX|[3] будет добавлено указанное значение.

|ESCJSON|

Описание:
Функция |ESCJSON| экранирует JSON значение.

Возвращаемое значение:

Экранированное значение JSON.

|PBKDF2KEY|

Описание:
Функция |PBKDF2KEY| генерирует ключ с использованием алгоритма PBKDF2 на основе заданного пароля и соли.

Входные параметры:

text: Текст для генерации ключа.
salt: Соль для генерации ключа.
keyLength (опционально, по умолчанию 128): Длина ключа в байтах.
hashSizeBits (опционально, по умолчанию 256): Размер хеша в битах (256, 512 для SHA-2; 224, 256, 384, 512 для SHA-3).
counter (опционально, по умолчанию 10000): Количество итераций.
outputFormat (опционально, по умолчанию ‘hexa’): Формат выходных данных (hexa, base64, base64url, base32).
hashFunction (опционально, по умолчанию ‘sha2’): Хеш-функция (sha2, sha3).

Возвращаемое значение:

Сгенерированный ключ в указанном формате.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

|SCRYPT|

Описание:
Функция |SCRYPT| генерирует ключ с использованием алгоритма scrypt на основе заданного пароля и соли.

Входные параметры:

password: Пароль для генерации ключа.
salt: Соль для генерации ключа.
N: Параметр N (cost factor) для scrypt.
r: Параметр r (block size) для scrypt.
p: Параметр p (parallelization factor) для scrypt.
outputSize (опционально, по умолчанию 64): Размер выходного ключа в байтах.

Возвращаемое значение:

Сгенерированный ключ в шестнадцатеричном формате.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

|BASE64DECODE|

Описание:
Функция |BASE64DECODE| декодирует входную строку из формата Base64.

Входные параметры:

строка в формате Base64, которую необходимо декодировать.

Возвращаемое значение:

Декодированная строка.

|SHA3HASH|

Описание:
Функция |SHA3HASH| выполняет хеширование текста с использованием алгоритма SHA-3.

Входные параметры:

text: Текст для хеширования.
type (опционально, по умолчанию ‘sha’): Тип SHA-3 (sha, xof).
hashSizeBits (опционально, по умолчанию 256): Размер хеша в битах для типа ‘sha’ (224, 256, 384, 512) или в байтах для типа ‘xof’.
outputFormat (опционально, по умолчанию ‘hexa’): Формат выходных данных (hexa, base64, base64url, base32).
version (опционально, по умолчанию 256): Версия SHA-3 (224, 256, 384, 512).

Возвращаемое значение:

Строка, представляющая собой хеш, сгенерированный алгоритмом SHA-3.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

|SHA2HASH|

Описание:
Функция |SHA2HASH| выполняет хеширование текста с использованием алгоритма SHA-2.

Входные параметры:

text: Текст для хеширования.
hashSizeBits (опционально, по умолчанию 256): Размер хеша в битах (256, 384, 512).
outputFormat (опционально, по умолчанию ‘hexa’): Формат выходных данных (hexa, base64, base64url, base32).

Возвращаемое значение:

Строка, представляющая собой хеш, сгенерированный алгоритмом SHA-2.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

|BCRYPT|

Описание:
Функция |BCRYPT| выполняет хеширование строки с использованием алгоритма BCrypt. Она принимает JSON-объект с параметрами, позволяя гибко задавать исходный текст и желаемую "стоимость" вычислений.

Входные параметры:

text (строка) — текст, который необходимо захешировать.
cost (целое число, необязательный) — фактор сложности хеширования (по умолчанию 10). Допустимые значения: от 4 до 31.

Пример входных данных:

{"text": "input text","cost": 12}

Возвращаемое значение:

Строка, представляющая собой хеш, сгенерированный алгоритмом BCrypt.

Примечания:

Если параметр cost не указан или некорректен, будет использовано значение по умолчанию: 10.
BCrypt — адаптивный алгоритм: с увеличением cost хеширование становится медленнее, но безопаснее для защиты от перебора паролей.

|AESENCRYPT|

Описание:
Функция |AESENCRYPT| выполняет шифрование текста с использованием алгоритма AES.

Входные параметры:

inputFormat (опционально, по умолчанию 'plaintext'): Формат входных данных. Возможные значения:
- plaintext: Обычный текст.
- hexa: Шестнадцатеричное представление.
- base64: Base64 кодировка.
text: Текст для шифрования.
key: Ключ шифрования.
mode (опционально, по умолчанию ‘CBC’): Режим работы AES. Возможные значения:
- ECB: Электронный кодовый блок (без использования IV).
- CBC: Режим цепочки блочного шифрования (требуется IV).
- OFB: Выходной режим обратной связи (требуется IV).
- CTR: Режим счетчика (требуется IV).
- CFB: Режим обратной связи по шифротексту (требуется IV).
- SIC: Счётный режим с обратной связью (требуется IV).
Примечание: Для режимов, отличных от ECB, необходимо предоставить параметр iv или установить includeIV в true для автоматической генерации и включения IV в результат.
keyLength (опционально, по умолчанию 256): Длина ключа в битах. Возможные значения: 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448.
padding (опционально, по умолчанию ‘PKCS7’): Метод выравнивания. Возможные значения:
- ISO10126-2: Добавление паддинга ISO10126-2.
- ISO7816-4: Добавление паддинга ISO7816-4.
- BIT: Добавление битового паддинга.
- PKCS5: Добавление паддинга PKCS5.
- PKCS7: Добавление паддинга PKCS7.
- TBC: Добавление паддинга TBC.
- ANSI X9.23: Добавление паддинга ANSI X9.23.
- Zero: Добавление нулевого паддинга.
blockSize (опционально, по умолчанию 128): Размер блока в битах. Обычно используется значение 128.
includeIV (опционально, по умолчанию false): Включать ли IV в начало зашифрованного текста. Применимо только для режимов, требующих IV (CBC, OFB, CTR, CFB, SIC).
iv (опционально): Инициализационный вектор в формате hexa. Требуется для режимов, отличных от ECB, если includeIV не установлен в true.
outputFormat (опционально, по умолчанию ‘hexa’): Формат выходных данных. Возможные значения:
- hexa: Шестнадцатеричное представление.
- base64: Base64 кодировка.
- plaintext: Необработанные байты.

Возвращаемое значение:

Зашифрованный текст или сообщение об ошибке, если шифрование не удалось.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.
Выбрасывает исключение, если длина ключа не соответствует выбранной длине ключа.
Выбрасывает исключение, если длина IV некорректна для выбранного режима.
Выбрасывает исключение, если требуется IV, но он не предоставлен и includeIV не установлен.

|AESDECRYPT|

Описание:
Функция |AESDECRYPT| выполняет расшифровку текста с использованием алгоритма AES.

Входные параметры:

text (обязательный): Зашифрованный текст в формате, указанном параметром inputFormat.
key (обязательный): Ключ шифрования.
mode (опционально, по умолчанию 'CBC'): Режим работы AES. Возможные значения:
- ECB: Электронный кодовый блок (без использования IV).
- CBC: Режим цепочки блочного шифрования (требуется IV).
- OFB: Выходной режим обратной связи (требуется IV).
- CTR: Режим счетчика (требуется IV).
- CFB: Режим обратной связи по шифротексту (требуется IV).
- SIC: Счётный режим с обратной связью (требуется IV).
- CTS: Режим последовательного шифрования (требуется IV).
Примечание: Для режимов, отличных от ECB, необходимо предоставить параметр iv или предусмотреть, что IV включен в зашифрованный текст с помощью параметра includeIV.
keyLength (опционально, по умолчанию 128): Длина ключа в битах. Возможные значения: 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448.
padding (опционально, по умолчанию 'PKCS7'): Метод выравнивания. Возможные значения:
- ISO10126-2: Удаление паддинга ISO10126-2 после расшифровки.
- ISO7816-4: Удаление паддинга ISO7816-4 после расшифровки.
- BIT: Удаление битового паддинга после расшифровки.
- PKCS5: Удаление паддинга PKCS5 после расшифровки.
- PKCS7: Удаление паддинга PKCS7 после расшифровки.
- TBC: Удаление паддинга TBC после расшифровки.
- ANSI X9.23: Удаление паддинга ANSI X9.23 после расшифровки.
- Zero: Удаление нулевого паддинга после расшифровки.
blockSize (опционально, по умолчанию 128): Размер блока в битах. Обычно используется значение 128. Применяется для режимов работы CFB и OFB.
includeIV (опционально, по умолчанию false): Указывает, что IV включен в начало зашифрованного текста. Применимо только для режимов, требующих IV (CBC, OFB, CTR, CFB, SIC).
iv (опционально): Инициализационный вектор в формате hexa. Требуется для режимов, отличных от ECB, если includeIV не установлен в true.
outputFormat (опционально, по умолчанию 'hexa'): Формат выходных данных. Возможные значения:
- plaintext: Необработанный текст.
- base64: Base64 кодировка.
- hexa: Шестнадцатеричное представление.
inputFormat (опционально, по умолчанию 'base64'): Формат входных данных. Возможные значения:
- base64: Base64 кодировка.
- plaintext: Необработанный текст.
- hexa: Шестнадцатеричное представление.

Возвращаемое значение:

Расшифрованный текст в формате, указанном в параметре outputFormat, или сообщение об ошибке, если расшифровка не удалась.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.
Выбрасывает исключение, если длина ключа не соответствует выбранной длине ключа.
Выбрасывает исключение, если длина IV некорректна для выбранного режима.
Выбрасывает исключение, если требуется IV, но он не предоставлен и includeIV не установлен.

|AESGCMENCRYPT|

Описание:
Функция |AESGCMENCRYPT| выполняет шифрование текста с использованием алгоритма AES-GCM.

Входные параметры:

text: Текст для шифрования.
key: Ключ шифрования.
associatedData (опционально): Ассоциированные данные.
keyLength (опционально, по умолчанию 256): Длина ключа в битах (128, 192, 256).
tagSizeBits (опционально, по умолчанию 16): Размер тега в байтах (1-16).
outputFormat (опционально, по умолчанию ‘hexa’): Формат вывода (hexa, base64, base64url, base32).

Возвращаемое значение:

Зашифрованный текст в формате JSON, содержащий tag и encryptedText.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

|AESGCMDECRYPT|

Описание:
Функция |AESGCMDECRYPT| выполняет расшифровку зашифрованного текста с использованием алгоритма AES-GCM.

Входные параметры:

encryptedText: Зашифрованный текст. Ожидается в формате указанном в `outputFormat`.
tag: Тег для верификации. Формат зависит от параметра outputFormat (hexa, base64, base64url, base32).
key: Ключ шифрования. Должен быть представлен в формате hexa.
associatedData (опционально): Ассоциированные данные. Ожидается в формате hexa.
keyLength (опционально, по умолчанию 256): Длина ключа в битах (128, 192, 256).
tagSizeBits (опционально, по умолчанию 16): Размер тега в байтах (1-16).
outputFormat (опционально, по умолчанию hexa): Формат вывода (hexa, base64, base64url, base32).

Возвращаемое значение:

Расшифрованный текст или сообщение об ошибке, если расшифровка не удалась.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.

Функция `|RSAENCRYPT|`

Описание:
Функция |RSAENCRYPT| выполняет шифрование текста с использованием алгоритма RSA.

Входные параметры:

Input: Входная строка в формате JSON, содержащая следующие параметры:
- text: Текст для шифрования.
- modulus: Модуль ключа RSA (в формате PEM или HEX).
- publicExponent: Публичная экспонента ключа RSA (в формате HEX).
- encType (опционально, по умолчанию 'oaep'): Режим шифрования. Возможные значения:
  - oaep: Optimal Asymmetric Encryption Padding
  - v1.5: PKCS#1 v1.5 Padding
- oaepHash (опционально): Хэш-функция для OAEP padding.
- oaepMgfHash (опционально): Хэш-функция для MGF в OAEP padding.
- oaepLabel (опционально): Метка для OAEP padding (в HEX формате).
- littleEndian (опционально, по умолчанию false): Порядок байтов.

Возвращаемое значение:

Зашифрованный текст в формате Base64 или сообщение об ошибке.

Функция `|RSADECRYPT|`

Описание:
Функция |RSADECRYPT| выполняет расшифровку текста с использованием алгоритма RSA.

Входные параметры:

Input: Входная строка в формате JSON, содержащая следующие параметры:
- encryptedText: Зашифрованный текст для расшифровки.
- privateKeyPem: Приватный ключ RSA (в формате PEM или HEX).
- encType (опционально, по умолчанию 'oaep'): Режим шифрования. Возможные значения:
  - oaep: Optimal Asymmetric Encryption Padding
  - v1.5: PKCS#1 v1.5 Padding
- oaepHash (опционально): Хэш-функция для OAEP padding.
- oaepMgfHash (опционально): Хэш-функция для MGF в OAEP padding.
- oaepLabel (опционально): Метка для OAEP padding (в HEX формате).
- littleEndian (опционально, по умолчанию false): Порядок байтов.

Возвращаемое значение:

Расшифрованный текст или сообщение об ошибке.

Общие исключения для обеих функций:

Неверный формат JSON или отсутствие обязательных параметров
Некорректный формат ключей (PEM или HEX)
Ошибки при импорте ключей
Ошибки в процессе шифрования/расшифровки
Некорректный формат OAEP Label (должен быть в HEX)
Неподдерживаемый тип шифрования

Возвращаемое значение

Возвращает расшифрованный текст в формате UTF-8 или сообщение об ошибке, если расшифровка не удалась.

Исключения

Функция выбрасывает исключения в следующих случаях:

Если входная строка имеет некорректный формат JSON или если отсутствуют обязательные параметры.
При ошибках в обработке ключей или процессе расшифровки.

Функция `|RSAKEYGEN|`

Описание:
Функция |RSAKEYGEN| генерирует пару ключей RSA заданного размера и возвращает как PEM-строки, так и разобранные компоненты ключей в формате JSON.

Входные параметры:

Input: Входная строка в формате JSON, содержащая следующие параметры:
- keySize (целое, опционально, по умолчанию 2048): Размер ключа в битах.

Возвращаемое значение:

Строка в формате JSON со следующими полями:
- privateKeyPem: Закрытый ключ в формате PEM (PKCS#1), начиная с -----BEGIN RSA PRIVATE KEY-----.
- publicKeyPem: Открытый ключ в формате PEM (OpenSSL), начиная с -----BEGIN PUBLIC KEY-----.
- privateKey: JSON-объект с компонентами закрытого ключа:
  - modulus
  - d
  - p
  - q
  - dp
  - dq
  - inverseQ
- publicKey: JSON-объект с компонентами открытого ключа:
  - modulus
  - exponent
- keySize: Размер сгенерированного ключа в битах.
В случае ошибки возвращается строка с текстом сообщения об ошибке.

|RANDOMBYTES|

Описание:
Функция |RANDOMBYTES| генерирует массив случайных байтов указанной длины.

Входные параметры:

строка, представляющая длину массива случайных байтов. Пример: “16” для генерации массива из 16 случайных байтов.

Возвращаемое значение:

Массив случайных байтов в формате JSON.

Исключения:

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

|STRTOBYTES|

Описание:
Функция |STRTOBYTES| преобразует строку в массив байтов и возвращает его в формате JSON.

Входные параметры:

строка, которую необходимо преобразовать в массив байтов.

Возвращаемое значение:

Массив байтов в формате JSON. Пример результата: [104, 101, 108, 108, 111], что соответствует строке “hello” в UTF-8.

Исключения:

Выбрасывает исключение, если входная строка не может быть обработана.

|BYTESTOSTR|

Описание:
Функция |BYTESTOSTR| преобразует массив байтов, представленный в формате JSON, в строку с использованием кодировки UTF-8.

Входные параметры:

строка в формате JSON, представляющая массив байтов. Пример: [104, 101, 108, 108, 111], что соответствует строке “hello” в UTF-8.

Возвращаемое значение:

Строка, полученная из массива байтов.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат JSON или если элементы массива не являются числами.

|UUIDV4|

Описание:
Функция |UUIDV4| возвращает уникальный UUIDV4.

|GETVALUEBYKEY|

Описание:
Функция |GETVALUEBYKEY| извлекает значение по ключу из многострочного текста.

Входные параметры:

“Многострочный текст|KEYNAME|Ключ”, где:
- Первая часть (до |KEYNAME|) содержит многострочный текст формата “ключ: значение”.
- Вторая часть (после |KEYNAME|) содержит ключ, по которому нужно найти значение.

Возвращаемое значение:

Значение, соответствующее ключу в многострочном тексте. Если ключ не найден, возвращает сообщение “Key not found: Ключ”.

Исключения:

Выбрасывает исключение, если входная строка имеет некорректный формат (не содержит |KEYNAME|).

|SAVEFILE|

Описание:
Функция сохраняет данные в файл относительно пути созданной сессии с возможностью перезаписи, добавления к существующему файлу или сохранения с инкрементированным именем. Также поддерживается сохранение текстовых и бинарных данных (в виде Base64). В случае ошибок при сохранении или создании директорий функция возвращает сообщение об ошибке.

Команды:

Имя файла - Имя файла, включая путь (если необходимо). Поддерживаются вложенные директории.
Опции - Действия при сохранении:
- overwrite - Перезаписать существующий файл.
- append - Добавить данные в конец файла.
- increment - Сохранить с инкрементированным именем (например, file1.txt, file2.txt и т.д.).
Тип данных (опционально) - Тип данных:
- text - Текстовые данные (по умолчанию).
- bytes - Бинарные данные в формате Base64.
Данные - Содержимое для сохранения. Если тип данных text, это обычный текст. Если bytes, строка должна быть в формате Base64.

Пример использования:

|SAVEFILE|C:\Documents\report.txt|overwrite|This is a report|SAVEFILE|
Описание: Сохраняет текст "This is a report" в файл C:\Documents\report.txt, перезаписывая его.
|SAVEFILE|logs\error.log|append|text|Error logged at 3:00 PM|SAVEFILE|
Описание: Добавляет строку "Error logged at 3:00 PM" в файл logs\error.log, создавая директорию logs, если она отсутствует.
|SAVEFILE|log.txt|increment|Log entry|SAVEFILE|
Описание: Сохраняет текст "Log entry" в файл log.txt. Если файл уже существует, сохраняет как log1.txt, log2.txt и т.д.
|SAVEFILE|C:\Documents\data\data.bin|overwrite|SGVsbG8sIFdvcmxkIQ==|SAVEFILE|
Описание: Сохраняет бинарные данные "SGVsbG8sIFdvcmxkIQ==" (Base64 строка, соответствующая "Hello, World!") в файл C:\Documents\data\data.bin, перезаписывая его.
|SAVEFILE|backup.dat|append|bytes|QmFja3VwIERhdGE=|SAVEFILE|
Описание: Добавляет бинарные данные "QmFja3VwIERhdGE=" (соответствующие "Backup Data") в файл backup.dat, который находится по пути относительно созданой сессии.
|SAVEFILE|\\server\share\backup\data.bin|increment|VGhpcyBpcyBhIGJpbmFyeSBmaWxl|SAVEFILE|
Описание: Сохраняет бинарные данные "VGhpcyBpcyBhIGJpbmFyeSBmaWxl" (Base64 строка, соответствующая "This is a binary file") в файл \\server\share\backup\data.bin. Если файл уже существует, сохраняет как data1.bin, data2.bin и т.д.

|HEXTOBASE64|

Описание:
Функция преобразует шестнадцатеричную строку в строку в формате Base64. Если длина входной строки нечетная или если данные не могут быть преобразованы, функция возвращает сообщение об ошибке.

Команды:

Шестнадцатеричная строка - Входные данные в шестнадцатеричном формате, которые необходимо преобразовать в Base64. Длина строки должна быть четной.

Пример использования:

|HEXTOBASE64|a0000005350002|HEXTOBASE64|
Описание: Преобразует шестнадцатеричную строку "a0000005350002" в строку Base64.

|BASE64TOHEX|

Описание:
Функция преобразует строку в формате Base64 в шестнадцатеричную строку. В случае ошибок при декодировании входной строки функция возвращает сообщение об ошибке.

Команды:

Base64 строка - Входные данные в формате Base64, которые необходимо преобразовать в шестнадцатеричную строку.

Пример использования:

|BASE64TOHEX|qA==|BASE64TOHEX|
Описание: Преобразует строку Base64 "qA==" в шестнадцатеричную строку.

Функция `|PROTOBUF|`

Функция |PROTOBUF| предназначена для работы с данными в формате Protobuf. Она позволяет создавать новые сообщения, декодировать существующие сообщения и обновлять данные в сообщениях на основе JSON маппинга.

Поддерживаемые типы данных

int32: Целое число с 32 битами.
int64: Целое число с 64 битами.
uint32: Беззнаковое целое число с 32 битами.
uint64: Беззнаковое целое число с 64 битами.
bool: Логическое значение (true или false).
float: Число с плавающей запятой одинарной точности.
double: Число с плавающей запятой двойной точности.
string: Строка.
bytes: Массив байтов (используется для бинарных данных).
message: Вложенное сообщение с набором полей.
enum: Перечисляемый тип данных с возможными значениями.

Параметры

Input: Входная строка в формате JSON, содержащая следующие параметры:
- action: Действие, которое нужно выполнить. Возможные значения:
  - "encode": Создание нового Protobuf сообщения.
  - "decode": Декодирование существующего Protobuf сообщения.
  - "update": Обновление существующего Protobuf сообщения.
- message_type: Название сообщения, для которого необходимо создать маппинг.
- field_mapping: JSON объект, описывающий структуру полей сообщения. Включает:
  - name: Имя поля.
  - number: Номер поля.
  - type: Тип данных (см. выше список поддерживаемых типов).
  - fields (для вложенных сообщений): Описание структуры полей вложенного сообщения.
  - values (для типа enum): Возможные значения enum с их числовым представлением.
- field_values: (Опционально, для действий "encode" и "update") JSON объект с данными полей, которые должны быть сериализованы или обновлены.
- protobuf_base64: (Обязательно для действий "decode" и "update") Base64 строка закодированного сообщения Protobuf.

Возвращаемые значения

Для действия "encode": Закодированное Protobuf сообщение в формате Base64.
Для действия "decode": JSON объект с расшифрованными данными полей.
Для действия "update": Обновленное Protobuf сообщение в формате Base64.

Исключения

Функция выбрасывает исключения в следующих случаях:

Если входная строка имеет некорректный формат JSON.
Если отсутствуют обязательные параметры.
Если не удалось корректно выполнить указанное действие.

Генератор

Проще всего для генерации мапинга использовать данного агента по ссылке: GPT ProtoBuf3 Agent

|BLAKE2BENCODE|

Описание:
Функция |BLAKE2BENCODE| выполняет вычисление Blake2b хеша строки.

Входные параметры:

Input: Входная строка для вычисления Blake2b хеша.

Возвращаемое значение:

Возвращает Blake2b хеш в шестнадцатеричном формате или сообщение об ошибке.

|WHIRLPOOLENCODE|

Описание:
Функция |WHIRLPOOLENCODE| выполняет вычисление Whirlpool хеша строки.

Входные параметры:

Input: Входная строка для вычисления Whirlpool хеша.

Возвращаемое значение:

Возвращает Whirlpool хеш в шестнадцатеричном формате или сообщение об ошибке.

|XXHASHENCODE|

Описание:
Функция |XXHASHENCODE| выполняет вычисление XXHash хеша строки.

Входные параметры:

Input: Входная строка для вычисления XXHash хеша.

Возвращаемое значение:

Возвращает XXHash хеш в шестнадцатеричном формате или сообщение об ошибке.

|KECCAK256HASH|

Описание:
Функция |KECCAK256HASH| выполняет вычисление Keccak-256 хеша строки.

Входные параметры:

Input: Входная строка для вычисления Keccak-256 хеша.

Возвращаемое значение:

Возвращает Keccak-256 хеш в шестнадцатеричном формате или сообщение об ошибке.

|BLAKE3ENCODE|

Описание:
Функция |BLAKE3ENCODE| выполняет вычисление Blake3 хеша строки.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- message: Входная строка для вычисления Blake3 хеша.
- key: Ключ для Blake3 в шестнадцатеричном формате.

Возвращаемое значение:

Возвращает Blake3 хеш в шестнадцатеричном формате или сообщение об ошибке.

|ZLIBCOMPRESS|

Описание:
Функция |ZLIBCOMPRESS| сжимает строку с использованием ZLib.

Входные параметры:

Input: Входная строка для сжатия.

Возвращаемое значение:

Возвращает сжатую строку или сообщение об ошибке.

|ZLIBDECOMPRESS|

Описание:
Функция |ZLIBDECOMPRESS| декомпрессирует строку, сжатую с использованием ZLib.

Входные параметры:

Input: Входная строка в формате Base64 для декомпрессии.

Возвращаемое значение:

Возвращает декомпрессированную строку или сообщение об ошибке.

|GZIPCOMPRESS|

Описание:
Функция |GZIPCOMPRESS| сжимает строку с использованием GZIP.

Входные параметры:

Input: Входная строка для сжатия.

Возвращаемое значение:

Возвращает сжатую строку в формате Base64 или сообщение об ошибке.

|GZIPDECOMPRESS|

Описание:
Функция |GZIPDECOMPRESS| декомпрессирует строку, сжатую с использованием GZIP.

Входные параметры:

Input: Входная строка в формате Base64 для декомпрессии.

Возвращаемое значение:

Возвращает декомпрессированную строку или сообщение об ошибке.

|BASEENCODEDECODE|

Описание:
Функция |BASEENCODEDECODE| выполняет кодирование или декодирование на основе указанного Base алгоритма.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- algorithm: Алгоритм кодирования Base (`Base16`, `Base32`, `Base64`, `Base58BitCoin`, `Base58Ripple`, `Base58Flickr`, `Base58Custom`, `Ascii85`, `Z85`).
- action: `encode` или `decode` (что выполнить).
- message: Сообщение для кодирования или декодирования.
- usePadding (опционально для `Base64`): Логический флаг, указывающий, использовать ли паддинг в Base64 кодировании. По умолчанию `true`.
- customAlphabet (опционально для `Base58Custom`): Пользовательский алфавит для кодирования/декодирования в Base58.

Возвращаемое значение:

Возвращает закодированное или декодированное сообщение, или сообщение об ошибке в случае неудачи.

|ARGON2HASH|

Описание:
Функция |ARGON2HASH| генерирует хеш с использованием алгоритма Argon2.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- password: Пароль для хеширования.
- salt: Соль для хеширования.
- iterations (опционально, по умолчанию 2): Количество итераций.
- memory (опционально, по умолчанию 65536): Объем памяти в KB.
- type (опционально, по умолчанию Argon2id): Тип Argon2 (`Argon2d`, `Argon2i`, `Argon2id`).
- version (опционально, по умолчанию '1.3'): Версия Argon2 ('1.0' или '1.3').
- outputLength (опционально, по умолчанию 32): Длина выходного хеша.
- secret (опционально): Секретные данные.
- additional (опционально): Дополнительные данные.

Возвращаемое значение:

Возвращает Argon2 хеш в шестнадцатеричном формате или сообщение об ошибке. Выполняется без параллелизма.

|SALSA20ENCRYPT|

Описание:
Функция |SALSA20ENCRYPT| шифрует сообщение с использованием алгоритма Salsa20.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- key: Ключ для шифрования.
- nonce: Нонс для шифрования.
- message: Сообщение для шифрования.
- keyLength (необязательный, по умолчанию 256): Длина ключа шифрования (128 или 256 бит).
- rounds (необязательный, по умолчанию 20): Количество раундов для Salsa20 (8, 12 или 20).

Возвращаемое значение:

Возвращает зашифрованное сообщение в формате Base64 или сообщение об ошибке.

|CHACHA20ENCRYPT|

Описание:
Функция |CHACHA20ENCRYPT| шифрует сообщение с использованием алгоритма ChaCha20.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- key: Ключ для шифрования.
- nonce: Нонс для шифрования.
- message: Сообщение для шифрования.
- keyLength (необязательный, по умолчанию 256): Длина ключа шифрования (128 или 256 бит).
- rounds (необязательный, по умолчанию 20): Количество раундов для ChaCha20 (8, 12 или 20).

Возвращаемое значение:

Возвращает зашифрованное сообщение в формате Base64 или сообщение об ошибке.

|BLOWFISHENCRYPT|

Описание:
Функция |BLOWFISHENCRYPT| выполняет шифрование текста с использованием алгоритма Blowfish.

Входные параметры полностью как в |AESENCRYPT|

|BLOWFISHDECRYPT|

Описание:
Функция |BLOWFISHDECRYPT| выполняет расшифровку текста с использованием алгоритма Blowfish.

Входные параметры полностью как в |AESDECRYPT|

|SHUFFLE|

Описание:
Функция |SHUFFLE| перемешивает символы входной строки случайным образом.

Входные параметры:

Input: Входная строка для перемешивания.

Возвращаемое значение:

Возвращает новую строку с перемешанными символами или сообщение об ошибке.

|HMAC|

Описание:
Функция |HMAC| вычисляет HMAC с использованием заданного алгоритма хеширования.

Входные параметры:

Input: Входная строка в формате JSON, содержащая параметры:
- algorithm: Алгоритм хеширования ('MD2', 'MD4', 'MD5', 'SHA1', 'SHA224', 'SHA256', 'SHA384', 'SHA512', 'SHA512/224', 'SHA512/256', 'RIPEMD128', 'RIPEMD160', 'TIGER', 'KECCAK224', 'KECCAK256', 'KECCAK288', 'KECCAK384', 'KECCAK512', 'SHA3-224', 'SHA3-256', 'SHA3-384', 'SHA3-512', 'GOST3411-2012-256', 'GOST3411-2012-512', 'BLAKE2B-256', 'BLAKE2B-512').
- key: Ключ для HMAC.
- message: Сообщение для HMAC.
- outputFormat (опционально, по умолчанию 'hexa'): Формат выходных данных ('hexa', 'base64', 'plaintext').
- hashSize (опционально для 'Tiger'): Размер хеша для Tiger (например, 16, 20, 24).
- rounds (опционально для 'Tiger'): Количество раундов для Tiger.

Возвращаемое значение:

Возвращает HMAC хеш или сообщение об ошибке.

|ANSITOUTF8|

Описание:
Функция |ANSITOUTF8| преобразует строку в формате ANSI в UTF-8.

Входные параметры:

Input: Входная строка для преобразования в UTF-8.

Возвращаемое значение:

Возвращает преобразованную строку в формате UTF-8.

|ADDCOOKIES|

Описание:
Функция |ADDCOOKIES| добавляет новые куки к существующим кукам HTTP-запроса. Каждая кука должна быть указана в формате "Имя=Значение".

Входные параметры:

Input: Строка, содержащая куки для добавления, разделенные переводами строк. Пример:
```
Cookie1=Value1
Cookie2=Value2
    
```

Возвращаемое значение:

Возвращает строку подтверждения о успешном добавлении кук или сообщение об ошибке в случае некорректного формата.

|REPLACECOOKIES|

Описание:
Функция |REPLACECOOKIES| заменяет существующие куки на новые или добавляет их, если они отсутствуют. Каждая кука должна быть указана в формате "Имя=Значение".

Входные параметры:

Input: Строка, содержащая куки для замены или добавления, разделенные переводами строк. Пример:
```
Cookie1=NewValue1
Cookie3=Value3
    
```

Возвращаемое значение:

Возвращает строку подтверждения о успешной замене или добавлении кук или сообщение об ошибке в случае некорректного формата.

|DELETECOOKIES|

Описание:
Функция |DELETECOOKIES| удаляет указанные куки из текущих HTTP-заголовков. Можно удалять как отдельные куки, так и несколько куки одновременно.

Входные параметры:

Input: Строка, содержащая имена кук для удаления, разделенные переводами строк или символом "=". Пример:
```
Cookie1
Cookie2=Value2
    
```

Возвращаемое значение:

Возвращает строку подтверждения о успешном удалении кук или сообщение об ошибке, если имя куки отсутствует.

|SETCOOKIES|

Описание:
Функция |SETCOOKIES| устанавливает все куки HTTP-запроса, заменяя существующие. Каждая кука должна быть указана в формате "Имя=Значение". Все предыдущие куки будут удалены перед установкой новых.

Входные параметры:

Input: Строка, содержащая куки для установки, разделенные переводами строк. Пример:
```
Cookie1=Value1
Cookie2=Value2
    
```

Возвращаемое значение:

Возвращает строку подтверждения о успешной установке кук или сообщение об ошибке в случае некорректного формата.

|GENERATEUSERAGENT|

Описание:
Функция |GENERATEUSERAGENT| генерирует строку User-Agent на основе входных параметров в формате JSON. Она позволяет создать корректную строку User-Agent для заданных браузера, операционной системы, типа устройства и других параметров. Если некоторые параметры не указаны, функция автоматически подбирает подходящие значения, обеспечивая совместимость между браузером, ОС и устройством.

Возможности функции:

Генерация User-Agent для различных браузеров и их версий.
Поддержка множества операционных систем и их версий.
Автоматический выбор движка браузера, совместимого с выбранным браузером.
Поддержка различных типов устройств, включая десктопы, ноутбуки, планшеты, мобильные устройства, смарт-ТВ и игровые консоли.
Возможность исключения определённых браузеров, операционных систем или движков из выбора.
Использование шаблонов User-Agent для гибкой настройки формата строки.
Автоматическое определение модели устройства и её совместимости с операционной системой.
Поддержка дополнительных параметров, таких как версия Chrome для браузеров на основе Chromium.
Обработка исключений и предоставление подробных сообщений об ошибках с рекомендациями.
Конфигурационный файл с настройки генерации автоматически обновляется из сервера при запуске программы.

Входные параметры:

Input: Входная строка в формате JSON, содержащая следующие параметры:
- browser (опционально): Название браузера. Возможные значения включают, но не ограничиваются:
  - "Chrome"
  - "Firefox"
  - "Safari"
  - "Edge"
  - "Opera"
  - "Internet Explorer"
  - "Samsung Internet"
  - "YaBrowser"
  - и другие поддерживаемые браузеры.
  По умолчанию: Если не указано, будет выбран случайный доступный браузер.
- browser_version (опционально): Версия браузера (например, "92.0"). Если не указано, будет автоматически выбрана версия для указанного браузера.
- os (опционально): Название операционной системы. Возможные значения:
  - "Windows"
  - "macOS"
  - "Linux"
  - "Android"
  - "iOS"
  - "Tizen"
  - и другие поддерживаемые ОС.
  По умолчанию: Если не указано, будет выбрана ОС, совместимая с выбранным браузером и типом устройства.
- os_version (опционально): Версия операционной системы (например, "10.0", "11.2"). Если не указано, будет автоматически выбрана версия для указанной ОС.
- engine (опционально): Движок браузера. Возможные значения:
  - "Blink"
  - "WebKit"
  - "Gecko"
  - "Trident"
  - "EdgeHTML"
  - и другие поддерживаемые движки.
  По умолчанию: Если не указано, будет выбран движок, совместимый с выбранным браузером.
- engine_version (опционально): Версия движка браузера. Если не указано, будет автоматически установлена соответствующая версия.
- user_agent_template (опционально): Шаблон строки User-Agent. Используются плейсхолдеры для замены значениями параметров (например, "{browser}", "{os}"). Если не указан, будет использован стандартный шаблон для выбранного браузера и ОС или общий шаблон по умолчанию.
- device_type (опционально, по умолчанию dtUnknown): Тип устройства. Возможные значения:
  - dtUnknown: Неизвестный тип устройства.
  - dtDesktop: Десктоп.
  - dtLaptop: Ноутбук.
  - dtTablet: Планшет.
  - dtMobile: Мобильное устройство.
  - dtSmartTV: Смарт-ТВ.
  - dtConsole: Игровая консоль.
  По умолчанию: dtUnknown. Если не указано, тип устройства будет определён автоматически на основе выбранной ОС или браузера.
- exclude_browsers (опционально): Массив браузеров, которые следует исключить из выбора. Пример: ["Internet Explorer", "Opera"].
- exclude_os (опционально): Массив операционных систем, которые следует исключить из выбора. Пример: ["Windows", "Linux"].
- exclude_engines (опционально): Массив движков, которые следует исключить из выбора.
- device_model (опционально): Модель устройства (обычно для мобильных устройств). Если не указано, будет выбрана совместимая модель устройства.
- chrome_version (опционально): Версия Chrome (используется для браузеров на базе Chromium, таких как Chrome, Edge, Opera). Если не указано, будет автоматически выбрана соответствующая версия.

Возвращаемое значение:

Возвращает сгенерированную строку User-Agent, соответствующую заданным или автоматически подобранным параметрам.
В случае ошибки возвращает сообщение об ошибке с описанием проблемы и рекомендациями по её устранению.

Примеры использования:

Пример 1: Генерация случайного User-Agent.
```
{}
    
```

Пример 2: Генерация User-Agent для Chrome на Windows 10.


{
  "browser": "Chrome",
  "os": "Windows",
  "os_version": "10.0"
}

Пример 3: Генерация User-Agent для мобильного устройства на Android с исключением определённых браузеров.
```
{
  "os": "Android",
  "exclude_browsers": ["Internet Explorer", "Opera"]
}
    
```
Пример 4: Генерация User-Agent с использованием кастомного шаблона и рандомизацией некоторых параметров.
```
{
  "browser": "Chrome",
  "user_agent_template": "Mozilla/5.0 ({platform}) AppleWebKit/{engine_version} (KHTML, like Gecko) {browser}/{browser_version} Safari/{engine_version}"
}
    
```
В этом примере параметры os, os_version, engine_version и другие, не указанные явно, будут автоматически рандомизированы функцией для обеспечения совместимости с выбранным браузером.

МОДУЛЬ РАСПОЗНАВАНИЯ КАПЧИ

|USEAG| - Указывается при определениях, обозначает, что при найденном проверяемом значении будет использоваться модуль.
|AGREPORT| - Указывается при определениях, обозначает, что если капча была введена неверно, тогда отправляется жалоба на нее в указанный сервис.
|AGFIELD| - ID капчи при распознавании ReCaptcha.
|AGRESULT| - Ответ капчи.
|AGHEADERS| - Прописывается в поле для доп. заголовков, передает указанные заголовки при переходе на капчу. Пример (текст в дополнительных заголовках):
- accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,/;q=0.8
- accept-encoding:gzip, deflate, sdch, br
- |AGHEADERS|Accept-Language:ru-RU,ru;q=0.8,en-US;q=0.6,en;q=0.4,uk;q=0.2|AGHEADERS|
- Заголовки в теге |AGHEADERS| передаются при получении картинки по ссылке.

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

Список API параметров:

Параметр “regsense” по умолчанию в системе in-Line Kit идет 1. Разделять параметры нужно символом &.

Пример:

numeric=2&is_russian=1

Дополнительная ссылка нужна, если у вас в одном запросе идет выполнение модуля и сразу отправка запроса на сайт. Пример:

http://example.com/login - основная ссылка авторизации
http://example.com/auth - ссылка авторизации с капчей

Программа перейдет на Login, сделает все нужное (авторизация, проверка определений и т.д.). Если вылезла капча, дальше под авторизацию подставит дополнительную ссылку.

Для распознавания картинки в base64 нужно указать в поле для ссылки “Ссылка на изображение капчи | Ключ сайта”:

data:image/BASE64IMAGE;base64

Для распознавания картинки в SVG нужно указать в поле для ссылки “Ссылка на изображение капчи | Ключ сайта”:

<svg...

Для распознавания новых видов капчи нужно указать в поле для ссылки “Ссылка на изображение капчи | Ключ сайта”:

Recaptcha 2.0 - “sitekey:Ключ сайта”
Recaptcha 2.0 invisible - “sitekey:Ключ сайта;invisible”
Recaptcha 3.0 - “sitekey:Ключ сайта;pageaction:pageaction”
Recaptcha 3.0 enterprise - “sitekey:Ключ сайта;pageaction:pageaction;enterprise”
Recaptcha HCaptcha - “hsitekey:Ключ сайта”

Есть возможность указать свой pageurl.

Для работы с Recaptcha 2.0+ вам необходимо в своем личном кабинете установить минимальную ставку от 2.2 долларов (Anti-Captcha.com). Для работы с CapMonster необходимо в настройках убрать “Получение ответа с задержкой”, если капча не готова (к другим эмуляторам это не относится).

Также, результат капчи конвертируется из ANSI в UTF8 и кодируется с помощью urlencode

MAIL CONNECTOR

|MCSTATUS| - Ответ от Mail Connector. Виды ответов:
- Пустой ответ - результат удачен (В логе работы выдает как “Запрос выполнен успешно”). Пример логики для определения: |MCSTATUS||=|
- Домен не обнаружен.
- Ошибка соединения - автоматически кидает в ошибку, за исключением удаления писем (На удаление писем стоит игнорирование ошибок).
- Страница не была получена корректно - обычно бывает если выполнить какое-то действие без предварительной авторизации. Если вы были авторизованы и у вас выдает такую ошибку, кидайте ее по желанию в ошибки. Если она постоянная - сообщите разработчику.
- Плохой аккаунт.
- Писем не найдено.
- Письма не найдено - если введен некорректный ID письма и такого письма не существует.
- Письмо пусто, ID - Ид письма - не стандартный вид письма, Mail Connector не смог спарсить содержимое письма - сообщите разработчику.
|MCIDS| - Содержит ID писем из поискового запроса.
|MCMSGFIELD| - Хранит содержимое обозреваемого письма.

Все ответы от Mail Connector необходимо вручную обрабатывать, то есть, определение валидности аккаунта, того, что поисковой запрос был выполнен корректно и т.д. Все это можно делать через статусы Mail Connector.

Поддерживаемые почтовые сервисы:

Mail - Сайт (Мобильная API авторизация, другой функционал напрямую через мобильный сайт. Куки из API дают доступ ко всему сайту. Можете доделывать свой функционал дополнительными запросами типа: Парсер номеров, парсер даты рождения и т.д.)
Yandex - На данный момент работает через IMAP.
Все другое - IMAP (Автоматическая генерация, настройки IMAP серверов находятся в глобальных настройках).

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

ДОПОЛНИТЕЛЬНЫЕ КОМАНДЫ

|MAINLOG| - Используется в дополнительных файлах, наследует основной лог.
|USEURLENC| - Преобразование результатов от обычного парсера или по регулярке (только циклические) в вид, поддерживаемый для запросов.
|ANSI| - Символы из ASCII таблицы, нужен индекс символа.
- Пример: |ANSI|13|
|TIME| - Текущее время.
- Пример: |TIME|Разделитель|
|DATE| - Текущий день.
- Пример: |DATE|Разделитель|
|TIMESTAMP| - Unix время.
|FIRSTCHAR| - Первый символ в ответе (применяется для парсинга).
|LASTCHAR| - Последний символ в ответе (применяется для парсинга).
|LDEL| (L - левый), |RDEL| (R - правый) - Разделители для групп в регулярных парсерах.
|CLEAR| - Очищает лог от пустых строк (строки где пробелы не учитываются) и от строк где результат переменных равен |NOT USED|.

Индекс указывается так - [ИНДЕКС] (Пример: |PARS|[1])

ХОТКЕИ

ПЕРЕМЕННЫЕ

ОПРЕДЕЛЕНИЯ

ЛОГИЧЕСКИЕ ОПЕРАТОРЫ

ЛОГИЧЕСКИЕ БЛОКИ

СКРИПТ-БОКС

Теги для многострочного кода

Операторы

Присваивание

Комментарии

Линейные логические блоки

Критическая секция

Результаты

Пример полноценного скрипта

Пояснение:

Подключение кода из динамических переменных

Специальная функция

РАСШИРЕННАЯ СТАТИСТИКА

КОНТЕЙНЕР

ФУНКЦИИ

|MD5|

|BASE64|

|SHA1|

|SHA256|

|SHA512|

|FILETOBASE64|

|RANDOM|

|LOWER|

|UPPER|

|FUPPER|

|REMOVENUM|

|URLENCODE|

|URLDECODE|

|FDSPACE|

|EDSPACE|

|SCRIPT|

|DEMPTYSTR|

|DUPDEL|

|GETLINE|

|GETCHAR|

|GETCOUNT|

|MATH|

|LENGTH|

|SIMPLEPARS|

|REGEXPARS|

|REPLACESTR|

|REGREPLACE|

|EVAL|

|JSESCAPE|

|SCRIPTBOX|

|DLL|

|SLEEP|

|REPEAT|

|STOP|

|PAUSE|

|ADDID|

|DELID|

|DELPROXY|

|FREEZEPROXY|

|NEXTPROXY|

|UNIXTODATE|

|USEPROXY|

|PRINT|

|REGEXGLUE|

|SIMPLEGLUE|

|ESCJSON|

|PBKDF2KEY|

|SCRYPT|

|BASE64DECODE|

|SHA3HASH|

|SHA2HASH|

|BCRYPT|

|AESENCRYPT|

|AESDECRYPT|

|AESGCMENCRYPT|

|AESGCMDECRYPT|

Функция |RSAENCRYPT|

Функция |RSADECRYPT|

Возвращаемое значение

Исключения

Функция `|RSAENCRYPT|`

Функция `|RSADECRYPT|`

Функция `|RSAKEYGEN|`

Функция `|PROTOBUF|`