USERHOST

Имя профиля учетной записи. Каждое имя учетной записи имеет формат user_name@host_name.

MODE

Текущий режим работы для профиля. Разрешенные значения режима: OFF, DETECTING, PROTECTING, RECORDING и RESET. Подробности см. в разделе Концепции брандмауэра.

USERHOST

Имя профиля учетной записи. Каждое имя учетной записи имеет формат user_name@host_name.

RULE

Нормализованное выражение, указывающее допустимый шаблон выражения для профиля. Белый список профиля представляет собой объединение его правил.

ID

Целочисленный столбец, являющийся первичным ключом таблицы. Этот столбец был добавлен в MySQL 5.7.23.

sp_reload_firewall_rules(user)

Эта хранимая процедура предоставляет контроль над работой брандмауэра для отдельных профилей учетных записей. Процедура использует административные функции брандмауэра для перезагрузки правил в кэше для профиля учетной записи из правил, хранящихся в таблице mysql.firewall_whitelist.

Аргументы:

Пример:

CALL mysql.sp_reload_firewall_rules('fwuser@localhost');

sp_set_firewall_mode(user, mode)

Эта хранимая процедура устанавливает режим работы для профиля учетной записи брандмауэра после регистрации профиля в брандмауэре, если он ещё не был зарегистрирован. Процедура также вызывает административные функции брандмауэра при необходимости, чтобы передать данные брандмауэра между кэшем и постоянным хранилищем. Эту процедуру можно вызывать даже если системная переменная mysql_firewall_mode имеет значение OFF, хотя установка режима для профиля не оказывает операционного влияния, пока брандмауэр не включён.

Аргументы:

Переключение профиля учетной записи на любой режим, кроме RECORDING, синхронизирует данные кэша брандмауэра с таблицами базы данных системы mysql, которые обеспечивают постоянное хранение. Переключение режима с OFF на RECORDING перезагружает белый список из таблицы mysql.firewall_whitelist в кэш.

Если у профиля учетной записи пустой белый список, его режим нельзя установить в PROTECTING, поскольку профиль отклонит каждое выражение, фактически запретив учетной записи выполнять выражения. В ответ на такую попытку установки режима брандмауэр выводит диагностическое сообщение, которое возвращается в виде набора результатов, а не в виде ошибки SQL:

mysql> CALL mysql.sp_set_firewall_mode('a@b','PROTECTING');
+----------------------------------------------------------------------+
| set_firewall_mode(arg_userhost, arg_mode)                            |
+----------------------------------------------------------------------+
| ERROR: PROTECTING mode requested for a@b but the whitelist is empty. |
+----------------------------------------------------------------------+
1 row in set (0.02 sec)

Query OK, 0 rows affected (0.02 sec)

Функции профиля учетной записи брандмауэра

Разнообразные функции брандмауэра

read_firewall_users(user, mode)

Эта агрегатная функция обновляет кэш профиля учетной записи брандмауэра с помощью оператора SELECT в таблице mysql.firewall_users. Требуется привилегия SUPER.

Пример:

SELECT read_firewall_users('fwuser@localhost', 'RECORDING')
FROM mysql.firewall_users;

read_firewall_whitelist(user, rule)

Эта агрегатная функция обновляет кэш записываемых операторов для указанного профиля учетной записи с помощью оператора SELECT в таблице mysql.firewall_whitelist. Требуется привилегия SUPER.

Пример:

SELECT read_firewall_whitelist('fwuser@localhost', fw.rule)
FROM mysql.firewall_whitelist AS fw
WHERE USERHOST = 'fwuser@localhost';

set_firewall_mode(user, mode)

Эта функция управляет кэшем профиля учетной записи и устанавливает режим работы профиля. Требуется привилегия SUPER.

Пример:

SELECT set_firewall_mode('fwuser@localhost', 'RECORDING');

mysql_firewall_flush_status()

Эта функция сбрасывает несколько переменных состояния брандмауэра до 0:

Эта функция требует привилегии SUPER.

Пример:

SELECT mysql_firewall_flush_status();

normalize_statement(stmt)

Эта функция нормализует оператор SQL в форму дайджеста, используемую для правил allowlist. Требуется привилегия SUPER.

Пример:

SELECT normalize_statement('SELECT * FROM t1 WHERE c1 > 2');

mysql_firewall_mode

Включен ли брандмауэр MySQL Enterprise (по умолчанию) или отключен.

mysql_firewall_trace

Включен ли трассировка брандмауэра MySQL Enterprise или отключен (по умолчанию). Когда mysql_firewall_trace включен, для режима PROTECTING брандмауэр записывает отклоненные операторы в журнал ошибок.

Firewall_access_denied

Количество операторов, отклоненных брандмауэром MySQL Enterprise.

Firewall_access_granted

Количество операторов, принятых брандмауэром MySQL Enterprise.

Firewall_access_suspicious

Количество операторов, залогированных брандмауэром MySQL Enterprise как подозрительные для пользователей в режиме DETECTING.

Firewall_cached_entries

Количество операторов, записанных брандмауэром MySQL Enterprise, включая дубликаты.