keyring_aws_cmk_id

从 AWS KMS 服务器获取的 KMS 密钥 ID，由 keyring_aws 插件使用。 除非安装了该插件，否则此变量不可用。

此变量是必需的。 如果未指定，keyring_aws 初始化失败。

keyring_aws_conf_file

keyring_aws 插件的配置文件位置。 除非安装了该插件，否则此变量不可用。

在插件启动时，keyring_aws 会从配置文件中读取 AWS 密钥访问密钥 ID 和密钥。 为了使 keyring_aws 插件成功启动，配置文件必须存在并包含有效的密钥访问密钥信息，如 第 8.4.4.7 节，“使用 keyring_aws Amazon Web Services 密钥环插件” 中所述初始化。

默认文件名是 keyring_aws_conf，位于默认的密钥环文件目录中。

keyring_aws_data_file

keyring_aws 插件的存储文件位置。 除非安装了该插件，否则此变量不可用。

在插件启动时，如果分配给 keyring_aws_data_file 的值指定了一个不存在的文件，则 keyring_aws 插件会尝试创建该文件（如果需要，还会创建其父目录）。 如果文件已存在，keyring_aws 会将文件中包含的任何加密密钥读入其内存缓存。 keyring_aws 不会在内存中缓存未加密的密钥。

默认文件名是 keyring_aws_data，位于默认的密钥环文件目录中。

keyring_aws_region

keyring_aws 插件的 AWS 区域。 除非安装了该插件，否则此变量不可用。

keyring_hashicorp_auth_path

在 HashiCorp Vault 服务器中启用 AppRole 身份验证的认证路径，供 keyring_hashicorp 插件使用。 除非安装了该插件，否则此变量不可用。

keyring_hashicorp_ca_path

MySQL 服务器可访问的本地文件绝对路径名，该文件包含 keyring_hashicorp 插件使用的格式正确的 TLS 证书颁发机构。 除非安装了该插件，否则此变量不可用。

如果未设置此变量，keyring_hashicorp 插件将打开一个 HTTPS 连接，而无需使用服务器证书验证，并信任 HashiCorp Vault 服务器提供的任何证书。 为确保安全，必须假设 Vault 服务器不是恶意的，并且不可能进行中间人攻击。 如果这些假设无效，请将 keyring_hashicorp_ca_path 设置为受信任的 CA 证书的路径。 （例如，对于 证书和密钥准备 中的说明，这是 company.crt 文件。）

keyring_hashicorp_caching

是否启用 keyring_hashicorp 插件使用的可选内存中密钥缓存，以缓存来自 HashiCorp Vault 服务器的密钥。 除非安装了该插件，否则此变量不可用。 如果启用了缓存，插件将在初始化期间填充缓存。 否则，插件仅在初始化期间填充密钥列表。

启用缓存是一种折衷方案：它可以提高性能，但在内存中维护敏感密钥信息的副本，这在安全方面可能不可取。

keyring_hashicorp_commit_auth_path

此变量与 keyring_hashicorp_auth_path 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_commit_ca_path

此变量与 keyring_hashicorp_ca_path 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_commit_caching

此变量与 keyring_hashicorp_caching 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_commit_role_id

此变量与 keyring_hashicorp_role_id 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_commit_server_url

此变量与 keyring_hashicorp_server_url 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_commit_store_path

此变量与 keyring_hashicorp_store_path 相关联，它在 keyring_hashicorp 插件初始化期间获取其值。 除非安装了该插件，否则此变量不可用。 它反映了如果初始化成功，插件操作实际使用的 “已提交” 值。 有关更多信息，请参阅 keyring_hashicorp 配置。

keyring_hashicorp_role_id

HashiCorp Vault AppRole 身份验证角色 ID，供 keyring_hashicorp 插件使用。 除非安装了该插件，否则此变量不可用。 该值必须采用 UUID 格式。

此变量是必需的。 如果未指定，keyring_hashicorp 初始化将失败。

keyring_hashicorp_secret_id

HashiCorp Vault AppRole 身份验证密钥 ID，供 keyring_hashicorp 插件使用。 除非安装了该插件，否则此变量不可用。 该值必须采用 UUID 格式。

此变量是必需的。 如果未指定，keyring_hashicorp 初始化将失败。

此变量的值很敏感，因此在显示时其值会用 * 字符掩盖。

keyring_hashicorp_server_url

HashiCorp Vault 服务器 URL，供 keyring_hashicorp 插件使用。 除非安装了该插件，否则此变量不可用。 该值必须以 https:// 开头。

keyring_hashicorp_store_path

HashiCorp Vault 服务器中的存储路径，在 keyring_hashicorp 插件提供适当的 AppRole 凭据时可写。 除非安装了该插件，否则此变量不可用。 要指定凭据，请设置 keyring_hashicorp_role_id 和 keyring_hashicorp_secret_id 系统变量（例如，如 keyring_hashicorp 配置 中所示）。

此变量是必需的。 如果未指定，keyring_hashicorp 初始化将失败。

keyring_okv_conf_dir

存储 keyring_okv 插件使用的配置信息的目录路径名。 除非安装了该插件，否则此变量不可用。 该位置应为仅供 keyring_okv 插件使用的目录。 例如，不要将目录放在数据目录下。

默认的 keyring_okv_conf_dir 值为空。 为了使 keyring_okv 插件能够访问 Oracle Key Vault，该值必须设置为包含 Oracle Key Vault 配置和 SSL 材料的目录。 有关设置此目录的说明，请参阅 第 8.4.4.6 节，“使用 keyring_okv KMIP 插件”。

该目录应具有限制性模式，并且只能由用于运行 MySQL 服务器的帐户访问。 例如，在 Unix 和类 Unix 系统上，要使用 /usr/local/mysql/mysql-keyring-okv 目录，以下命令（以 root 身份执行）将创建目录并设置其模式和所有权

cd /usr/local/mysql
mkdir mysql-keyring-okv
chmod 750 mysql-keyring-okv
chown mysql mysql-keyring-okv
chgrp mysql mysql-keyring-okv

如果分配给 keyring_okv_conf_dir 的值指定了一个不存在的目录，或者不包含能够建立与 Oracle Key Vault 连接的配置信息的目录，keyring_okv 会将错误消息写入错误日志。 如果对 keyring_okv_conf_dir 的运行时赋值尝试导致错误，则变量值和密钥环操作将保持不变。

keyring_operations

是否启用密钥环操作。 此变量在密钥迁移操作期间使用。 请参阅 第 8.4.4.11 节，“在密钥环密钥库之间迁移密钥”。 修改此变量所需的权限是 ENCRYPTION_KEY_ADMIN 以及 SYSTEM_VARIABLES_ADMIN 或已弃用的 SUPER 权限。