该keyring_oci插件是一个密钥环插件，可与 Oracle Cloud Infrastructure Vault 通信以进行后端存储。没有关键信息永久存储在 MySQL 服务器本地存储中。所有密钥都存储在 Oracle Cloud Infrastructure Vault 中，使该插件非常适合 Oracle Cloud Infrastructure MySQL 客户管理其 MySQL Enterprise Edition 密钥。

该keyring_oci插件支持构成标准 MySQL Keyring 服务接口的功能。可以在两个级别访问由这些函数执行的密钥环操作：

示例（使用 SQL 接口）：

SELECT keyring_key_generate('MyKey', 'AES', 32);
SELECT keyring_key_remove('MyKey');

有关 允许的密钥值特征的信息keyring_oci，请参阅 第 6.4.4.13 节，“支持的密钥环密钥类型和长度”。

要安装keyring_oci，请使用 第 6.4.4.3 节“Keyring 插件安装”中的一般说明，以及此处提供的特定配置信息 keyring_oci。特定于插件的配置涉及设置许多系统变量以指示 Oracle Cloud Infrastructure 资源的名称或值。

假设您熟悉 Oracle Cloud Infrastructure 概念，但在设置keyring_oci插件要使用的资源时，以下文档可能会有所帮助：

该keyring_oci插件支持下表所示的配置参数。要指定这些参数，请将值分配给相应的系统变量。

要在服务器启动过程中可用， keyring_oci必须使用该 --early-plugin-load选项加载。如上表所示，几个与插件相关的系统变量是必需的，也必须设置：

除了强制系统变量之外， keyring_oci_ca_certificate 还可以选择设置为指定用于对等身份验证的证书颁发机构 (CA) 证书捆绑文件。

例如，要加载和配置 ，请在服务器文件 keyring_oci中使用这些行 （根据需要调整平台的后缀和文件位置）： my.cnf.so

[mysqld]
early-plugin-load=keyring_oci.so
keyring_oci_user=ocid1.user.oc1..longAlphaNumericString
keyring_oci_tenancy=ocid1.tenancy.oc1..longAlphaNumericString
keyring_oci_compartment=ocid1.compartment.oc1..longAlphaNumericString
keyring_oci_virtual_vault=ocid1.vault.oc1.iad.shortAlphaNumericString.longAlphaNumericString
keyring_oci_master_key=ocid1.key.oc1.iad.shortAlphaNumericString.longAlphaNumericString
keyring_oci_encryption_endpoint=shortAlphaNumericString-crypto.kms.us-ashburn-1.oraclecloud.com
keyring_oci_management_endpoint=shortAlphaNumericString-management.kms.us-ashburn-1.oraclecloud.com
keyring_oci_vaults_endpoint=vaults.us-ashburn-1.oci.oraclecloud.com
keyring_oci_secrets_endpoint=secrets.vaults.us-ashburn-1.oci.oraclecloud.com
keyring_oci_key_file=file_name
keyring_oci_key_fingerprint=12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef

有关 keyring_oci插件特定系统变量的其他信息，请参阅第 6.4.4.19 节，“密钥环系统变量”。

该keyring_oci插件不支持运行时重新配置，并且其系统变量都不能在运行时修改。要更改配置参数，请执行以下操作：