对于错误类型的参数或不正确的参数数量，每个函数都会返回一个错误。

如果参数不适合允许函数执行请求的操作，它会根据需要返回 NULLor 0。例如，如果一个函数不支持指定的算法，密钥长度太短或太长，或者 PEM 格式的预期为密钥字符串的字符串不是有效密钥，就会发生这种情况。

底层 SSL 库负责随机初始化。

asymmetric_decrypt(algorithm, data_str, priv_key_str)

使用给定的算法和密钥字符串解密加密的字符串，并将生成的明文作为二进制字符串返回。如果解密失败，则结果为 NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

默认情况下，该 component_enterprise_encryption函数假定加密文本使用 RSAES-OAEP 填充方案。openssl_udf如果系统变量 enterprise_encryption.rsa_support_legacy_padding 设置为ON（默认为 OFF），该函数支持解密由遗留共享库函数加密的内容。设置后ON，该函数还支持 RSAES-PKCS1-v1_5 填充方案，如旧openssl_udf 共享库函数所使用的那样。设置时OFF，无法解密由遗留函数加密的内容，并且该函数返回此类内容的空输出。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

data_str是要解密的加密字符串，它是用 加密的 asymmetric_encrypt()。

priv_key_str是有效的 PEM 编码 RSA 私钥。asymmetric_encrypt()为了成功解密，密钥字符串必须与用于生成加密字符串的公钥字符串相对应 。组件函数仅支持使用 asymmetric_encrypt()公钥加密，因此解密需要使用相应的私钥。

有关使用示例，请参阅 的说明 asymmetric_encrypt()。

asymmetric_encrypt(algorithm, data_str, pub_key_str)

使用给定的算法和密钥字符串加密字符串，并将生成的密文作为二进制字符串返回。如果加密失败，则结果为NULL.

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

data_str是要加密的字符串。此字符串的长度不能大于密钥字符串长度（以字节为单位）减去 42（用于填充）。

pub_key_str是有效的 PEM 编码 RSA 公钥。组件函数仅支持使用 asymmetric_encrypt()公钥加密。

要恢复原始未加密的字符串，请将加密的字符串asymmetric_decrypt()连同用于加密的密钥对的另一部分传递给 ，如以下示例所示：

-- Generate private/public key pair
SET @priv = create_asymmetric_priv_key('RSA', 2048);
SET @pub = create_asymmetric_pub_key('RSA', @priv);

-- Encrypt using public key, decrypt using private key
SET @ciphertext = asymmetric_encrypt('RSA', 'The quick brown fox', @pub);
SET @plaintext = asymmetric_decrypt('RSA', @ciphertext, @priv);

假设：

SET @s = a string to be encrypted
SET @priv = a valid private RSA key string in PEM format
SET @pub = the corresponding public RSA key string in PEM format

然后这些身份关系成立：

asymmetric_decrypt('RSA', asymmetric_encrypt('RSA', @s, @pub), @priv) = @s

asymmetric_sign(algorithm, text, priv_key_str, digest_type)

使用私钥对摘要字符串或数据字符串进行签名，并将签名作为二进制字符串返回。如果签名失败，则结果为NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

text是数据字符串或摘要字符串。该函数接受摘要但不需要它们，因为它还能够处理任意长度的数据字符串。可以通过调用生成摘要字符串 create_digest()。

priv_key_str是用于签署摘要字符串的私钥字符串。它必须是有效的 PEM 编码 RSA 私钥。

digest_type是用于对数据进行签名的算法。支持的 digest_type值为 'SHA224'、'SHA256'、 'SHA384'，并且'SHA512' 在使用 OpenSSL 1.0.1 时。如果正在使用 OpenSSL 1.1.1，则附加值digest_type、 'SHA3-224'、'SHA3-256'和 'SHA3-384'可用 'SHA3-512'。

有关使用示例，请参阅 的说明 asymmetric_verify()。

asymmetric_verify(algorithm, text, sig_str, pub_key_str, digest_type)

验证签名串是否与摘要串匹配，返回1或0表示验证成功或失败。如果验证失败，则结果为 NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

