Конфигурирование цепочек#

Механизм работы#

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

1. Каждая объявленная цепочка есть дерево действий, в общем случае независимая друг от друга.

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

3. Цепочки гарантировано будут выполнены последовательно только в том случае, если не существует ни одного отложенного (асинхронного) действия ни в одной из них. В настоящий момент существуют определенные асинхронные действия - AntivirusFileChecker и ICAPFileChecker.

4. Основной смысл объединения действий в одну цепочку заключается в возможности, инициализируя корневое действие одним сообщением, выполнять цепочку преобразований и проверок над ним и получающихся в результате преобразований над ним данных.

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

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

7. Действия манипулятора с переменными могут располагаться в любом месте цепочки, однако при этом следует учитывать, что требования в п. 6 должны выполняться.

Конфигурирование цепочек#

Пример конфигурационного файла с использованием цепочек приведен в разделе.

Рассмотрим структуру и назначение элементов.

Элемент chains объявляется внутри элементов — сервисов и является корневым для все цепочек действий. В зависимости от того, к какому объекту, request или response, применяется цепочка действий, объявляется секция request_chains или response_chains, при этом обе секции могут быть объявлены одновременно. В каждой из этих секций может быть объявлен список цепочек, каждый элемент из которых имеет следующие параметры:

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

Для request_chains в секции request_chain_properties:

Для response_chains в секции response_chain_properties:

Переменные#

1. Для получения информации о результате выполнения цепочек определены следующие переменные:

   • clj_request_chain_result

     Результат выполнения цепочки действий над запросом.

     Возможные варианты:

     • complete, deny, error;

     • complete — выполнено без ошибок;

     • deny — заблокировано;

     • error — ошибка.

   • clj_error_action

     Действие, вызвавшее блокировку/ошибку — начиная с версии 2.2.

   • clj_processing_phase

     Фаза выполнения цепочки, request или response.

   • clj_response_chain_result

     Результат выполнения цепочки действий над ответом.

     Возможные варианты:

     • complete, deny, error;

     • complete - выполнено без ошибок;

     • deny - заблокировано;

     • error -ошибка.

2. При описании цепочек, если предполагается заполнять какие-либо переменные, отличные от встроенных, то необходимо объявлять их либо с префиксом clj_ либо объявлять их в конфигурации с использованием директивы set_varialble в секции optional сервиса.

3. Переменные для доступа к содержимому данных запроса ответа:

   • clj_message_mime_type

     MIME-тип текущего сообщения.

   • clj_request_body

     Тело запроса.

   • clj_response_body

     Тело ответа.

Конфигурирование действий#

Рассмотрим определение действия:

- action: AnyAction
    conditions:
      {список условий}
    params:
      {список параметров}
    {actions:}

Определение каждого действия состоит собственно из названия действия (элемент из перечисленных действий), условий, при которых данное действие выполняется (conditions) — безотносительно того, какое это действие, данный элемент используется универсально (при этом может отсутствовать, если действие должно выполняться всегда, если до него дошла очередь), секции специфичных параметров действия — params (какие параметры должны задаваться определяется реализацией действий) и список дочерних действий, каждый из которых рекурсивно имеет такую же структуру.

Каждое условие состоит из трех элементов:

• var — переменная или выражение из переменных

• val — значение с которым будет сравниваться значение var. В качестве val может использоваться:

  • константа;

  • переменная, их сочетания или сочетания с константами;

  • данные из файла.

• operator — операция сравнения, одно из значений:

  • «=» — равенство (при сравнении строк используется посимвольное сравнение);

  • «>» — больше, для числовых значений;

  • «<» — меньше, для числовых значений;

  • «>=» — больше или равно, для числовых значений;

  • «<=» — меньше или равно, для числовых значений;

  • «in» — вхождение в перечисление;

  • «not_in» — отсутствие вхождения;

  • «!=» — неравенство значений;

  • «~» — регулярное выражение с учетом регистра символов;

  • «~*» — регулярное выражение без учета регистра символов;

  • «!~» — негативное регулярное выражение с учетом регистра символов;

  • «!~*» — негативное регулярное выражение без учета регистра символов.