防火墙组配置文件表

防火墙帐户配置文件表

NAME

组配置文件名称。

MODE

配置文件的当前操作模式。允许的模式值为OFF、 DETECTING、 PROTECTING和 RECORDING。有关它们的详细信息，请参阅防火墙概念。

USERHOST

组配置文件的培训帐户，在配置文件处于RECORDING模式时使用。值为NULL，或具有以下格式的非NULL帐户 ： user_name@host_name

NAME

组配置文件名称。

RULE

规范化语句，指示配置文件可接受的语句模式。配置文件白名单是其规则的集合。

ID

作为表主键的整数列。

GROUP_ID

组配置文件名称。

MEMBER_ID

作为配置文件成员的帐户的名称。

USERHOST

帐户配置文件名称。每个帐户名的格式都是 . user_name@host_name

MODE

配置文件的当前操作模式。允许的模式值为OFF、 DETECTING、 PROTECTING、 RECORDING和 RESET。有关它们的详细信息，请参阅防火墙概念。

USERHOST

帐户配置文件名称。每个帐户名的格式都是 . user_name@host_name

RULE

规范化语句，指示配置文件可接受的语句模式。配置文件白名单是其规则的集合。

ID

作为表主键的整数列。此列是在 MySQL 8.0.12 中添加的。

防火墙组配置文件存储过程

防火墙帐户配置文件存储过程

防火墙杂项存储过程

sp_firewall_group_delist(group, user)

此存储过程从防火墙组配置文件中删除一个帐户。

如果调用成功，组成员身份的更改将同时应用于内存缓存和持久存储。

参数：

例子：

CALL sp_firewall_group_delist('g', 'fwuser@localhost');

这个过程是在 MySQL 8.0.23 中添加的。

sp_firewall_group_enlist(group, user)

此存储过程将帐户添加到防火墙组配置文件。在将帐户添加到组之前，无需向防火墙注册帐户本身。

如果调用成功，组成员身份的更改将同时应用于内存缓存和持久存储。

参数：

例子：

CALL sp_firewall_group_enlist('g', 'fwuser@localhost');

这个过程是在 MySQL 8.0.23 中添加的。

sp_reload_firewall_group_rules(group)

此存储过程为各个组配置文件提供对防火墙操作的控制。mysql.firewall_group_allowlist 该过程使用防火墙管理功能从存储在表 中的规则中重新加载组配置文件的内存中规则。

参数：

例子：

CALL sp_reload_firewall_group_rules('myapp');

这个过程是在 MySQL 8.0.23 中添加的。

sp_set_firewall_group_mode(group, mode)

如果配置文件尚未注册，则在向防火墙注册配置文件后，此存储过程会为防火墙组配置文件建立操作模式。该过程还根据需要调用防火墙管理功能，以在缓存和持久存储之间传输防火墙数据。即使mysql_firewall_mode系统变量是，也可以调用此过程OFF，尽管在启用防火墙之前设置配置文件的模式没有操作效果。

如果配置文件以前存在，则它的任何录制限制都保持不变。要设置或清除限制，请 sp_set_firewall_group_mode_and_user() 改为调用。

参数：

例子：

CALL sp_set_firewall_group_mode('myapp', 'PROTECTING');

这个过程是在 MySQL 8.0.23 中添加的。

sp_set_firewall_group_mode_and_user(group, mode, user)

此存储过程向防火墙注册一个组并建立其操作模式，类似于 ，但还指定组处于模式 sp_set_firewall_group_mode()时要使用的培训帐户。RECORDING

参数：

例子：

CALL sp_set_firewall_group_mode_and_user('myapp', 'RECORDING', 'myapp_user1@localhost');

这个过程是在 MySQL 8.0.23 中添加的。

sp_reload_firewall_rules(user)

此存储过程为个人帐户配置文件提供对防火墙操作的控制。该过程使用防火墙管理功能从表中存储的规则中重新加载帐户配置文件的内存规则mysql.firewall_whitelist 。

参数：

例子：

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

从 MySQL 8.0.26 开始，此过程已弃用，并可能在未来的 MySQL 版本中删除。请参阅 将帐户配置文件迁移到组配置文件。

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 allowlist is empty. |
+----------------------------------------------------------------------+

从 MySQL 8.0.26 开始，此过程已弃用，并可能在未来的 MySQL 版本中删除。请参阅 将帐户配置文件迁移到组配置文件。

sp_migrate_firewall_user_to_group(user, group)

从 MySQL 8.0.26 开始，帐户配置文件已被弃用，因为组配置文件可以执行帐户配置文件可以执行的任何操作。存储过程将 sp_migrate_firewall_user_to_group() 防火墙帐户配置文件转换为组配置文件，并将该帐户作为其单个登记成员。转换过程在将 帐户配置文件迁移到组配置文件中进行了讨论。

