防火墙组profile表

防火墙账户profile表

NAME

组profile名称。

MODE

当前操作模式。允许的模式值是 OFF、DETECTING、PROTECTING 和 RECORDING。关于它们的含义，请参阅防火墙概念。

USERHOST

组-profile的训练账户，用于在RECORDING模式下使用。该值是NULL，或者非NULL账户，以格式user_name@host_name形式：

NAME

组-profile名称。

RULE

normalized 语句，表示profile允许的语句模式。一个profile允许列表是其规则的并集。

ID

整数列，是该表的主键。

GROUP_ID

组 profile 名称。

MEMBER_ID

该 profile 的账户名称。

USERHOST

账户配置文件名称。每个账户名称的格式为 user_name@host_name。

MODE

配置文件当前的操作模式。允许的模式值是 OFF，DETECTING，PROTECTING，RECORDING 和 RESET。关于它们的含义，请参阅防火墙概念。

USERHOST

账户配置名称。每个账户名称的格式为 user_name@host_name。

RULE

一个 normalize 语句，表示配置文件的可接受语句模式。配置文件白名单是其规则的并集。

ID

一个整数列，是该表的主键。

防火墙组 profile 存储过程

防火墙账户 profile 存储过程

防火墙其他存储过程

sp_firewall_group_delist(group, user)

这个存储过程从防火墙组 profile 中删除一个账户。

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

参数：

示例：

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

sp_firewall_group_enlist(group, user)

该存储过程将账户添加到防火墙组-profile中，不需要在添加前注册账户本身。

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

参数：

示例：

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

sp_reload_firewall_group_rules(group)

该存储过程提供了对防火墙操作的控制，用于重新加载组-profile中的内存规则，从firewall-database.firewall_group_allowlist 表中获取规则。

参数：

示例：

CALL mysql.sp_reload_firewall_group_rules('myapp');

sp_set_firewall_group_mode(group, mode)

该存储过程在注册组件防火墙配置文件后，确定防火墙组件的操作模式。该过程还会根据需要调用防火墙管理函数，以将防火墙数据从缓存中转移到持久存储中。这过程可以在 mysql_firewall_mode 系统变量为 OFF 时调用，虽然设置配置模式对防火墙没有实际操作效果，直到防火墙启用。

如果配置文件之前已经存在，那么对其的记录限制保持不变。要设置或清除限制，请调用 sp_set_firewall_group_mode_and_user()。

参数：

示例：

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

sp_set_firewall_group_mode_and_user(group, mode, user)

这个存储过程将组注册到防火墙，并像 sp_set_firewall_group_mode() 一样，指定组在 RECORDING 模式下使用的训练账户。

参数：

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

sp_reload_firewall_rules(user)

这个存储过程为单个账户配置提供防火墙操作控制。该过程使用防火墙管理函数从firewall-database.firewall_whitelist 表中重新加载账户配置的内存规则。

参数：

CALL sp_reload_firewall_rules('fwuser@localhost');

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

sp_set_firewall_mode(<em class="replaceable"><code>user</code>, <em class="replaceable"><code>mode</code>)

该存储过程在注册帐户配置文件到防火墙后，设置防火墙帐户配置文件的操作模式。该过程也会根据需要调用防火墙管理函数，以将防火墙数据从缓存传输到持久存储中。即使mysql_firewall_mode系统变量为OFF，也可以调用该过程，但设置配置文件的模式直到防火墙启用时才生效。

参数：

将账户配置文件切换到任何模式，但不是RECORDING，同步其防火墙缓存数据到提供持久底层存储的数据库表（mysql或自定义）。从OFF切换到RECORDING重新加载来自firewall-database.firewall_whitelist表的允许列表到缓存。

如果账户配置文件为空允许列表，它的模式不能设置为PROTECTING因为该配置文件将拒绝每个语句，实际上禁止账户执行语句。在对这种模式设置尝试中，防火墙产生诊断信息而不是SQL错误：

mysql> CALL 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版本中删除。请参阅将账户配置文件迁移到组配置文件。

sp_migrate_firewall_user_to_group(user, group)

sp_migrate_firewall_user_to_group()存储过程将防火墙账户配置文件转换为组配置文件，账户作为其唯一的成员。运行firewall_profile_migration.sql脚本来安装它。转换过程在将账户配置文件迁移到组配置文件中讨论。