默认情况下，该 component_enterprise_encryption函数假定签名使用 RSASSA-PSS 签名方案。openssl_udf如果系统变量 enterprise_encryption.rsa_support_legacy_padding 设置为ON（默认为 OFF），该函数支持验证由遗留共享库函数生成的签名。设置后ON，该函数还支持 RSASSA-PKCS1-v1_5 签名方案，如旧openssl_udf 共享库函数所使用的那样。设置时OFF，无法验证遗留函数生成的签名，并且该函数会为此类内容返回空输出。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

text是数据字符串或摘要字符串。组件函数接受摘要但不需要它们，因为它还能够处理任意长度的数据字符串。可以通过调用生成摘要字符串create_digest()。

sig_str是要验证的签名字符串。可以通过调用生成签名字符串 asymmetric_sign()。

pub_key_str是签名者的公钥字符串。asymmetric_sign()它对应传递给生成签名字符串的私钥。它必须是有效的 PEM 编码 RSA 公钥。

digest_type是用于签署数据的算法。支持的 digest_type值为 'SHA224'、'SHA256'、 'SHA384'，并且'SHA512' 在使用 OpenSSL 1.0.1 时。如果正在使用 OpenSSL 1.1.1，则附加值digest_type、 'SHA3-224'、'SHA3-256'和 'SHA3-384'可用 'SHA3-512'。

-- Set the encryption algorithm and digest type
SET @algo = 'RSA';
SET @dig_type = 'SHA512';

-- Create private/public key pair
SET @priv = create_asymmetric_priv_key(@algo, 2048);
SET @pub = create_asymmetric_pub_key(@algo, @priv);

-- Generate digest from string
SET @dig = create_digest(@dig_type, 'The quick brown fox');

-- Generate signature for digest and verify signature against digest
SET @sig = asymmetric_sign(@algo, @dig, @priv, @dig_type);
SET @verf = asymmetric_verify(@algo, @dig, @sig, @pub, @dig_type);

create_asymmetric_priv_key(algorithm, key_length)

使用给定的算法和密钥长度创建私钥，并以 PEM 格式的二进制字符串形式返回密钥。密钥采用 PKCS #8 格式。如果密钥生成失败，则结果为NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

key_length是以位为单位的密钥长度。如果超过最大允许密钥长度或指定小于最小值，则密钥生成失败并且结果为空输出。允许的最小密钥长度（以位为单位）为 2048。允许的最大密钥长度是 enterprise_encryption.maximum_rsa_key_size 系统变量的值，默认为 4096。它的最大设置为 16384，这是 RSA 算法允许的最大密钥长度。请参阅 第 6.6.2 节，“配置 MySQL 企业加密”。

此示例创建一个 2048 位 RSA 私钥，然后从私钥派生出一个公钥：

SET @priv = create_asymmetric_priv_key('RSA', 2048);
SET @pub = create_asymmetric_pub_key('RSA', @priv);

create_asymmetric_pub_key(algorithm, priv_key_str)

使用给定的算法从给定的私钥派生出公钥，并将密钥作为 PEM 格式的二进制字符串返回。密钥采用 PKCS #8 格式。如果密钥派生失败，则结果为NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

algorithm是用于创建密钥的加密算法。支持的算法值为'RSA'.

priv_key_str是有效的 PEM 编码 RSA 私钥。

有关使用示例，请参阅 的说明 create_asymmetric_priv_key()。

create_digest(digest_type, str)

使用给定的摘要类型从给定的字符串创建摘要，并将摘要作为二进制字符串返回。如果摘要生成失败，则结果为NULL。

对于 MySQL 8.0.29 之前使用的此功能的旧版本，请参阅 第 6.6.6 节，“MySQL Enterprise Encryption Legacy Function Descriptions”。

生成的摘要字符串适合与 asymmetric_sign()和 一起使用asymmetric_verify()。这些函数的组件版本接受摘要但不需要它们，因为它们能够处理任意长度的数据。

digest_type是用于生成摘要字符串的摘要算法。支持的 digest_type值为 'SHA224'、'SHA256'、 'SHA384'，并且'SHA512' 在使用 OpenSSL 1.0.1 时。如果正在使用 OpenSSL 1.1.1，则附加值digest_type、 'SHA3-224'、'SHA3-256'和 'SHA3-384'可用 'SHA3-512'。

str是要为其生成摘要的非空数据字符串。

SET @dig = create_digest('SHA512', 'The quick brown fox');