此例程需要 FIREWALL_ADMIN特权。

参数：

例子：

CALL sp_migrate_firewall_user_to_group('fwuser@localhost', 'mygroup);

这个过程是在 MySQL 8.0.26 中添加的。

防火墙组配置文件功能

防火墙帐户配置文件功能

防火墙杂项功能

firewall_group_delist(group, user)

此函数从组配置文件中删除一个帐户。它需要FIREWALL_ADMIN 特权。

例子：

SELECT firewall_group_delist('g', 'fwuser@localhost');

MySQL 8.0.23 新增此功能。

firewall_group_enlist(group, user)

此函数将帐户添加到组配置文件。它需要FIREWALL_ADMIN 特权。

在将帐户添加到组之前，无需向防火墙注册帐户本身。

例子：

SELECT firewall_group_enlist('g', 'fwuser@localhost');

MySQL 8.0.23 新增此功能。

read_firewall_group_allowlist(group, rule)

此聚合函数通过 SELECT表上的 语句更新指定组配置文件的记录语句缓存mysql.firewall_group_allowlist。它需要 FIREWALL_ADMIN特权。

例子：

SELECT read_firewall_group_allowlist('my_fw_group', fgw.rule)
FROM mysql.firewall_group_allowlist AS fgw
WHERE NAME = 'my_fw_group';

MySQL 8.0.23 新增此功能。

read_firewall_groups(group, mode, user)

此聚合函数通过SELECT 表上的语句更新防火墙组配置文件缓存mysql.firewall_groups 。它需要 FIREWALL_ADMIN特权。

例子：

SELECT read_firewall_groups('g', 'RECORDING', 'fwuser@localhost')
FROM mysql.firewall_groups;

MySQL 8.0.23 新增此功能。

set_firewall_group_mode(group, mode[, user])

此功能管理组配置文件缓存，建立配置文件操作模式，并可选择指定配置文件培训帐户。它需要 FIREWALL_ADMIN特权。

user如果未给出 可选参数user ，则配置文件的任何先前设置都保持不变。要更改设置，请使用第三个参数调用该函数。

如果给出可选user参数，它指定组配置文件的培训帐户，在配置文件处于 RECORDING模式时使用。值为 NULL，或具有以下格式的非NULL 帐户 ： user_name@host_name

例子：

SELECT set_firewall_group_mode('g', 'DETECTING');

MySQL 8.0.23 新增此功能。

read_firewall_users(user, mode)

此聚合函数通过SELECT 表上的语句更新防火墙帐户配置文件缓存mysql.firewall_users 。它需要 FIREWALL_ADMIN特权或已弃用的SUPER 特权。

例子：

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

从 MySQL 8.0.26 开始，此功能已弃用，并可能在未来的 MySQL 版本中删除。请参阅 将帐户配置文件迁移到组配置文件。

read_firewall_whitelist(user, rule)

此聚合函数通过 SELECT表上的 语句更新指定帐户配置文件的记录语句缓存mysql.firewall_whitelist。它需要FIREWALL_ADMIN 特权或已弃用的 SUPER特权。

例子：

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

从 MySQL 8.0.26 开始，此功能已弃用，并可能在未来的 MySQL 版本中删除。请参阅 将帐户配置文件迁移到组配置文件。

set_firewall_mode(user, mode)

此函数管理帐户配置文件缓存并建立配置文件操作模式。它需要 FIREWALL_ADMIN特权或已弃用的SUPER 特权。

例子：

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

从 MySQL 8.0.26 开始，此功能已弃用，并可能在未来的 MySQL 版本中删除。请参阅 将帐户配置文件迁移到组配置文件。

mysql_firewall_flush_status()

此函数将几个防火墙状态变量重置为 0：

此功能需要 FIREWALL_ADMIN特权或已弃用的SUPER 特权。

例子：

SELECT mysql_firewall_flush_status();

normalize_statement(stmt)

此函数将 SQL 语句规范化为用于白名单规则的摘要形式。它需要 FIREWALL_ADMIN特权或已弃用的SUPER 特权。

例子：

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

mysql_firewall_mode

MySQL Enterprise Firewall 是启用（默认）还是禁用。

mysql_firewall_trace

MySQL Enterprise Firewall 跟踪是启用还是禁用（默认）。启用时 mysql_firewall_trace，对于PROTECTING模式，防火墙将拒绝的语句写入错误日志。

Firewall_access_denied

MySQL Enterprise Firewall 拒绝的语句数。

Firewall_access_granted

MySQL Enterprise Firewall 接受的语句数。

Firewall_access_suspicious

MySQL Enterprise Firewall 记录的对处于DETECTING模式的用户可疑的语句数。

Firewall_cached_entries

MySQL Enterprise Firewall 记录的语句数，包括重复项。