在 SQL 级别，作为一组可加载函数，每个函数都映射到对服务例程的调用。

作为 C 语言接口，可作为插件服务从服务器插件或可加载函数调用。

key_id: 密钥 ID 或名称。以 mysql_ 开头的 key_id 值由 MySQL 服务器保留。

user_id: 会话有效用户 ID。如果没有用户上下文，则此值可以为 NULL。该值实际上不必是 “用户”；含义取决于应用程序。

实现密钥环函数接口的函数将 CURRENT_USER() 的值作为 user_id 值传递给密钥环服务函数。

每个函数都返回 0 表示成功，1 表示失败。

key_id 和 user_id 参数形成唯一的组合，指示要使用的密钥环中的哪个密钥。

key_type 参数提供有关密钥的附加信息，例如其加密方法或预期用途。

密钥环服务函数将密钥 ID、用户名、类型和值视为二进制字符串，因此比较区分大小写。例如，MyKey 和 mykey 的 ID 指的是不同的密钥。

my_key_fetch()

对密钥进行混淆并从密钥环中检索密钥，以及其类型。该函数为用于存储返回的密钥和密钥类型的缓冲区分配内存。调用方应在不再需要时将内存清零或混淆，然后释放它。

语法

bool my_key_fetch(const char *key_id, const char **key_type,
                  const char* user_id, void **key, size_t *key_len)

参数

返回值

返回 0 表示成功，1 表示失败。

my_key_generate()

生成一个给定类型和长度的新随机密钥，并将其存储在密钥环中。密钥的长度为 key_len，并与由 key_id 和 user_id 形成的标识符关联。类型和长度值必须与底层密钥环插件支持的值一致。请参见 第 8.4.4.10 节“支持的密钥环密钥类型和长度”。

语法

bool my_key_generate(const char *key_id, const char *key_type,
                     const char *user_id, size_t key_len)

参数

返回值

返回 0 表示成功，1 表示失败。

my_key_remove()

从密钥环中删除密钥。

语法

bool my_key_remove(const char *key_id, const char* user_id)

参数

返回值

返回 0 表示成功，1 表示失败。

my_key_store()

对密钥进行混淆并将其存储在密钥环中。

语法

bool my_key_store(const char *key_id, const char *key_type,
                  const char* user_id, void *key, size_t key_len)

参数

返回值

返回 0 表示成功，1 表示失败。