Для передачи информации применяется http-протокол, что позволяет без дополнительного уникального ПО получать информацию через сеть используя любой интернет-браузер поддерживающий формат данных XML/XSLT или другое ПО, ориентированное на работу с WEB-сервисом. tv3 будет обрабатывать следующие запросы:
GET:
/filter – структура фильтра и текущие статистики правил
/statistic – статистики правил. Выдаётся не древовидная структура, состоящая из элементов указывающих id правила, поле path, поля sent и recv. Поддерживаются несколько параметров:
Компактная форма записи результатов:
/statistic?compact=Y
Условия для запроса статистик интересующих правил:
/statistic?path=local/users/*&sent=gt098834&recv=gt843243
/statistic?path=services/external/*&sent=gt098834&br=Y
Параметр path задаёт маску, которая будет сравниваться с полями path правил. Параметры sent и recv задают условия для значений полей sent и recv фильтра, могут применяться суффиксы gt (больше) и lt (меньше). Параметр br=Y указывает, что в результат обработки запроса необходимо включать вложенные правила правил, соответствующих запросу.
/status – некоторые данные о текущем состоянии и конфигурации tv3.
/observer – отслеживание пакетов, попадающих в выбранное правило. Сначала необходимо выбрать отслеживаемое правило запросом /observer?id=N, где N – id правила. На последующие запросы без параметра будет возвращаться информация о нескольких последних пакетах, попавших в выбранное правило (направление передачи, адреса источника и приёмника, длинна пакета). Для остановки отслеживания пакетов необходимо выполнить запрос /observer?id=-1 . Для выполнения этого запроса необходимы права администратора.
POST:
/filter – установка нового фильтра пакетов. Фильтр должен быть передан с использованием content-type multipart/form-data и именем файла "filter.xml". Для выполнения этого запроса необходимы права администратора.
DELETE:
/statistic - сброс (обнуление) статистик. Могут быть указаны условия выборки правил, статистики которых должны быть сброшены (см. GET /statistic).
Более подробно ознакомиться с работой запросов можно изучив скрипт <директория tv3>\REXX\read.cmd .
Для пользователя на своём рабочем месте, tv3 является web-сервером, к которому можно обратиться интернет-браузером способным обрабатывать XML/XSLT данные (например, одним из множества mozilla).
Для простого доступа к управлению и чтению состояния tv3 используется механизм межпрограммного взаимодействия pipe. Через pipe-интерфейс поддерживается стандартный http-протокол. Это позволяет легко строить REXX-скрипты для управления tv3 и получения информации для дальнейшей обработки.
В составе пакета tv3 имеются утилиты написанные на стандартном REXX:
setfilter.cmd – установка нового фильтра;
reader.cmd – получение фильтра, статистик и сброса статистик.
Каждая из них выдаёт справку по использованию при запуске без параметров.