[Назад] [Содержание]

# 6. Взаимодействие с внешним миром

## 6.1. Протокол

Для передачи информации применяется 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 .

## 6.2. Сетевой интерфейс

Для пользователя на своём рабочем месте, tv3 является web-сервером, к которому можно обратиться интернет-браузером способным обрабатывать XML/XSLT данные (например, одним из множества mozilla).

## 6.3. PIPE-интерфейс

Для простого доступа к управлению и чтению состояния tv3 используется механизм межпрограммного взаимодействия pipe. Через pipe-интерфейс поддерживается стандартный http-протокол. Это позволяет легко строить REXX-скрипты для управления tv3 и получения информации для дальнейшей обработки.

В составе пакета tv3 имеются утилиты написанные на стандартном REXX:

setfilter.cmd – установка нового фильтра;
reader.cmd – получение фильтра, статистик и сброса статистик.

Каждая из них выдаёт справку по использованию при запуске без параметров.

[Назад] [Содержание]