Просмотр правил профиля приложений¶

Отображение структуры приложений¶

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

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

В описании ветки две звездочки ** означают любое количество вложенных путей. Например, в ветку /**/*.php попадут и /index.php, и /app/admin/install.php.

Размер синего кружка показывает относительное количество вложенных подветок. Его цвет — относительное количество правил в ветке и её подветках. На каждом уровне вложенности размер и цвет кружков определены независимо.

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

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

Отображение правил¶

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

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

Для каждого правила отображаются время последнего изменения, количество, типы и point.

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

Правила по умолчанию¶

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

• Чтобы создать правило по умолчанию, следуйте общей процедуре, но оставьте строку URI пустой. Будет создано правило, не привязанное к какому-либо эндпоинту.

• Чтобы просмотреть список созданных правил по умолчанию, нажмите кнопку Правила по умолчанию.

Правила по умолчанию наследуются всеми ветками правил.

Прямые и унаследованные правила¶

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

• Все ветки наследуют правила по умолчанию.

• Дочерние эндпоинты наследуют правила родительских.

• Прямые правила имеют приоритет над унаследованными.

• Условия типа EQUAL и IEQUAL имеют приоритет над REGEX.

• Чувствительные к регистру условия имеют приоритет над нечувствительными.

При работе с ветками правил:

• Чтобы раскрыть ветку, нажмите синий кружок.

• Эндпоинты, для которых нет прямых правил, отображаются серым шрифтом, перейти к просмотру правил для них нельзя.

  

• Для просмотра правил для эндпоинта, нажмите на его адрес. Сначала отобразятся только прямые правила для этого эндпоинта.

• При просмотре правил для эндпоинта, нажмите Прямые и унаследованные правила для отображения унаследованных правил. Унаследованные правила будут отображены вместе с прямыми, унаследованные – серым шрифтом.

  

Запросы к API на получение правил¶

Чтобы получить набор правил, вы можете отправить запрос к Вебмониторэкс API напрямую, вместо использования интерфейса Консоли управления. Примеры запросов приведены ниже.

Получение всех правил

curl -v -X POST "https://api.wallarm.ru/v1/objects/hint" -H "accept: application/json" -H "Content-Type: application/json" -H "X-WallarmApi-Token: {ВАШ API ТОКЕН}" -d "{\"filter\":{\"clientid\": [YOUR_CLIENT_ID]},\"order_by\": \"updated_at\",\"order_desc\": true,\"limit\": 1000,\"offset\": 0}"

Получение условий всех правил

curl -v -X POST "https://api.wallarm.ru/v1/objects/action" -H "accept: application/json" -H "Content-Type: application/json" -H "X-WallarmApi-Token: {ВАШ API ТОКЕН}" -d "{ \"filter\": { \"clientid\": [YOUR_CLIENT_ID] }, \"offset\": 0, \"limit\": 1000}"

Получение правил с определенным условием

Чтобы указать определенное условие, используйте его ID. Вы можете скопировать ID условия из ответа на запрос выше.

curl -v -X POST "https://api.wallarm.ru/v1/objects/hint" -H "accept: application/json" -H "Content-Type: application/json" -H "X-WallarmApi-Token: {ВАШ API ТОКЕН}" -d "{\"filter\":{\"clientid\": [YOUR_CLIENT_ID],\"actionid\": YOUR_CONDITION_ID},\"limit\": 1000,\"offset\": 0}"