对于每个特定于密钥环插件的函数,本节介绍其用途、调用顺序和返回值。有关通用密钥环函数的信息,请参见 第 8.4.4.12 节,“通用密钥环密钥管理函数”。
关联的密钥环插件:
keyring_awskeyring_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_awskeyring_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.'。