对于每个特定于密钥环插件的函数,本节介绍其用途、调用顺序和返回值。有关通用密钥环函数的信息,请参见 第 8.4.4.12 节,“通用密钥环密钥管理函数”。
关联的密钥环插件:
keyring_aws
keyring_aws_rotate_cmk()
旋转 AWS KMS 密钥。旋转仅更改 AWS KMS 用于后续数据密钥加密操作的密钥。AWS KMS 保留以前的 CMK 版本,因此使用以前的 CMK 生成的密钥在旋转后仍然可解密。旋转更改 AWS KMS 内部使用的 CMK 值,但不更改用于引用它的 ID,因此在调用
keyring_aws_rotate_cmk()
后无需更改keyring_aws_cmk_id
系统变量。此函数需要
SUPER
权限。参数
无。
返回值
成功返回 1,失败返回
NULL
和错误。关联的密钥环插件:
keyring_aws
keyring_aws_rotate_keys()
旋转存储在由keyring_aws_data_file
系统变量命名的keyring_aws
存储文件中的密钥。旋转将存储在文件中的每个密钥发送到 AWS KMS,以使用keyring_aws_cmk_id
系统变量的值作为 CMK 值重新加密,并将新加密的密钥存储在文件中。keyring_aws_rotate_keys()
在以下情况下对密钥重新加密很有用旋转 CMK 后;也就是说,在调用
keyring_aws_rotate_cmk()
函数之后。将
keyring_aws_cmk_id
系统变量更改为不同的密钥值后。
此函数需要
SUPER
权限。参数
无。
返回值
成功返回 1,失败返回
NULL
和错误。keyring_hashicorp_update_config()
关联的密钥环插件:
keyring_hashicorp
调用时,
keyring_hashicorp_update_config()
函数会导致keyring_hashicorp
执行运行时重新配置,如 keyring_hashicorp 配置 中所述。此函数需要
SYSTEM_VARIABLES_ADMIN
权限,因为它会修改全局系统变量。参数
无。
返回值
成功返回字符串
'Configuration update was successful.'
,失败返回'Configuration update failed.'
。