该存储程序需要FIREWALL_ADMIN特权。

参数：

示例：

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

防火墙组 profile 函数

防火墙帐户 profile 函数

防火墙杂项函数

firewall_group_delist(组, 用户)

这个函数从组 profile 中删除一个账户。它需要FIREWALL_ADMIN特权。

示例：

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

firewall_group_enlist(组, 用户)

这个函数将账户添加到组 profile 中。它也需要FIREWALL_ADMIN特权。

不需要在添加账户到组之前注册账户本身到防火墙中。

示例：

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

read_firewall_group_allowlist(组, 规则)

通过SELECT语句在firewall-database.firewall_group_allowlist表中更新记錄的语句组 profile，需要FIREWALL_ADMIN权限。

示例：

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

read_firewall_groups(group, mode, user)

通过SELECT语句在firewall-database.firewall_groups表中更新防火墙组 profile，需要FIREWALL_ADMIN权限。

示例：

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

set_firewall_group_mode(group, mode[, user])

该函数管理组 profile 缓存，确定 profile 运行模式，并可选地指定 profile 训练账户，需要FIREWALL_ADMIN权限。

如果不提供可选的user参数，任何之前的user设置将保持不变。要更改设置，请使用第三个参数调用函数。

如果提供可选的user参数，它指定了组 profile 的训练账户，在profile处于RECORDING模式时使用。该值是NULL，或格式为user_name@host_name的非NULL账户：

示例：

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

read_firewall_users(user, mode)

该聚合函数通过对firewall-database.firewall_users 表执行 SELECT 语句来更新防火墙账户配置缓存。它需要FIREWALL_ADMIN特权或已弃用的SUPER特权。

示例：

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

该函数已经废弃，可能在未来 MySQL 版本中被删除。请参阅将账户配置迁移到组配置。

read_firewall_whitelist(user, rule)

该聚合函数通过对firewall-database.firewall_whitelist 表执行 SELECT 语句来更新记录语句缓存。它需要FIREWALL_ADMIN特权或已弃用的SUPER特权。

示例：

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

该函数已经废弃，可能在未来 MySQL 版本中被删除。请参阅将账户配置迁移到组配置。

set_firewall_mode(<用户>, <模式>)

该函数管理账户配置缓存并确定配置操作模式。它需要FIREWALL_ADMIN特权或已弃用的SUPER特权。

示例：

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

该函数已经废弃，可能在未来 MySQL 版本中删除。请参阅将账户配置迁移到组配置。

mysql_firewall_flush_status()

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

该函数需要FIREWALL_ADMIN特权或已弃用的SUPER特权。

示例：

SELECT mysql_firewall_flush_status();

normalize_statement(stmt)

该函数将 SQL 语句 normalize 到用于 allowlist 规则的摘要形式。它需要FIREWALL_ADMIN特权或已弃用的SUPER特权。

示例：

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

mysql_firewall_database

指定 MySQL 企业防火墙从哪个数据库读取数据。通常，MYSQL_FIREWALL 服务器端插件将其内部数据（表、存储过程和函数）存储在 mysql 系统数据库中，但是您可以创建并使用自定义架构（见安装 MySQL 企业防火墙）。这个变量允许在启动时指定备用数据库名称。

mysql_firewall_mode

是否启用 MySQL 企业防火墙（默认）或禁用。

mysql_firewall_reload_interval_seconds

指定服务器端插件从防火墙表中重新加载其内部缓存的间隔（以秒为单位）。当mysql_firewall_reload_interval_seconds的值为零（默认）时，不会在运行时周期性地重新加载数据。介于0和60(1到59)之间的值不被插件认可，而是自动调整为60。

这个变量需要scheduler组件启用（ON）。更多信息，请见调度防火墙缓存重新加载。

mysql_firewall_trace

是否启用或禁用 MySQL 企业防火墙追踪（默认情况下）。当 mysql_firewall_trace 启用时，在保护模式下，防火墙将被拒绝的语句写入错误日志。

Firewall_access_denied

MySQL 企业防火墙拒绝的语句数量。

Firewall_access_granted

MySQL 企业防火墙接受的语句数量。

防火墙访问疑似

MySQL Enterprise 防火墙为处于DETECTING模式的用户记录的语句数量。

防火墙缓存条目

MySQL Enterprise 防火墙记录的语句数量，包括重复语句。