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