Параметр log_masking_rules#

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

Название

Обязательность

Описание

Возможные значения

Значение по умолчанию

log_masking_rules

Опциональный

Правила маскирования

Последовательность параметров и их значения

Значение задается пользователем

log_masking_rules.object

Обязательный

Объект, к которому применяется маскирование

request_header — заголовки запроса; response_header — заголовки ответа; request_body — тело запроса; response_body — тело ответа; request_cookie — cookie запроса; response_cookie — cookie ответа

—

log_masking_rules.cookie

Обязательный (если object: request_cookie или object: response_cookie)

Имя cookie, к которой применяется маскирование

Текстовое значение

—

log_masking_rules.log_type

Опциональный

Тип логов

all — все типы; security — логи транзакций фильтра безопасности; event — логи событий

all

log_masking_rules.header

Обязательный (если object: request_header или object: response_header)

Имя заголовка, к которому применяется маскирование

Текстовое значение

Значение задается пользователем

log_masking_rules.mask_symbol

Опциональный

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

Текстовое значение

*

log_masking_rules.expression

Обязательный (если object: request_body или object: response_body)

Регулярное выражение, содержащее группы. Должно содержать хотя бы одну группу для определения фрагмента замены

Текстовое значение

Значение задается пользователем

log_masking_rules.replace_group

Обязательный (если object: request_body или object: response_body)

Номер группы в выражении, которая будет использоваться для замены тела запроса или ответа. Если 0 — замена строки полного соответствия

Текстовое значение. Диапазон от 0 до 9

Значение задается пользователем

log_masking_rules.replace_all

Опциональный

Заменять все или первое найденное значение. В том случае, если гарантировано вхождение будет только один раз рекомендуется устанавливать явно значение off для оптимизации производительности

on, off

on

log_masking_rules.exclusion

Опциональный

Исключающее маскирование — маскировать все, кроме указанного элемента (может быть несколько). Допустимо для object = request_header, response_header, request_cookie, response_cookie. Для одного типа объектов не может быть одновременно и обычное маскирование и исключающее

true, false

false

Пример:

optional:
  log_masking_rules:
    - object: request_header
      header: TOKEN
      mask_symbol: "*"
    - object: request_body
      expression: (cardNumber\W*)([\w\ ]*)
      replace_group: 2
      replace_all: on