MySQL8 中文参考(二十九)(1)https://developer.aliyun.com/article/1566122
8.4.4.4 使用基于文件的密钥环组件
component_keyring_file
密钥环组件将密钥环数据存储在服务器主机本地的文件中。
警告
对于加密密钥管理,component_keyring_file
和component_keyring_encrypted_file
组件,以及keyring_file
和keyring_encrypted_file
插件并不是用作符合法规的解决方案。PCI、FIPS 等安全标准要求使用密钥管理系统来保护、管理和保护密钥库或硬件安全模块(HSM)中的加密密钥。
要使用component_keyring_file
进行密钥库管理,您必须:
- 按照 8.4.4.2 节“密钥环组件安装”中描述的方式编写一个清单,告诉服务器加载
component_keyring_file
。 - 按照这里的描述为
component_keyring_file
编写一个配置文件。
当初始化时,component_keyring_file
会读取全局配置文件,或者全局配置文件与本地配置文件配对:
- 该组件尝试从组件库文件安装的目录(即服务器插件目录)中读取其全局配置文件。
- 如果全局配置文件指示使用本地配置文件,组件将尝试从数据目录中读取其本地配置文件。
- 尽管全局和本地配置文件位于不同的目录中,但文件名在两个位置都是
component_keyring_file.cnf
。 - 如果不存在配置文件,则无法初始化
component_keyring_file
。没有有效配置是一个错误。
本地配置文件允许设置多个服务器实例使用component_keyring_file
,以便每个服务器实例的组件配置特定于给定的数据目录实例。这使得相同的密钥环组件可以与每个实例的不同数据文件一起使用。
component_keyring_file
配置文件具有以下属性:
- 配置文件必须是有效的 JSON 格式。
- 配置文件允许设置这些配置项:
"read_local_config"
:此项仅允许在全局配置文件中。如果该项不存在,则组件仅使用全局配置文件。如果该项存在,则其值为true
或false
,指示组件是否应从本地配置文件中读取配置信息。如果全局配置文件中存在"read_local_config"
项以及其他项,则组件首先检查"read_local_config"
项的值:
- 如果值为
false
,组件将处理全局配置文件中的其他项并忽略本地配置文件。 - 如果数值为
true
,组件将忽略全局配置文件中的其他项,并尝试读取本地配置文件。
"path"
:项目值是一个字符串,用于命名用于存储密钥环数据的文件。文件应使用绝对路径而不是相对路径命名。此项目在配置中是强制性的。如果未指定,则component_keyring_file
初始化失败。"read_only"
:项目值指示密钥环数据文件是否为只读。项目值为true
(只读)或false
(读/写)。此项目在配置中是强制性的。如果未指定,则component_keyring_file
初始化失败。
- 数据库管理员有责任创建要使用的任何配置文件,并确保其内容正确。如果发生错误,服务器启动将失败,并且管理员必须根据服务器错误日志中的诊断信息纠正任何问题。
鉴于前述配置文件属性,要配置component_keyring_file
,请在安装了component_keyring_file
库文件的目录中创建一个名为component_keyring_file.cnf
的全局配置文件,并在数据目录中创建一个名为component_keyring_file.cnf
的本地配置文件(可选)。以下说明假定要以读/写方式使用名为/usr/local/mysql/keyring/component_keyring_file
的密钥环数据文件。
- 要仅使用全局配置文件,文件内容如下所示:
{ "path": "/usr/local/mysql/keyring/component_keyring_file", "read_only": false }
- 在安装了
component_keyring_file
库文件的目录中创建此文件。 - 或者,要使用全局和本地配置文件对,全局文件如下所示:
{ "read_local_config": true }
- 在安装了
component_keyring_file
库文件的目录中创建此文件。
本地文件如下所示:
{ "path": "/usr/local/mysql/keyring/component_keyring_file", "read_only": false }
- 在数据目录中创建此文件。
密钥环操作是事务性的:component_keyring_file
在写操作期间使用备份文件,以确保如果操作失败,可以回滚到原始文件。备份文件与数据文件具有相同的名称,后缀为.backup
。
component_keyring_file
支持组成标准 MySQL 密钥环服务接口的函数。这些函数执行的密钥环操作可在两个级别访问:
- SQL 接口:在 SQL 语句中,调用第 8.4.4.15 节,“通用密钥环密钥管理函数”中描述的函数。
- C 接口:在 C 语言代码中,调用第 7.6.9.2 节,“密钥环服务”中描述的密钥环服务函数。
示例(使用 SQL 接口):
SELECT keyring_key_generate('MyKey', 'AES', 32); SELECT keyring_key_remove('MyKey');
有关component_keyring_file
允许的关键值特征的信息,请参阅第 8.4.4.13 节,“支持的钥匙环键类型和长度”。
原文:
dev.mysql.com/doc/refman/8.0/en/keyring-encrypted-file-component.html
8.4.4.5 使用 component_keyring_encrypted_file 加密文件型密钥环组件
注意
component_keyring_encrypted_file
是包含在 MySQL 企业版中的扩展,这是一个商业产品。要了解更多关于商业产品的信息,请参阅 www.mysql.com/products/
。
component_keyring_encrypted_file
密钥环组件将密钥环数据存储在一个加密的、受密码保护的文件中,该文件位于服务器主机本地。
警告
对于加密密钥管理,component_keyring_file
和 component_keyring_encrypted_file
组件,以及 keyring_file
和 keyring_encrypted_file
插件并非旨在作为符合监管合规性的解决方案。诸如 PCI、FIPS 等安全标准要求使用密钥管理系统来保护、管理和保护密钥在密钥库或硬件安全模块(HSMs)中。
要使用 component_keyring_encrypted_file
进行密钥库管理,您必须:
- 编写一个清单,告诉服务器加载
component_keyring_encrypted_file
,如 8.4.4.2 节“密钥环组件安装” 中所述。 - 编写一个
component_keyring_encrypted_file
的配置文件,如此处所述。
当初始化时,component_keyring_encrypted_file
会读取全局配置文件或与本地配置文件配对的全局配置文件:
- 该组件尝试从组件库文件安装的目录(即服务器插件目录)中读取其全局配置文件。
- 如果全局配置文件指示使用本地配置文件,则组件会尝试从数据目录中读取其本地配置文件。
- 尽管全局和本地配置文件位于不同的目录中,但文件名在两个位置都是
component_keyring_encrypted_file.cnf
。 - 如果不存在预配置文件,则会出错。
component_keyring_encrypted_file
在没有有效配置的情况下无法初始化。
本地配置文件允许设置多个服务器实例使用 component_keyring_encrypted_file
,因此每个服务器实例的组件配置特定于给定的数据目录实例。这使得相同的密钥环组件可以与每个实例的不同数据文件一起使用。
component_keyring_encrypted_file
配置文件具有以下属性:
- 配置文件必须是有效的 JSON 格式。
- 配置文件允许这些配置项:
"read_local_config"
:此项仅允许在全局配置文件中出现。如果该项不存在,则组件仅使用全局配置文件。如果该项存在,则其值为true
或false
,表示组件是否应从本地配置文件中读取配置信息。如果全局配置文件中存在"read_local_config"
项以及其他项,则组件首先检查"read_local_config"
项的值:
- 如果值为
false
,组件将处理全局配置文件中的其他项,并忽略本地配置文件。 - 如果值为
true
,组件将忽略全局配置文件中的其他项,并尝试读取本地配置文件。
"path"
:该项值是一个指定用于存储密钥环数据的文件的字符串。文件应使用绝对路径而不是相对路径命名。此项在配置中是强制性的。如果未指定,component_keyring_encrypted_file
初始化将失败。"password"
:该项值是一个指定访问数据文件密码的字符串。此项在配置中是强制性的。如果未指定,component_keyring_encrypted_file
初始化将失败。"read_only"
:该项值指示密钥环数据文件是否为只读。该项值为true
(只读)或false
(读/写)。此项在配置中是强制性的。如果未指定,component_keyring_encrypted_file
初始化将失败。
- 数据库管理员有责任创建要使用的任何配置文件,并确保其内容正确。如果发生错误,服务器启动将失败,管理员必须根据服务器错误日志中的诊断信息纠正任何问题。
- 存储密码的任何配置文件应具有限制模式,并且只能由用于运行 MySQL 服务器的帐户访问。
给定前述配置文件属性,要配置component_keyring_encrypted_file
,请在安装component_keyring_encrypted_file
库文件的目录中创建一个名为component_keyring_encrypted_file.cnf
的全局配置文件,并可选择在数据目录中创建一个名为component_keyring_encrypted_file.cnf
的本地配置文件。以下说明假定要使用一个名为/usr/local/mysql/keyring/component_keyring_encrypted_file
的密钥环数据文件进行读/写操作。您还必须选择一个密码。
- 要仅使用全局配置文件,文件内容如下所示:
{ "path": "/usr/local/mysql/keyring/component_keyring_encrypted_file", "password": "*password*", "read_only": false }
- 在安装
component_keyring_encrypted_file
库文件的目录中创建此文件。 - 或者,要使用全局和本地配置文件对,全局文件如下所示:
{ "read_local_config": true }
- 在安装
component_keyring_encrypted_file
库文件的目录中创建此文件。
本地文件如下所示:
{ "path": "/usr/local/mysql/keyring/component_keyring_encrypted_file", "password": "*password*", "read_only": false }
- 在数据目录中创建此文件。
密钥环操作是事务性的:component_keyring_encrypted_file
在写操作期间使用备份文件,以确保如果操作失败,可以回滚到原始文件。备份文件与数据文件同名,后缀为.backup
。
component_keyring_encrypted_file
支持组成标准 MySQL 密钥环服务接口的函数。这些函数执行的密钥环操作可在两个级别访问:
- SQL 接口:在 SQL 语句中,调用第 8.4.4.15 节,“通用密钥环密钥管理函数”中描述的函数。
- C 接口:在 C 语言代码中,调用第 7.6.9.2 节,“密钥环服务”中描述的密钥环服务函数。
示例(使用 SQL 接口):
SELECT keyring_key_generate('MyKey', 'AES', 32); SELECT keyring_key_remove('MyKey');
有关component_keyring_encrypted_file
允许的密钥值特性的信息,请参阅第 8.4.4.13 节,“支持的密钥环密钥类型和长度”。
8.4.4.6 使用基于文件的 keyring_file 密钥环插件
keyring_file
密钥环插件将密钥环数据存储在服务器主机上的一个文件中。
截至 MySQL 8.0.34 版本,此插件已被弃用,并可能在将来的 MySQL 版本中被移除。相反,考虑使用 component_keyring_file
组件来存储密钥环数据(参见 第 8.4.4.4 节,“使用 component_keyring_file 基于文件的密钥环组件”)。
警告
对于加密密钥管理,keyring_file
插件并不是一个符合监管合规性的解决方案。诸如 PCI、FIPS 等安全标准要求使用密钥管理系统来在密钥保险库或硬件安全模块(HSM)中安全、管理和保护加密密钥。
要安装 keyring_file
,请使用 第 8.4.4.3 节,“密钥环插件安装” 中找到的一般说明,以及此处找到的特定于 keyring_file
的配置信息。
为了在服务器启动过程中可用,必须使用 --early-plugin-load
选项加载 keyring_file
。keyring_file_data
系统变量可选地配置 keyring_file
插件用于数据存储的文件位置。默认值是特定于平台的。要显式配置文件位置,请在启动时设置变量值。例如,在服务器的 my.cnf
文件中使用以下行,根据需要调整 .so
后缀和文件位置:
[mysqld] early-plugin-load=keyring_file.so keyring_file_data=/usr/local/mysql/mysql-keyring/keyring
密钥环操作是事务性的:keyring_file
插件在写操作期间使用备份文件,以确保如果操作失败,可以回滚到原始文件。备份文件的名称与 keyring_file_data
系统变量的值相同,后缀为 .backup
。
有关 keyring_file_data
的更多信息,请参阅 第 8.4.4.19 节,“密钥环系统变量”。
为了确保只有在正确的密钥环存储文件存在时才刷新密钥,keyring_file
在文件中存储了密钥环的 SHA-256 校验和。在更新文件之前,插件会验证文件是否包含预期的校验和。
keyring_file
插件支持组成标准 MySQL 密钥环服务接口的函数。这些函数执行的密钥环操作可在两个级别访问:
- SQL 接口:在 SQL 语句中,调用第 8.4.4.15 节,“通用密钥环密钥管理函数”中描述的函数。
- C 接口:在 C 语言代码中,调用第 7.6.9.2 节,“密钥环服务”中描述的密钥环服务函数。
示例(使用 SQL 接口):
SELECT keyring_key_generate('MyKey', 'AES', 32); SELECT keyring_key_remove('MyKey');
有关keyring_file
允许的密钥值特性的信息,请参阅第 8.4.4.13 节,“支持的密钥环密钥类型和长度”。
原文:
dev.mysql.com/doc/refman/8.0/en/keyring-encrypted-file-plugin.html
8.4.4.7 使用 keyring_encrypted_file 加密文件型密钥环插件
注意
keyring_encrypted_file
插件是包含在 MySQL 企业版中的一个扩展,这是一个商业产品。要了解更多关于商业产品的信息,请参见 www.mysql.com/products/
。
keyring_encrypted_file
密钥环插件将密钥环数据存储在一个加密的、受密码保护的文件中,该文件位于服务器主机本地。
截至 MySQL 8.0.34 版本,该插件已被弃用,并可能在未来的 MySQL 版本中被移除。相反,考虑使用 component_encrypted_keyring_file
组件来存储密钥环数据(参见 Section 8.4.4.5, “Using the component_keyring_encrypted_file Encrypted File-Based Keyring Component”)。
警告
对于加密密钥管理,keyring_encrypted_file
插件并不是一个旨在符合监管合规性的解决方案。安全标准如 PCI、FIPS 等要求使用密钥管理系统来保护、管理和保护密钥库或硬件安全模块(HSM)中的加密密钥。
要安装 keyring_encrypted_file
,请使用在 Section 8.4.4.3, “Keyring Plugin Installation” 中找到的一般说明,以及在此处找到的特定于 keyring_encrypted_file
的配置信息。
为了在服务器启动过程中可用,keyring_encrypted_file
必须使用 --early-plugin-load
选项加载。要为加密密钥环数据文件指定密码,请设置 keyring_encrypted_file_password
系统变量。(密码是必需的;如果在服务器启动时未指定,keyring_encrypted_file
初始化将失败。)keyring_encrypted_file_data
系统变量可选地配置 keyring_encrypted_file
插件用于数据存储的文件位置。默认值是特定于平台的。要显式配置文件位置,请在启动时设置变量值。例如,在服务器 my.cnf
文件中使用这些行,根据需要调整 .so
后缀和文件位置以适应您的平台,并替换您选择的密码:
[mysqld] early-plugin-load=keyring_encrypted_file.so keyring_encrypted_file_data=/usr/local/mysql/mysql-keyring/keyring-encrypted keyring_encrypted_file_password=*password*
因为 my.cnf
文件在写入时会存储密码,所以应该具有限制模式,并且只能被用来运行 MySQL 服务器的账户访问。
Keyring 操作是事务性的:keyring_encrypted_file
插件在写操作期间使用备份文件,以确保如果操作失败,可以回滚到原始文件。备份文件的名称与keyring_encrypted_file_data
系统变量的值相同,后缀为.backup
。
有关用于配置keyring_encrypted_file
插件的系统变量的附加信息,请参阅 Section 8.4.4.19, “Keyring 系统变量”。
为确保仅在存在正确的 keyring 存储文件时才刷新密钥,keyring_encrypted_file
在文件中存储了密钥环的 SHA-256 校验和。在更新文件之前,插件会验证文件是否包含预期的校验和。此外,keyring_encrypted_file
在写入文件之前使用 AES 加密文件内容,并在读取文件后解密文件内容。
keyring_encrypted_file
插件支持组成标准 MySQL Keyring 服务接口的函数。这些函数执行的 Keyring 操作可在两个级别访问:
- SQL 接口:在 SQL 语句中,调用 Section 8.4.4.15, “通用 Keyring 密钥管理函数”中描述的函数。
- C 接口:在 C 语言代码中,调用 Section 7.6.9.2, “Keyring 服务”中描述的 keyring 服务函数。
示例(使用 SQL 接口):
SELECT keyring_key_generate('MyKey', 'AES', 32); SELECT keyring_key_remove('MyKey');
有关keyring_encrypted_file
允许的关键值特征的信息,请参阅 Section 8.4.4.13, “支持的 Keyring 密钥类型和长度”。
8.4.4.8 使用 keyring_okv KMIP 插件
注意
keyring_okv
插件是包含在 MySQL 企业版中的扩展,这是一款商业产品。要了解更多关于商业产品的信息,请参阅www.mysql.com/products/
。
密钥管理互操作性协议(KMIP)使密钥管理服务器和其客户端之间能够通信。keyring_okv
密钥环插件使用 KMIP 1.1 协议作为 KMIP 后端的客户端进行安全通信。密钥材料仅由后端生成,而不是由keyring_okv
生成。该插件与以下支持 KMIP 的产品配合使用:
- Oracle Key Vault
- Gemalto SafeNet KeySecure Appliance
- Townsend Alliance Key Manager
- Entrust KeyControl
每个 MySQL 服务器实例必须单独注册为 KMIP 的客户端。如果两个或更多 MySQL 服务器实例使用相同的凭据集,它们可能会干扰彼此的功能。
keyring_okv
插件支持组成标准 MySQL 密钥环服务接口的功能。这些功能执行的密钥环操作可在两个级别访问:
- SQL 接口:在 SQL 语句中,调用第 8.4.4.15 节“通用密钥环密钥管理功能”中描述的函数。
- C 接口:在 C 语言代码中,调用第 7.6.9.2 节“密钥环服务”中描述的密钥环服务函数。
示例(使用 SQL 接口):
SELECT keyring_key_generate('MyKey', 'AES', 32); SELECT keyring_key_remove('MyKey');
有关keyring_okv
允许的密钥值特性的信息,请参阅第 8.4.4.13 节“支持的密钥环密钥类型和长度”。
要安装keyring_okv
,请使用第 8.4.4.3 节“密钥环插件安装”中的通用说明,以及此处找到的特定于keyring_okv
的配置信息。
- 通用 keyring_okv 配置
- 为 Oracle Key Vault 配置 keyring_okv
- 为 Gemalto SafeNet KeySecure Appliance 配置 keyring_okv
- 为 Townsend Alliance Key Manager 配置 keyring_okv
- 为 Entrust KeyControl 配置 keyring_okv
- 保护 keyring_okv 密钥文件的密码
一般 keyring_okv 配置
无论keyring_okv
插件使用哪个 KMIP 后端进行密钥存储,keyring_okv_conf_dir
系统变量都配置了keyring_okv
用于其支持文件的目录位置。默认值为空,因此必须在插件能够与 KMIP 后端通信之前设置变量以命名一个正确配置的目录。否则,keyring_okv
在服务器启动期间向错误日志写入一条消息,说明无法通信:
[Warning] Plugin keyring_okv reported: 'For keyring_okv to be initialized, please point the keyring_okv_conf_dir variable to a directory containing Oracle Key Vault configuration file and ssl materials'
keyring_okv_conf_dir
变量必须命名一个包含以下项目的目录:
okvclient.ora
:包含keyring_okv
与之通信的 KMIP 后端详细信息的文件。ssl
:包含用于与 KMIP 后端建立安全连接所需的证书和密钥文件的目录:CA.pem
、cert.pem
和key.pem
。如果密钥文件受密码保护,ssl
目录可以包含一个名为password.txt
的单行文本文件,其中包含解密密钥文件所需的密码。
keyring_okv
正常工作需要okvclient.ora
文件和包含证书和密钥文件的ssl
目录。用于将这些文件填充到配置目录的过程取决于与keyring_okv
一起使用的 KMIP 后端,如其他地方所述。
由keyring_okv
用作其支持文件位置的配置目录应具有严格的模式,并且只能由用于运行 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
要在服务器启动过程中可用,必须使用--early-plugin-load
选项加载keyring_okv
。此外,设置keyring_okv_conf_dir
系统变量,告诉keyring_okv
在哪里找到其配置目录。例如,在服务器my.cnf
文件中使用以下行,根据需要调整平台的.so
后缀和目录位置:
[mysqld] early-plugin-load=keyring_okv.so keyring_okv_conf_dir=/usr/local/mysql/mysql-keyring-okv
有关keyring_okv_conf_dir
的更多信息,请参见第 8.4.4.19 节,“Keyring 系统变量”。
为 Oracle Key Vault 配置 keyring_okv
这里的讨论假定您熟悉 Oracle Key Vault。一些相关信息来源:
在 Oracle Key Vault 术语中,使用 Oracle Key Vault 存储和检索安全对象的客户端称为端点。要与 Oracle Key Vault 通信,必须注册为端点并通过下载和安装端点支持文件进行注册。请注意,必须为每个 MySQL Server 实例注册一个单独的端点。如果两个或更多个 MySQL Server 实例使用相同的端点,则它们可能会干扰彼此的功能。
以下过程简要总结了设置keyring_okv
以与 Oracle Key Vault 一起使用的过程:
- 创建
keyring_okv
插件使用的配置目录。 - 在 Oracle Key Vault 中注册一个端点以获取注册令牌。
- 使用注册令牌获取
okvclient.jar
客户端软件下载。 - 安装客户端软件以填充包含 Oracle Key Vault 支持文件的
keyring_okv
配置目录。
使用以下过程配置keyring_okv
和 Oracle Key Vault 一起工作。此描述仅概述了如何与 Oracle Key Vault 交互。有关详细信息,请访问Oracle Key Vault网站并查阅 Oracle Key Vault 管理员指南。
- 创建包含 Oracle Key Vault 支持文件的配置目录,并确保
keyring_okv_conf_dir
系统变量设置为该目录的名称(有关详细信息,请参阅通用 keyring_okv 配置)。 - 以具有系统管理员角色的用户身份登录到 Oracle Key Vault 管理控制台。
- 选择“端点”选项卡以到达端点页面。在端点页面上,点击“添加”。
- 提供所需的端点信息并点击“注册”。端点类型应为其他。成功注册将产生一个注册令牌。
- 从 Oracle Key Vault 服务器注销。
- 再次连接到 Oracle Key Vault 服务器,这次不需要登录。使用端点注册令牌进行注册并请求
okvclient.jar
软件下载。将此文件保存到您的系统中。 - 使用以下命令安装
okvclient.jar
文件(您必须具有 JDK 1.4 或更高版本):
java -jar okvclient.jar -d *dir_name* [-v]
-d
选项后面的目录名称是安装提取文件的位置。如果给出-v
选项,则会产生日志信息,如果命令失败,这些信息可能会有用。
当命令要求输入 Oracle Key Vault 端点密码时,请不要提供密码。而是按下Enter键。(结果是端点连接到 Oracle Key Vault 时不需要密码。)
前面的命令会生成一个okvclient.ora
文件,应该位于前面 java -jar 命令中-d
选项指定的目录下的这个位置:
install_dir/conf/okvclient.ora
- 预期的文件内容包括类似于这样的行:
SERVER=*host_ip*:*port_num* STANDBY_SERVER=*host_ip*:*port_num*
SERVER
变量是必需的,STANDBY_SERVER
变量是可选的。keyring_okv
插件尝试与由SERVER
变量指定的主机上运行的服务器通信,如果失败则退回到STANDBY_SERVER
。
注意
如果现有文件不是这种格式,则创建一个新文件,其中包含前面示例中显示的行。此外,在运行 okvutil 命令之前,请考虑备份okvclient.ora
文件。根据需要恢复文件。
从 MySQL 8.0.29 开始,您可以指定多个备用服务器(最多 64 个)。如果这样做,keyring_okv
插件会迭代它们,直到建立连接,如果无法建立连接则会失败。要添加额外的备用服务器,请编辑okvclient.ora
文件,将服务器的 IP 地址和端口号作为STANDBY_SERVER
变量的值以逗号分隔的列表指定。例如:
STANDBY_SERVER=*host_ip*:*port_num*,*host_ip*:*port_num*,*host_ip*:*port_num*,*host_ip*:*port_num*
- 确保备用服务器列表保持简短、准确和最新,并删除不再有效的服务器。每次连接尝试都会等待 20 秒,因此长列表中存在无效服务器会显著影响
keyring_okv
插件的连接时间,从而影响服务器启动时间。 - 转到 Oracle Key Vault 安装程序目录,并通过运行此命令测试设置:
okvutil/bin/okvutil list
- 输出应该类似于这样:
Unique ID Type Identifier 255AB8DE-C97F-482C-E053-0100007F28B9 Symmetric Key - 264BF6E0-A20E-7C42-E053-0100007FB29C Symmetric Key -
- 对于一个全新的 Oracle Key Vault 服务器(一个没有任何密钥的服务器),输出看起来像这样,以表明保险库中没有密钥:
no objects found
- 使用此命令从
okvclient.jar
文件中提取包含 SSL 材料的ssl
目录:
jar xf okvclient.jar ssl
- 将 Oracle Key Vault 支持文件(
okvclient.ora
文件和ssl
目录)复制到配置目录中。 - (可选)如果您希望对密钥文件进行密码保护,请使用 Password-Protecting the keyring_okv Key File 中的说明。
完成前述过程后,重新启动 MySQL 服务器。它会加载 keyring_okv
插件,并且 keyring_okv
使用其配置目录中的文件与 Oracle Key Vault 进行通信。
配置 keyring_okv 以适用于 Gemalto SafeNet KeySecure Appliance
Gemalto SafeNet KeySecure Appliance 使用 KMIP 协议(版本 1.1 或 1.2)。支持 KMIP 1.1 的 keyring_okv
密钥环插件可以使用 KeySecure 作为其 KMIP 后端进行密钥环存储。
使用以下步骤配置 keyring_okv
和 KeySecure 一起工作。描述仅总结了如何与 KeySecure 交互。有关详细信息,请参阅 KeySecure 用户指南 中的添加 KMIP 服务器部分。
- 创建包含 KeySecure 支持文件的配置目录,并确保
keyring_okv_conf_dir
系统变量设置为该目录的名称(有关详细信息,请参阅 通用 keyring_okv 配置)。 - 在配置目录中,创建一个名为
ssl
的子目录,用于存储所需的 SSL 证书和密钥文件。 - 在配置目录中,创建一个名为
okvclient.ora
的文件。它应具有以下格式:
SERVER=*host_ip*:*port_num* STANDBY_SERVER=*host_ip*:*port_num*
- 例如,如果 KeySecure 在主机 198.51.100.20 上运行,并在端口 9002 上监听,同时也在备用主机 203.0.113.125 上运行,并在端口 8041 上监听,那么
okvclient.ora
文件如下所示:
SERVER=198.51.100.20:9002 STANDBY_SERVER=203.0.113.125:8041
- 从 MySQL 8.0.29 开始,您可以指定多个备用服务器(最多 64 个)。如果这样做,
keyring_okv
插件会对它们进行迭代,直到建立连接,如果无法建立连接则会失败。要添加额外的备用服务器,请编辑okvclient.ora
文件,将服务器的 IP 地址和端口号作为逗号分隔列表指定在STANDBY_SERVER
变量的值中。例如:
STANDBY_SERVER=*host_ip*:*port_num*,*host_ip*:*port_num*,*host_ip*:*port_num*,*host_ip*:*port_num*
- 确保备用服务器列表保持简短、准确和最新,并删除不再有效的服务器。每次连接尝试都会等待 20 秒,因此长时间的无效服务器列表会显著影响
keyring_okv
插件的连接时间,从而影响服务器启动时间。 - 以具有证书颁发机构访问权限的管理员凭据登录到 KeySecure 管理控制台。
- 导航至安全性 >> 本地 CA 并创建本地证书颁发机构(CA)。
- 转到受信任的 CA 列表。选择默认并点击属性。然后选择受信任证书颁发机构列表的编辑并添加刚创建的 CA。
- 下载 CA 并将其保存在
ssl
目录中,文件名为CA.pem
。 - 导航至安全性 >> 证书请求并创建证书。然后您可以下载一个包含证书 PEM 文件的压缩 tar 文件。
- 从下载的文件中提取 PEM 文件。例如,如果文件名为
csr_w_pk_pkcs8.gz
,请使用以下命令进行解压缩和解包:
tar zxvf csr_w_pk_pkcs8.gz
- 提取操作会生成两个文件:
certificate_request.pem
和private_key_pkcs8.pem
。 - 使用此 openssl 命令解密私钥并创建名为
key.pem
的文件:
openssl pkcs8 -in private_key_pkcs8.pem -out key.pem
- 将
key.pem
文件复制到ssl
目录中。 - 将
certificate_request.pem
中的证书请求复制到剪贴板中。 - 导航至安全性 >> 本地 CA。选择之前创建的相同 CA(用于创建
CA.pem
文件的那个),然后点击签署请求。将剪贴板中的证书请求粘贴进去,选择客户端的证书目的(密钥环是 KeySecure 的客户端),然后点击签署请求。结果是在新页面中使用所选 CA 签署的证书。 - 将签署的证书复制到剪贴板,然后将剪贴板内容保存为名为
cert.pem
的文件,保存在ssl
目录中。 - (可选)如果您希望对密钥文件进行密码保护,请使用密码保护 keyring_okv 密钥文件中的说明。
完成上述过程后,重新启动 MySQL 服务器。它会加载keyring_okv
插件,并且keyring_okv
会使用其配置目录中的文件与 KeySecure 进行通信。
配置用于 Townsend Alliance Key Manager 的keyring_okv
Townsend Alliance Key Manager 使用 KMIP 协议。keyring_okv
密钥环插件可以使用 Alliance Key Manager 作为其 KMIP 后端进行密钥环存储。有关更多信息,请参见用于 MySQL 的 Alliance Key Manager。
配置用于 Entrust KeyControl 的keyring_okv
Entrust KeyControl 使用 KMIP 协议。keyring_okv
密钥环插件可以使用 Entrust KeyControl 作为其 KMIP 后端进行密钥环存储。有关更多信息,请参见Oracle MySQL 和 Entrust KeyControl 与 nShield HSM 集成指南。
MySQL8 中文参考(二十九)(3)https://developer.aliyun.com/article/1566124