[utility] 健康检查 / 回显接口。客户端传入 client_msg 字符串，服务端原样回显并附加 server_msg，用于验证 MCP 通道连通性。返回字段：client_msg（回显）、server_msg（服务端附加消息）。

Parameter	Type	Required	Notes
client_msg	string	yes	任意字符串，服务端原样回显（原始字符串，非编码格式）

[random] 使用操作系统 CSPRNG 生成安全随机字节。data_length 指定字节数（1-128），返回 data_in_hex 十六进制字符串。返回字段：data_in_hex（随机数据 Hex 编码）、data_length（实际字节数）。

Parameter	Type	Required	Notes
data_length	integer	yes	随机数据字节数（整数，1~128）

[hash_digest] 计算消息摘要（支持多算法批量计算）。【支持算法】Sha1 / Sha224 / Sha256 / Sha384 / Sha512 / Sm3 / Shake128 / Shake256。【参数】 - plain_in_hex：明文 Hex 字符串（原始数据 1B ~ 16MB） - required_hash_modes：字符串数组，指定需要计算的算法列表，默认计算全部算法 - shake_output_length：SHAKE 系列的输出字节长度（32~256，默认 64），仅在 required_hash_modes 包含 Shake128 或 Shake256 时生效【输出】Results 字典，每个算法对应 hash_sum_in_hex（摘要 Hex）和 hash_length（字节数）。【SHAKE 说明】SHAKE128/256 是 XOF

Parameter	Type	Required	Notes
required_hash_modes	array	no	哈希算法名称数组，指定需要计算的算法列表，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512 / Sm3 / Shake128 / Shake256（HMAC 不支持 Shake 系列）
plain_in_hex	string	no	原始数据的十六进制字符串（1B~16MB，即 2~33554432 个 hex 字符）
shake_output_length	integer	no	SHAKE 系列输出字节长度（整数，32~256，默认 64）

[hash_digest] 计算 HMAC（基于哈希的消息认证码）。【支持算法】Sha1 / Sha224 / Sha256 / Sha384 / Sha512 / Sm3（不支持 SHAKE 系列，因 SHAKE 为 XOF 非固定长度哈希）。【参数】 - key_in_hex：密钥 Hex。SHA 系按 RFC 2104 支持 16~256 字节（超块大小会先哈希）；若算法列表含 Sm3，上限为 64 字节（SM3 块大小，即 32~128 个 hex 字符）。 - plain_in_hex：待认证数据 Hex（1B ~ 16MB） - required_hash_modes：字符串数组，指定 HMAC 底层哈希算法列表，默认计算全部 6 种算法【输出】Results 字典，每个算法对应 hmac_sum_in_hex（HMAC Hex 编码）和 hmac_length（字节数）

Parameter	Type	Required	Notes
required_hash_modes	array	no	哈希算法名称数组，指定需要计算的算法列表，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512 / Sm3 / Shake128 / Shake256（HMAC 不支持 Shake 系列）
plain_in_hex	string	no	原始数据的十六进制字符串（1B~16MB，即 2~33554432 个 hex 字符）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)

[kdf] 执行密钥派生（KDF），从高熵秘密或口令派生对称密钥材料。【支持算法】 - HKDF（默认）：RFC 5869 extract-then-expand，底层哈希 Sha256（默认）/ Sha384 / Sha512 - Sm3Kdf：GB/T 32918 密钥派生，SM3(Z ∥ be32(ct))，ct 从 1 起，适合对 SM2 ECDH 共享秘密派生密钥 - Pbkdf2Sm3：RFC 8018 PBKDF2，PRF 为 HMAC-SM3，用于口令拉伸【参数】（按算法适用，错配会被拒） - algorithm：HKDF / Sm3Kdf / Pbkdf2Sm3，默认 HKDF - hash_algorithm：仅 HKDF，默认 Sha256 - input_in_hex：HKDF 的 IKM / Sm3Kdf 的共享秘密 Z，Hex（1B~16MB），与 pass

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
hash_algorithm	string	no	哈希算法名称，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512（ECC 不支持 Sm3）
input_in_hex	string	no	输入秘密的十六进制字符串（KDF：HKDF 的 IKM / Sm3Kdf 的共享秘密 Z，1B~16MB）
password	string	no	密码（原始字符串，非编码格式；私钥工具为私钥加密密码，KDF Pbkdf2Sm3 为待拉伸口令）
salt_in_hex	string	no	盐的十六进制字符串（KDF，可选 ≤256B；Pbkdf2Sm3 留空则服务端生成 16B 随机盐并回显）
info_in_hex	string	no	HKDF 上下文信息的十六进制字符串（可选，≤256B）
iterations	integer	no	PBKDF2 迭代次数（整数；KDF Pbkdf2Sm3 范围 10000~4000000，默认 10000）
derived_key_length	integer	no	HKDF/KDF 派生密钥长度（整数，16~1024 字节；KDF Pbkdf2Sm3 上限 256）

[symmetric_cipher] 分组密码 CBC 模式加解密。【算法】AES128（key=16B） / AES256（key=32B） / SM4（key=16B）。【参数】 - algorithm：算法名 - process_type：Encrypt 或 Decrypt - input_data_in_hex：明文或密文 Hex（1B~16MB） - key_in_hex：密钥 Hex - iv_in_hex：初始向量 Hex（固定 16 字节 = 32 hex 字符）【自动行为】加密自动 PKCS7 填充，解密自动去填充。【输出】output_data_in_hex、output_length、output_sha256、algorithm。【注意】解密时密文长度必须为 16 字节整数倍。

Parameter	Type	Required	Notes
input_data_in_hex	string	no	输入数据的十六进制字符串（加密时为明文，解密时为密文，1B~16MB）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)
iv_in_hex	string	no	初始向量的十六进制字符串，固定 32 个 hex 字符（16 字节）
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
process_type	string	no	操作类型，可选值：Encrypt / Decrypt

[symmetric_cipher] AEAD 流式加解密（认证加密）。【算法】AES256GCM（key=32B） / ChaCha20Poly1305（key=32B） / SM4GCM（key=16B）。【参数】 - algorithm：算法名 - process_type：Encrypt 或 Decrypt - input_data_in_hex：明文或密文 Hex（1B~16MB） - key_in_hex：密钥 Hex - nonce_in_hex：随机数 Hex（固定 12 字节 = 24 hex 字符） - associated_data_in_hex：可选附加认证数据（参与 MAC 但不加密）【输出】output_data_in_hex、output_length、output_sha256、algorithm。【注意】加密输出包含 16 字节 auth tag；

Parameter	Type	Required	Notes
input_data_in_hex	string	no	输入数据的十六进制字符串（加密时为明文，解密时为密文，1B~16MB）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)
nonce_in_hex	string	no	随机数的十六进制字符串，固定 24 个 hex 字符（12 字节）
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
process_type	string	no	操作类型，可选值：Encrypt / Decrypt
associated_data_in_hex	string	no	附加认证数据的十六进制字符串（参与 MAC 计算但不加密，可选）

[symmetric_cipher] PKCS7 填充/去填充工具。【参数】 - padding_action：DoPadding（填充到 16 字节对齐）或 UnPadding（去填充） - data_in_hex：待处理数据 Hex 【输出】output_data_in_hex、output_length。【说明】块大小固定 16 字节（AES/SM4 块大小）。通常无需单独调用此工具，block_cipher 内部已自动处理填充。

Parameter	Type	Required	Notes
data_in_hex	string	yes	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
padding_action	string	no	填充操作，可选值：DoPadding（填充到 16 字节对齐）/ UnPadding（去填充）

[rsa] 生成 RSA 密钥对。【参数】 - key_size：2048 / 3072 / 4096（位） - private_key_password：可选，设置后私钥 PEM 用 AES-256-CBC 加密保护【输出】public_key_in_pem、private_key_in_pem、key_size。【后续操作】公钥用于 rsa_encryption / rsa_verify，私钥用于 rsa_decryption / rsa_sign。

Parameter	Type	Required	Notes
key_size	integer	no	RSA 密钥位数，可选值：2048 / 3072 / 4096
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选

[rsa] RSA 公钥加密。【参数】 - rsa_public_key_in_pem：PEM 格式公钥 - plain_data_in_hex：明文 Hex - rsa_padding_mode：RSAES_PKCS1_V1_5 / RSAES_OAEP_SHA_1 / RSAES_OAEP_SHA_224 / RSAES_OAEP_SHA_256 / RSAES_OAEP_SHA_384 / RSAES_OAEP_SHA_512 【明文长度限制】受 key_size 和 padding 约束：PKCS1v1.5 上限 = 模长字节 − 11；OAEP 上限 = 模长字节 − 2×哈希输出 − 2（RSA-4096 + OAEP-SHA256 = 446 字节，OAEP-SHA512 = 382 字节）。【输出】cipher_data_in_hex、cipher_length。【安

Parameter	Type	Required	Notes
rsa_public_key_in_pem	string	no	RSA 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
rsa_padding_mode	string	no	RSA 加密填充模式，可选值：RSAES_PKCS1_V1_5 / RSAES_OAEP_SHA_1 / RSAES_OAEP_SHA_224 / RSAES_OAEP_SHA_256 / RSAES_OAEP_SHA_384 / RSAES_OAEP_SHA_512
plain_data_in_hex	string	no	明文的十六进制字符串

[rsa] RSA 私钥解密。【参数】 - rsa_private_key_in_pem：PEM 格式私钥 - cipher_data_in_hex：密文 Hex（长度 = key_size/8 字节） - rsa_padding_mode：必须与加密时一致 - password：若私钥有密码保护则传入【输出】plain_data_in_hex、plain_length。

Parameter	Type	Required	Notes
rsa_private_key_in_pem	string	no	RSA 私钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
rsa_padding_mode	string	no	RSA 加密填充模式，可选值：RSAES_PKCS1_V1_5 / RSAES_OAEP_SHA_1 / RSAES_OAEP_SHA_224 / RSAES_OAEP_SHA_256 / RSAES_OAEP_SHA_384 / RSAES_OAEP_SHA_512
cipher_data_in_hex	string	no	密文的十六进制字符串
password	string	no	密码（原始字符串，非编码格式；私钥工具为私钥加密密码，KDF Pbkdf2Sm3 为待拉伸口令）

[rsa] RSA 私钥签名。【参数】 - rsa_private_key_in_pem：PEM 格式私钥 - data_in_hex：待签数据 Hex - rsa_sign_padding_mode：RSA_SIGN_PKCS1_V1_5_SHA{1,224,256,384,512} 或 RSA_SIGN_PSS_SHA{1,224,256,384,512} - rsa_sign_raw_data_mode：True=对原文签名（内部先哈希），False=data_in_hex 已是摘要值 - password：若私钥有密码保护则传入【输出】signature_in_hex、signature_length。【安全建议】推荐 PSS 而非 PKCS1v1.5。

Parameter	Type	Required	Notes
rsa_private_key_in_pem	string	no	RSA 私钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
rsa_sign_padding_mode	string	no	RSA 签名填充模式，可选值：RSA_SIGN_PKCS1_V1_5_SHA1 / SHA224 / SHA256 / SHA384 / SHA512 或 RSA_SIGN_PSS_SHA1 / SHA224 / SHA256 / SHA384 / SHA512
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
password	string	no	密码（原始字符串，非编码格式；私钥工具为私钥加密密码，KDF Pbkdf2Sm3 为待拉伸口令）
rsa_sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex

[rsa] RSA 公钥验签。【参数】 - rsa_public_key_in_pem：PEM 格式公钥 - data_in_hex：原始数据 Hex - signature_in_hex：签名 Hex - rsa_sign_padding_mode：必须与签名时一致 - rsa_sign_raw_data_mode：必须与签名时一致【输出】verified（bool，True=验签通过）。

Parameter	Type	Required	Notes
rsa_public_key_in_pem	string	no	RSA 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
rsa_sign_padding_mode	string	no	RSA 签名填充模式，可选值：RSA_SIGN_PKCS1_V1_5_SHA1 / SHA224 / SHA256 / SHA384 / SHA512 或 RSA_SIGN_PSS_SHA1 / SHA224 / SHA256 / SHA384 / SHA512
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
signature_in_hex	string	no	签名的十六进制字符串
rsa_sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex

[ecc] 生成 ECC 密钥对。【曲线】ECC_SECP_256R1 / ECC_SECP_384R1 / ECC_SECP_521R1 / ECC_SECP256K1 / ECC_ED25519（仅签名）/ ECC_X25519（仅 ECDH）。【参数】 - curve：曲线名 - private_key_password：可选，私钥 PEM 加密保护【输出】public_key_in_pem、private_key_in_pem、curve。【能力矩阵】 - SECP* / SECP256K1 → 签名 + 验签 + ECDH - ED25519 → 仅签名/验签（EdDSA） - X25519 → 仅 ECDH 密钥协商

Parameter	Type	Required	Notes
curve	string	no	ECC 曲线名，可选值：ECC_SECP_256R1 / ECC_SECP_384R1 / ECC_SECP_521R1 / ECC_SECP256K1 / ECC_ED25519 / ECC_X25519
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选

[ecc] ECDH + HKDF 密钥协商，双方各用私钥+对方公钥派生相同对称密钥。【参数】 - alice_ecc_private_key_in_pem：己方私钥 PEM - bob_ecc_public_key_in_pem：对方公钥 PEM - hash_algorithm：HKDF 底层哈希（Sha256/Sha384/Sha512 等，不支持 Sm3） - salt：HKDF salt Hex（可选） - additional_info：HKDF info Hex（可选） - derived_key_length：派生密钥长度 16~1024 字节 - alice_ecc_private_key_password：若私钥加密则传入【输出】derived_key_in_hex、derived_key_length。【曲线限制】Ed25519 不可用，X25519 可用。

Parameter	Type	Required	Notes
alice_ecc_private_key_in_pem	string	no	Alice 侧 ECC 私钥的 PEM 文本
alice_ecc_private_key_password	string	no	Alice 侧 ECC 私钥的加密密码（原始字符串，非编码格式）
bob_ecc_public_key_in_pem	string	no	Bob 侧 ECC 公钥的 PEM 文本
hash_algorithm	string	no	哈希算法名称，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512（ECC 不支持 Sm3）
salt	string	no	HKDF salt 的十六进制字符串（可选）
additional_info	string	no	HKDF info 的十六进制字符串（可选）
derived_key_length	integer	no	HKDF/KDF 派生密钥长度（整数，16~1024 字节；KDF Pbkdf2Sm3 上限 256）

[ecc] ECC 私钥签名（SECP* 用 ECDSA，ED25519 用 EdDSA）。【参数】 - ecc_private_key_in_pem：PEM 私钥 - data_in_hex：待签数据 Hex - sign_raw_data_mode：True=对原文签名（内部先哈希），False=data_in_hex 已是摘要 - hash_algorithm：Sha256/Sha384/Sha512 等（EdDSA 忽略此参数） - ecc_private_key_password：若私钥加密则传入【输出】signature_in_hex、signature_length、curve_name。【曲线限制】X25519 不可用于签名。

Parameter	Type	Required	Notes
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex
hash_algorithm	string	no	哈希算法名称，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512（ECC 不支持 Sm3）
ecc_private_key_in_pem	string	no	ECC 私钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
ecc_private_key_password	string	no	ECC 私钥的加密密码（原始字符串，非编码格式）

[ecc] ECC 公钥验签（SECP* 用 ECDSA，ED25519 用 EdDSA）。【参数】 - ecc_public_key_in_pem：PEM 公钥 - data_in_hex：原始数据 Hex - signature_in_hex：签名 Hex - sign_raw_data_mode：必须与签名时一致 - hash_algorithm：必须与签名时一致【输出】verified（bool，True=验签通过）、curve_name。【曲线限制】X25519 不可用于验签。

Parameter	Type	Required	Notes
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
signature_in_hex	string	no	签名的十六进制字符串
sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex
hash_algorithm	string	no	哈希算法名称，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512（ECC 不支持 Sm3）
ecc_public_key_in_pem	string	no	ECC 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）

[sm2] 生成 SM2（SM2P256V1 / 国密曲线）密钥对。【参数】 - private_key_password：必填，私钥 PEM 加密口令（1-64 字节；私钥只有加密 PEM 一种导出形态）【输出】public_key_in_pem、private_key_in_pem、z_in_hex、point_x_in_hex、point_y_in_hex、public_key_in_hex、private_key_in_hex。【后续操作】公钥用于 sm2_encryption / sm2_verify，私钥用于 sm2_decryption / sm2_sign。

Parameter	Type	Required	Notes
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选

[sm2] SM2 公钥加密。【参数】 - sm2_public_key_in_pem：PEM 格式公钥 - plain_data_in_hex：明文 Hex 【输出】cipher_in_hex_with_format 字典，同时返回四种编码格式： - C1C3C2_ASN1：ASN.1 DER 编码（推荐，国标 GM/T 0009） - C1C2C3_ASN1：ASN.1 DER 旧格式 - C1C3C2：原始拼接格式 - C1C2C3：原始拼接旧格式【注意】每次加密因随机 k 不同，密文不同，这是正常行为。

Parameter	Type	Required	Notes
sm2_public_key_in_pem	string	no	SM2 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
plain_data_in_hex	string	no	明文的十六进制字符串

[sm2] SM2 私钥解密。【参数】 - sm2_private_key_in_pem：PEM 格式私钥 - cipher_data_in_hex：密文 Hex - cipher_format：必须指定 C1C3C2_ASN1 / C1C2C3_ASN1 / C1C3C2 / C1C2C3 - sm2_private_key_password：若私钥加密则传入【输出】plain_data_in_hex、plain_length。【注意】cipher_format 必须与加密时的格式对应，否则解密失败。

Parameter	Type	Required	Notes
sm2_private_key_in_pem	string	no	SM2 加密私钥的 PEM 文本（含 BEGIN/END ENCRYPTED PRIVATE KEY 头尾）
sm2_private_key_password	string	no	SM2 私钥的加密密码（原始字符串，非编码格式）
cipher_data_in_hex	string	no	密文的十六进制字符串
cipher_format	string	no	SM2 密文编码格式，可选值：C1C3C2_ASN1 / C1C2C3_ASN1 / C1C3C2 / C1C2C3

[sm2] SM2 私钥签名。【参数】 - sm2_private_key_in_pem：PEM 格式私钥 - data_in_hex：待签数据 Hex。 · RAW 模式（sign_raw_data_mode=True）：消息原文 Hex，服务端走标准 SM2 流程，内部计算 e = SM3(ZA || M) 后签名。 · DIGEST 模式（sign_raw_data_mode=False）：必须传 32 字节 SM3 摘要 e 的 Hex（64 个 hex 字符），服务端不再做任何隐式 SM3，直接对 e 做裸 SM2 签名，与 KMS / ECC / RSA 的 DIGEST 模式语义一致。 - sign_raw_data_mode：True=RAW（原文），False=DIGEST（32 字节摘要） - sm2_private_key_password：若私钥加密则传入

Parameter	Type	Required	Notes
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex
sm2_private_key_in_pem	string	no	SM2 加密私钥的 PEM 文本（含 BEGIN/END ENCRYPTED PRIVATE KEY 头尾）
sm2_private_key_password	string	no	SM2 私钥的加密密码（原始字符串，非编码格式）

[sm2] SM2 公钥验签。【参数】 - sm2_public_key_in_pem：PEM 格式公钥 - data_in_hex：待验签数据 Hex。 · RAW 模式（sign_raw_data_mode=True）：消息原文 Hex，服务端走标准 SM2 流程，内部计算 e = SM3(ZA || M) 后验签。 · DIGEST 模式（sign_raw_data_mode=False）：必须传 32 字节 SM3 摘要 e 的 Hex（64 个 hex 字符），服务端不再做任何隐式 SM3，直接对 e 做裸 SM2 验签，与 KMS / ECC / RSA 的 DIGEST 模式语义一致。 - signature_in_hex：签名 Hex（必须为 RS_ASN1 格式） - signature_format：固定为 RS_ASN1 - sign_raw_data_mo

Parameter	Type	Required	Notes
signature_in_hex	string	no	签名的十六进制字符串
signature_format	string	no	SM2 签名编码格式，固定值：RS_ASN1（ASN.1 DER 编码）
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
sign_raw_data_mode	boolean	no	True=对原文签名（服务端内部先哈希），False=data_in_hex 已是哈希摘要的 Hex
sm2_public_key_in_pem	string	no	SM2 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）

[sm2] 解析 SM2 加密私钥（ENCRYPTED PRIVATE KEY PEM）结构，返回 ASN.1 内部字段的 JSON 视图。用于调试与教学，不会解出私钥值。返回字段：structure（ASN.1 结构 JSON，含加密算法 OID、盐、迭代次数等）。

Parameter	Type	Required	Notes
private_key_in_pem	string	no	SM2 加密私钥的 PEM 文本（含 BEGIN/END ENCRYPTED PRIVATE KEY 头尾）

[sm2] 将 SM2 PEM 公钥转换为裸 Hex 编码（未压缩点，04 || X || Y）。返回字段：public_key_in_hex（130 个 hex 字符，65 字节）。

Parameter	Type	Required	Notes
public_key_in_pem	string	no	SM2 公钥的 PEM 文本（含 BEGIN/END PUBLIC KEY 头尾）

[symmetric_cipher] ZUC-128 流密码（中国商密算法）。由于 ZUC 是对称流密码，加解密为同一操作，传入明文即输出密文，反之亦然。key_in_hex 固定 16 字节（32 hex 字符），iv_in_hex 固定 16 字节（32 hex 字符），input_data_in_hex 原始数据长度 1B ~ 16MB。返回字段：output_data_in_hex（输出 Hex）、output_length（字节数）。

Parameter	Type	Required	Notes
input_data_in_hex	string	no	输入数据的十六进制字符串（加密时为明文，解密时为密文，1B~16MB）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)
iv_in_hex	string	no	初始向量的十六进制字符串，固定 32 个 hex 字符（16 字节）

[symmetric_cipher] [symmetric_cipher] CTR 计数器模式加解密（AES-256-CTR / SM4-CTR）。CTR 是把块密码转成密钥流的模式：加解密为同一操作（密钥流 XOR），无填充，密文长度与明文等长，任意长度输入（1B ~ 16MB）。algorithm 可选 AES256CTR（key 32B，cryptography 实现）或 SM4CTR（key 16B，GmSSL C 库实现，与 eet 的 sm4-ctr 同源）。iv_in_hex 为 16 字节初始计数器块（32 hex 字符），同 key/iv 下加解密互为逆操作。注意：CTR 不提供认证（无 MAC/tag）——需要防篡改时优先用 stream_cipher 的 AEAD 模式（AES-GCM/ChaCha20-Poly1305/SM4-GCM），CTR 仅适合已有独立认证层

Parameter	Type	Required	Notes
input_data_in_hex	string	no	输入数据的十六进制字符串（加密时为明文，解密时为密文，1B~16MB）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)
iv_in_hex	string	no	初始向量的十六进制字符串，固定 32 个 hex 字符（16 字节）
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）

[other] [symmetric_cipher] AES-XTS 可调窄分组模式加解密（IEEE 1619 / NIST SP 800-38E）。algorithm 可选 AES128XTS（key 32B = 数据密钥 16B + 调组密钥 16B）或 AES256XTS（key 64B = 32B + 32B）。tweak_in_hex 为 16 字节调整值，编码数据单元编号/扇区地址，密文与数据单元位置绑定。process_type 可选 Encrypt / Decrypt（两个变换不同，须显式声明）。输入 16B ~ 16MB，无填充，密文与明文等长；非 16 倍数的尾部自动走密文窃取（ciphertext stealing）。模式特点：各数据单元独立加密，支持并行与随机访问，同一数据单元加解密自同步；同一密钥下 tweak 严禁重复使用（否则两个数据单元明文相同会直接暴露相等

Parameter	Type	Required	Notes
input_data_in_hex	string	no	输入数据的十六进制字符串（加密时为明文，解密时为密文，1B~16MB）
key_in_hex	string	no	密钥的十六进制字符串。长度取决于算法：AES256=64 字符(32B)，AES128/SM4=32 字符(16B)
tweak_in_hex	string	no	—
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
process_type	string	no	操作类型，可选值：Encrypt / Decrypt

[cert] [x509_certificate] 解析 X.509 证书（国际 / 国密 GM SM2 双路径）。输入 PEM 证书（≤10KB），返回：证书类型（X.509 (international) / X.509 (GM SM2)，按签名算法 OID 是否落在国密分支 1.2.156.10197 自动判定）、版本、序列号 hex、签名算法及 OID、颁发者/主体 DN（dict 与 RFC4514 串）、有效期（UTC ISO-8601）与当前状态（valid/expired/not_yet_valid，仅信息展示）、是否自签、公钥类型与位数、SAN、扩展清单、SHA-256 与 SM3 双指纹。GM 证书额外返回主体 SM2 公钥：sm2_public_key_hex（裸坐标 X||Y，128 hex 字符）与 sm2_public_key_hex_uncompressed（

Parameter	Type	Required	Notes
certificate_in_pem	string	no	终端实体证书的 PEM 文本（含 BEGIN/END CERTIFICATE 头尾，≤10KB）

[cert] [x509_certificate] 用 CA 证书验证终端实体证书（单级直接签发验证）。语义：颁发者 DN 与 CA 主体 DN 匹配 + 签名可由 CA 公钥验证；不做链构建、不做吊销检查。有效期不参与 verified 判定，仅以 time_status 字段（valid/expired/not_yet_valid）信息性回显。GM 证书（签名 OID 落在 1.2.156.10197 国密分支）走 GmSSL C 的 x509_cert_verify_by_ca_cert（SM2withSM3，与 gmssl certverify CLI 同一函数），sm2_id 为签名者 ID（默认 '1234567812345678'，与 GmSSL SM2_DEFAULT_ID 同源，GM/T 0009 默认值，1~64 字节）；国际证书走 cryptography 的 ver

Parameter	Type	Required	Notes
certificate_in_pem	string	no	终端实体证书的 PEM 文本（含 BEGIN/END CERTIFICATE 头尾，≤10KB）
ca_certificate_in_pem	string	no	CA 证书的 PEM 文本（含 BEGIN/END CERTIFICATE 头尾，≤10KB）
sm2_id	string	no	SM2 签名者 ID（仅 GM 证书验证使用；默认 '1234567812345678'，GM/T 0009 与 GmSSL 同源默认值，1~64 字节）

[sm9_ibc] [sm9_ibc] 生成 SM9 标识密码主密钥（GM/T 0044，GmSSL C 实现）。key_kind='Sign' 生成签名主密钥（验签方持主公钥），'Enc' 生成加密主密钥（加密方持主公钥），默认 Enc。输出：master_public_key_in_pem（明文主公钥，分发给所有用户）与 master_private_key_in_pem（ENCRYPTED 口令加密主私钥，KGC 自留）。private_key_password 必填，1-32 UTF-8 字节。SM9 私钥 PEM 只有加密形态（无明文导出）。

Parameter	Type	Required	Notes
key_kind	string	no	SM9 主密钥类型，可选值：Sign（签名主密钥）/ Enc（加密主密钥）
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选

[sm9_ibc] [sm9_ibc] KGC 按标识提取 SM9 用户私钥（GM/T 0044）。输入：key_kind（Sign/Enc）、master_private_key_in_pem（GenerateSm9 输出的加密主私钥）、private_key_password（主私钥口令，提取的用户钥也以同一口令加密）、identity（被派发方标识，如邮箱/账号，1-63 UTF-8 字节）。内置 N-1 探针：GmSSL 加密 PEM 导入无口令校验，错口令可能静默解出垃圾主密钥，因此派生后当场完成一次签名验回/加解密往返（probe_verified=true）才输出。输出：user_private_key_in_pem。错口令返回 'SM9 extract user key failed'。

Parameter	Type	Required	Notes
key_kind	string	no	SM9 主密钥类型，可选值：Sign（签名主密钥）/ Enc（加密主密钥）
master_private_key_in_pem	string	no	SM9 加密主私钥的 PEM 文本（含 BEGIN ENCRYPTED SM9 ... MASTER KEY 头尾，KGC 自留）
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选
identity	string	no	SM9 用户标识（原始字符串，如邮箱/账号，1-63 UTF-8 字节；签名/加密/解密均与该标识绑定）

[sm9_ibc] [sm9_ibc] SM9 标识加密（GM/T 0044）。任何人持主公钥即可加密：输入 master_public_key_in_pem（key_kind=Enc 的主公钥）、identity（接收方标识，密文与标识绑定）、plain_data_in_hex（明文 hex，1-255 字节，SM9 单次加密上限受 KDF 块计数器约束）。输出：cipher_in_hex / cipher_in_base64（DER 编码密文，C1/C3/C2 结构，≤367 字节）。

Parameter	Type	Required	Notes
master_public_key_in_pem	string	no	SM9 主公钥的 PEM 文本（明文形态，验签/加密侧使用；Sign/Enc 两类主密钥的公钥标签不同）
identity	string	no	SM9 用户标识（原始字符串，如邮箱/账号，1-63 UTF-8 字节；签名/加密/解密均与该标识绑定）
plain_data_in_hex	string	no	明文的十六进制字符串

[sm9_ibc] [sm9_ibc] SM9 标识解密（GM/T 0044）。接收方用 KGC 派发的用户钥解密：输入 user_private_key_in_pem（SM9ExtractKey key_kind=Enc 输出）、private_key_password（用户钥口令，与提取时一致）、identity（接收方标识，必须与加密时一致）、cipher_data_in_hex（DER 密文，≤367 字节）。输出：plain_data_in_hex、plain_length。口令错或标识不符返回 'SM9 decrypt failed'。

Parameter	Type	Required	Notes
user_private_key_in_pem	string	no	SM9 加密用户私钥的 PEM 文本（含 BEGIN ENCRYPTED SM9 ... PRIVATE KEY 头尾，由 SM9ExtractKey 派发）
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选
identity	string	no	SM9 用户标识（原始字符串，如邮箱/账号，1-63 UTF-8 字节；签名/加密/解密均与该标识绑定）
cipher_data_in_hex	string	no	密文的十六进制字符串

[sm9_ibc] [sm9_ibc] SM9 标识签名（GM/T 0044）。签名者用 KGC 派发的用户钥签名：输入 user_private_key_in_pem（SM9ExtractKey key_kind=Sign 输出）、private_key_password（用户钥口令）、data_in_hex（消息原文 hex，签名前内部先算 SM3 摘要，流式处理，仅支持原文模式）。输出：signature_in_hex / signature_in_base64（DER 编码签名，固定 104 字节）。

Parameter	Type	Required	Notes
user_private_key_in_pem	string	no	SM9 加密用户私钥的 PEM 文本（含 BEGIN ENCRYPTED SM9 ... PRIVATE KEY 头尾，由 SM9ExtractKey 派发）
private_key_password	string	no	私钥的加密密码（原始字符串，非编码格式），可选
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex

[sm9_ibc] [sm9_ibc] SM9 标识验签（GM/T 0044）。验签方只需主公钥与签名者标识：输入 master_public_key_in_pem（key_kind=Sign 的主公钥）、identity（签名者标识）、data_in_hex（消息原文 hex）、signature_in_hex（DER 签名，恰 104 字节 = 208 hex 字符）。verified=false 是成功响应（签名或标识不匹配），仅输入格式非法才返回错误码 'SM9 verify failed'。

Parameter	Type	Required	Notes
master_public_key_in_pem	string	no	SM9 主公钥的 PEM 文本（明文形态，验签/加密侧使用；Sign/Enc 两类主密钥的公钥标签不同）
identity	string	no	SM9 用户标识（原始字符串，如邮箱/账号，1-63 UTF-8 字节；签名/加密/解密均与该标识绑定）
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
signature_in_hex	string	no	签名的十六进制字符串

[pqc_kem] 生成 ML-KEM 密钥对（FIPS 203，后量子密钥封装标准）。【算法选择】ML-KEM-512（NIST Level 1）/ ML-KEM-768（Level 3，推荐）/ ML-KEM-1024（Level 5）。【参数】 - algorithm：算法名 - seed_in_hex：64 字节种子 hex（128 字符），确定性生成 - use_random_seed：True 时忽略 seed_in_hex，使用 CSPRNG 【输出】public_key_in_hex、public_key_in_base64、secret_key_in_hex、secret_key_in_base64、seed_in_hex、algorithm、nist_level、public_key_bytes、secret_key_bytes。【后续操作】公钥用于 ml_kem

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
seed_in_hex	string	no	ML-KEM 密钥生成种子的十六进制字符串，固定 128 个 hex 字符（64 字节）
use_random_seed	boolean	no	True 时忽略 seed_in_hex，使用 CSPRNG 随机生成种子

[pqc_kem] 使用 ML-KEM 公钥执行密钥封装（FIPS 203）。【算法】ML-KEM-512 / ML-KEM-768 / ML-KEM-1024。【参数】 - algorithm：必须与 keygen 时一致 - public_key_in_hex：ml_kem_keygen 返回的公钥 hex 【输出】ciphertext_in_hex、ciphertext_in_base64、shared_secret_in_hex、shared_secret_in_base64、shared_secret_sha256、ciphertext_bytes、shared_secret_bytes、algorithm。【说明】每次 encap 产生不同密文（随机化），共享密钥始终 32 字节。发送 ciphertext 给密钥持有方，对方用 ml_kem_decap 恢复相同的 sh

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
public_key_in_hex	string	no	公钥的十六进制字符串（裸密钥或 DER 编码，取决于算法）

[pqc_kem] 使用 ML-KEM 私钥执行密钥解封装（FIPS 203）。【算法】ML-KEM-512 / ML-KEM-768 / ML-KEM-1024。【参数】 - algorithm：必须与 keygen/encap 一致 - secret_key_in_hex：ml_kem_keygen 返回的私钥 hex - ciphertext_in_hex：ml_kem_encap 返回的密文 hex 【输出】shared_secret_in_hex、shared_secret_in_base64、shared_secret_sha256、shared_secret_bytes、algorithm。【安全特性】若密文被篡改，ML-KEM Implicit Rejection 不抛异常，返回确定性伪随机值（IND-CCA2 安全），不泄露私钥信息。【完整流程】keygen →

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
secret_key_in_hex	string	no	ML-KEM 私钥的十六进制字符串
ciphertext_in_hex	string	no	ML-KEM 密文的十六进制字符串

[pqc_signature] 生成 ML-DSA 密钥对（FIPS 204，后量子数字签名标准）。【算法选择】algorithm 支持 ML-DSA-44（NIST Level 2）/ ML-DSA-65（Level 3，默认）/ ML-DSA-87（Level 5）。【安全等级参考】ML-DSA-44 ≈ AES-128 / ML-DSA-65 ≈ AES-192 / ML-DSA-87 ≈ AES-256。【输出】public_key_in_hex（SPKI DER hex）、public_key_in_base64、private_key_in_hex（PKCS#8 DER hex）、private_key_in_base64、algorithm、nist_level、public_key_bytes、private_key_bytes。【典型用途】生成密钥对后，私钥用于

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）

[pqc_signature] 使用 ML-DSA 私钥对消息签名（FIPS 204）。【双模式】sign_mode 支持 RAW（默认）和 EXTERNAL_MU 两种模式。 - RAW 模式：直接签名原始消息（liboqs，最大 256 字节） - EXTERNAL_MU 模式：先计算 mu = SHAKE-256(tr||M', 64)，再通过 OpenSSL 3.5+ mu 模式签名（最大 2048 字节），与 AWS KMS ML-DSA EXTERNAL_MU 语义等价【消息长度策略】 - RAW：最大 256 字节，空消息合法 - EXTERNAL_MU：最大 2048 字节，空消息合法 - > 256 且 <= 2048 字节：使用 EXTERNAL_MU - > 2048 字节：拒绝【算法】algorithm 支持 ML-DSA-44 / ML-DSA-65（默认）

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
private_key_in_hex	string	no	ML-DSA 私钥的十六进制字符串（PKCS#8 DER 编码）
public_key_spki_in_hex	string	no	ML-DSA 公钥的十六进制字符串（SPKI DER 或裸公钥均可）
message_in_hex	string	no	消息的十六进制字符串（空字符串表示空消息）
context_in_hex	string	no	ML-DSA 上下文的十六进制字符串（可选，最大 255 字节）
sign_mode	string	no	ML-DSA 签名模式，可选值：RAW（默认，直接签名原文）/ EXTERNAL_MU（先计算 mu 再签名，与 AWS KMS 语义等价）

[pqc_signature] 使用 ML-DSA 公钥验证签名（FIPS 204）。【双模式】sign_mode 支持 RAW（默认）和 EXTERNAL_MU 两种模式，必须与签名时使用的模式一致。 - RAW 模式：直接验证原始消息签名（liboqs，最大 256 字节，空消息合法） - EXTERNAL_MU 模式：先计算 mu，再通过 OpenSSL 3.5+ mu 模式验签，可验证 AWS KMS EXTERNAL_MU 签名（最大 2048 字节，空消息合法）【算法】algorithm 支持 ML-DSA-44 / ML-DSA-65（默认）/ ML-DSA-87。【参数】 - public_key_spki_in_hex：公钥 hex（SPKI DER 或裸公钥均可），并校验 OID/长度与 algorithm 一致 - message_in_hex：原始消息 hex

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
public_key_spki_in_hex	string	no	ML-DSA 公钥的十六进制字符串（SPKI DER 或裸公钥均可）
message_in_hex	string	no	消息的十六进制字符串（空字符串表示空消息）
signature_in_hex	string	no	签名的十六进制字符串
context_in_hex	string	no	ML-DSA 上下文的十六进制字符串（可选，最大 255 字节）
sign_mode	string	no	ML-DSA 签名模式，可选值：RAW（默认，直接签名原文）/ EXTERNAL_MU（先计算 mu 再签名，与 AWS KMS 语义等价）

[pqc_signature] 独立计算 ML-DSA 的 64 字节 mu 值（FIPS 204 Section 6.2）。【用途】用于验证或调试 EXTERNAL_MU 模式的中间值，或与 AWS KMS EXTERNAL_MU 签名流程对接。【计算公式】 - tr = SHAKE-256(raw_pk, 64) - M' = 0x00 || len(ctx) || ctx || message - mu = SHAKE-256(tr || M', 64) 【参数】 - public_key_spki_in_hex：公钥 hex（SPKI DER 或裸公钥均可），并校验 OID/长度与 algorithm 一致 - message_in_hex：原始消息 hex（最大 2048 字节，空字符串表示空消息） - context_in_hex：可选上下文 hex（最大 255 字节）

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
public_key_spki_in_hex	string	no	ML-DSA 公钥的十六进制字符串（SPKI DER 或裸公钥均可）
message_in_hex	string	no	消息的十六进制字符串（空字符串表示空消息）
context_in_hex	string	no	ML-DSA 上下文的十六进制字符串（可选，最大 255 字节）

[pqc_kem] 执行 X25519 + ML-KEM-768 混合密钥交换全流程演示。【设计灵感】参考 IETF X-Wing 草案（draft-connolly-cfrg-xwing-kem）的思路，本工具实现的是通用拼接组合器（ecdh_ss || ml_kem_ss → HKDF-SHA256），并非 X-Wing 规范本身的组合器。【参数】所有密钥参数均可选： - alice_x25519_private_key_pem / bob_x25519_private_key_pem：X25519 PEM 私钥 - alice_ml_kem_public_key_base64 / bob_ml_kem_public_key_base64：ML-KEM-768 公钥，支持 raw 或 SPKI DER Base64 - alice_ml_kem_secret_key_base64

Parameter	Type	Required	Notes
alice_x25519_private_key_pem	string	no	Alice 侧 X25519 私钥的 PEM 文本
alice_x25519_public_key_pem	string	no	—
alice_ml_kem_public_key_base64	string	no	Alice 侧 ML-KEM 公钥的 Base64 字符串（raw 或 SPKI DER）
alice_ml_kem_secret_key_base64	string	no	Alice 侧 ML-KEM 私钥的 Base64 字符串（raw 或 PKCS#8 DER）
bob_x25519_private_key_pem	string	no	Bob 侧 X25519 私钥的 PEM 文本
bob_x25519_public_key_pem	string	no	—
bob_ml_kem_public_key_base64	string	no	Bob 侧 ML-KEM 公钥的 Base64 字符串（raw 或 SPKI DER）
bob_ml_kem_secret_key_base64	string	no	Bob 侧 ML-KEM 私钥的 Base64 字符串（raw 或 PKCS#8 DER）

[structured_message] 把 JSON 载荷编码为 CBOR 字节流（RFC 8949）。【算法】CBOR 规范编码（RFC 8949 §4.2.1）或不定长教学编码（§3.2.2）。【参数】 - json_payload：待编码的 JSON 文本（≤65536 字符），支持两类教学标记： {"$bytes": "<hex>"} 渲染为 byte string（major type 2）； {"$tag": <n>, "value": …} 渲染为 tagged value（major type 6） - canonical：True=规范形式（定长最短，map 键按长度+字节序排序） - prefer_indefinite：True=字符串/数组/map 用不定长编码（0x5f/0x7f/0x9f/0xbf + 0xff break） - coerce_int

Parameter	Type	Required	Notes
json_payload	string	no	待编码的结构化消息 JSON 文本（≤65536 字符）。CBOR：{"$bytes":"<hex>"} 渲染 byte string、{"$tag":n,"value":…} 渲染 tagged value；DER：ASN.1 节点 DSL（一节点一主键，如 {"sequence":[{"oid":"1.2…"}]}，形态清单见 der_encode 工具描述）
canonical	boolean	no	True=RFC 8949 §4.2.1 规范编码（定长最短、map 键排序）；与 prefer_indefinite 互斥
prefer_indefinite	boolean	no	True=不定长教学编码（字符串/数组/map 用 0x5f/0x7f/0x9f/0xbf + 0xff break）
coerce_integer_keys	boolean	no	True 时形如 "-35"/"0" 的十进制字符串键渲染为 CBOR 整数键（如 Nitro protected 头 {1:-35}）

[structured_message] 把 CBOR 字节流解码为 JSON，并给出逐字段结构拆解树（RFC 8949）。【算法】CBOR 解码，定长（§3.2.1）与不定长（§3.2.2）均容忍；要求单数据项且逐字节闭合（尾随字节即拒绝）。【参数】 - cbor_in_hex：CBOR 字节的十六进制字符串（1B~128KB）【输出】decoded_json（bytes→{"hex":…}、tag→{"tag","value"}、语义 tag→date_time/uuid 等标注形式）、decoded_type、decoded_length、 structure_tree（offset/header_len/total_len/major_type/length_form/rfc_note）、truncated、warnings。【注意】structure_tree 超过

Parameter	Type	Required	Notes
cbor_in_hex	string	no	CBOR 字节的十六进制字符串（1B~128KB，单数据项且逐字节闭合）

[cose_sign1] 构造并签名 COSE_Sign1 消息（RFC 9052 §4.2，算法 RFC 9053）。【算法】ES256(-7, P-256+SHA-256) / ES384(-35, P-384+SHA-384) / ES512(-36, P-521+SHA-512) / EdDSA(-8, Ed25519)。ES 系签名为裸 r||s （坐标左补零到曲线宽度，ES512 坐标 66 字节、r||s 共 132 字节）。【参数】 - algorithm：ES256 / ES384 / ES512 / EdDSA - ecc_private_key_in_pem：EC 或 Ed25519 私钥 PEM（须与算法曲线匹配） - ecc_private_key_password：私钥口令（未加密则留空） - payload_in_hex：待签 payload（1B~256

Parameter	Type	Required	Notes
algorithm	string	no	密码算法名称（具体可选值因工具而异，见工具描述）
ecc_private_key_in_pem	string	no	ECC 私钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
ecc_private_key_password	string	no	ECC 私钥的加密密码（原始字符串，非编码格式）
payload_in_hex	string	no	COSE Sign1 待签 payload 的十六进制字符串（1B~256KB）
external_aad_in_hex	string	no	外部 AAD 的十六进制字符串（可选；参与 Sig_structure 但不出现在消息里）
detached	boolean	no	True 时载荷带外（COSE payload 置 null / CMS eContent 缺省），验签必须提供外部内容；默认 False

[cose_sign1] 验证 COSE_Sign1 签名（RFC 9052 §4.4 Sig_structure 重构验签）。【算法】按 protected 头 alg 声明分派：-7/-35/-36（ES，裸 r||s → DER）与 -8（Ed25519）。【参数】 - cose_sign1_in_hex：COSE_Sign1 消息（≤128KB，hex） - ecc_public_key_in_pem：验签公钥 PEM。留空时从 payload 的 certificate 字段提取公钥（复刻 KMS 验 Nitro attestation 文档方式） - external_aad_in_hex：与签名时一致的外部 AAD（可选）【输出】verified（bool）、reason、key_source（provided_pem 或 payload_certificate

Parameter	Type	Required	Notes
cose_sign1_in_hex	string	no	COSE_Sign1 消息的十六进制字符串（≤128KB，4 元素数组）
ecc_public_key_in_pem	string	no	ECC 公钥的 PEM 文本（含 BEGIN/END 头尾的 Base64 编码文本）
external_aad_in_hex	string	no	外部 AAD 的十六进制字符串（可选；参与 Sig_structure 但不出现在消息里）
detached_payload_in_hex	string	no	detached 消息的外部载荷十六进制字符串（消息 payload 为 null 时验签必填，1B~256KB）

[cose_sign1] 纯拆解 COSE_Sign1 消息，不验签（RFC 9052 §4.2）。【算法】CBOR 四元素数组 [protected, unprotected, payload, signature] 逐字段拆解；protected 头解码出 alg；payload 尝试嵌套 CBOR 解码。【参数】 - cose_sign1_in_hex：COSE_Sign1 消息（≤128KB，hex）【输出】protected_in_hex、protected_header、unprotected_header、 payload_in_hex、payload_json、payload_decoded、signature_raw_in_hex、 signature_format_note（裸 r||s 语义说明）、structure_tree。【注意】structure_tr

Parameter	Type	Required	Notes
cose_sign1_in_hex	string	no	COSE_Sign1 消息的十六进制字符串（≤128KB，4 元素数组）

[cms_enveloped] 构造 CMS EnvelopedData 信封（RFC 5652 §6，KeyTransRecipientInfo）。【算法】密钥封装 RSAES-OAEP（RFC 8017 / RFC 3560 参数：hashFunc + MGF1 同哈希 + 空 pSource）或 RSAES-PKCS1-v1_5；内容加密 AES-128/256-CBC （RFC 3565，PKCS#7 填充）或 AES-128/256-GCM（RFC 5084 只为 authEnvelopedData 定义 GCM：RFC 5083 形态，version 恒 0、tag 独立放 mac 字段、nonce 12B、aes-ICVlen 声明在参数里）。【参数】 - recipient_certificate_in_pem：收件人 RSA 证书 PEM - key_wrap_al

Parameter	Type	Required	Notes
recipient_certificate_in_pem	string	no	收件人 RSA 证书的 PEM 文本（含 BEGIN/END CERTIFICATE 头尾）
key_wrap_algorithm	string	no	密钥封装算法，可选值：RSAES_OAEP_SHA_256 / RSAES_OAEP_SHA_1 / RSAES_OAEP_SHA_224 / RSAES_OAEP_SHA_384 / RSAES_OAEP_SHA_512 / RSAES_PKCS1_V1_5
content_encryption_algorithm	string	no	内容加密算法，可选值：AES256_CBC / AES128_CBC（RFC 3565）/ AES256_GCM / AES128_GCM（RFC 5084，产出 authEnvelopedData 形态 RFC 5083）
plain_data_in_hex	string	no	明文的十六进制字符串

[cms_enveloped] 解密 CMS EnvelopedData（RFC 5652 §6）/ authEnvelopedData（RFC 5083）， BER/DER 输入均容忍。【算法】按消息声明还原算法：rsaesOaep 参数（hashFunc/MGF1/pSource， RFC 3560）重建 OAEP padding，内容算法按 OID 分派（CBC 去 PKCS#7 填充 / GCM 取独立 mac 字段验 AEAD，长度必须等于声明的 aes-ICVlen， authAttrs 存在时以 universal SET OF DER 作 AAD——RFC 5083 §3； EnvelopedData 下的 GCM 无定义，直接 reason 拒绝）。【参数】 - cms_in_hex：信封 DER/BER 的十六进制（≤16MB） - recipient_privat

Parameter	Type	Required	Notes
cms_in_hex	string	no	CMS 信封 DER/BER 编码的十六进制字符串（≤16MB；KMS 回包这类 BER 不定长编码可直接输入）
recipient_private_key_in_pem	string	no	收件人 RSA 私钥的 PEM 文本（含 BEGIN/END 头尾）
recipient_private_key_password	string	no	收件人私钥的加密密码（原始字符串，未加密则留空）

[cms_enveloped] 纯拆解 CMS EnvelopedData（RFC 5652 §6）/ authEnvelopedData（RFC 5083），不解密。【算法】自写 ASN.1 TLV walker（X.690 BER 容忍）出结构树 + asn1crypto 出结构化字段，两层对照。【参数】 - cms_in_hex：信封 DER/BER 的十六进制（≤16MB）【输出】content_type_oid（envelopedData = 1.2.840.113549.1.7.3 / authEnvelopedData = 1.2.840.113549.1.9.16.1.23）、 version、recipients（rid 类型 / wrap 算法+OID / encryptedKey 字节数）、 content_encryption_iv_hex（IV 本就是公开

Parameter	Type	Required	Notes
cms_in_hex	string	no	CMS 信封 DER/BER 编码的十六进制字符串（≤16MB；KMS 回包这类 BER 不定长编码可直接输入）

[cms_signed] 构造 CMS SignedData 签名消息（RFC 5652 §5）。【算法】RSA PKCS#1 v1.5 或 ECDSA × SHA224/256/384/512； authenticatedAttributes 自动携带 contentType + messageDigest + signingTime + SMIMECapabilities，签名按 §5.4 计算在 signedAttrs 的 EXPLICIT SET OF（0x31）DER 重编码上（untag 规则）。【参数】 - signer_certificate_in_pem：签名者证书 PEM（嵌入 certificates 集，验签方可按 sid 定位） - signer_private_key_in_pem / signer_private_key_password：签名

Parameter	Type	Required	Notes
signer_certificate_in_pem	string	no	签名者证书的 PEM 文本（嵌入 certificates 集，验签方可按 sid 定位）
signer_private_key_in_pem	string	no	签名者私钥的 PEM 文本（含 BEGIN/END 头尾）
signer_private_key_password	string	no	签名者私钥的加密密码（原始字符串，未加密则留空）
hash_algorithm	string	no	哈希算法名称，可选值：Sha1 / Sha224 / Sha256 / Sha384 / Sha512（ECC 不支持 Sm3）
detached	boolean	no	True 时载荷带外（COSE payload 置 null / CMS eContent 缺省），验签必须提供外部内容；默认 False
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex

[cms_signed] 验签 CMS SignedData（RFC 5652 §5），BER/DER 输入均容忍。【算法】按消息声明还原 digestAlgorithm / signatureAlgorithm： RSA PKCS#1 v1.5、ECDSA、Ed25519、SHA1 消息均可验；rsassa_pss 按 RFC 8017 A.2.3 参数（hashFunc / MGF1 / saltLength）重建 padding；signedAttrs 验签体是 EXPLICIT SET OF DER 重编码（§5.4）， BER 消息先规范形重编码再验。【参数】 - cms_in_hex：SignedData DER/BER 的十六进制（≤16MB） - data_in_hex：外部内容（仅 detached 消息必填；attached 消息以消息内嵌内容为准，忽略此字段

Parameter	Type	Required	Notes
cms_in_hex	string	no	CMS 信封 DER/BER 编码的十六进制字符串（≤16MB；KMS 回包这类 BER 不定长编码可直接输入）
data_in_hex	string	no	数据的十六进制字符串。RAW 模式为消息原文 Hex，DIGEST 模式为哈希摘要 Hex
signer_certificate_in_pem	string	no	签名者证书的 PEM 文本（嵌入 certificates 集，验签方可按 sid 定位）

[structured_message] 解剖任意 ASN.1/BER 字节的 TLV 结构，给出逐节点拆解树与 DER 判定（X.690）。【算法】ASN.1 显微镜：定长（§8.1.3.3-5）/不定长 BER（§8.1.3.6，0x80+EOC）/ 分段八位串（§8.7）/高 tag 号（§8.1.2.4）均容忍；要求单根逐字节闭合。【参数】 - asn1_in_hex：ASN.1/BER 字节的十六进制字符串（1B~128KB）【输出】der_conformant、ber_features（walker 检出的 BER 特征清单）、 node_count、total_length、structure_tree（offset/header_len/total_len/ tag_hex/tag_number/class/constructed/length_form/value_

Parameter	Type	Required	Notes
asn1_in_hex	string	no	ASN.1/BER 字节的十六进制字符串（1B~128KB，单根且逐字节闭合；BER 不定长/分段八位串/高 tag 号均容忍）

[structured_message] 把 JSON 节点 DSL 编码为 DER 字节（X.690）。【算法】DER 规范编码（定长最短 + SET OF 排序）；或教学 BER 不定长（构造容器 0x80 + EOC，复刻 AWS KMS 回包形态）。【参数】 - json_payload：节点 DSL（≤65536 字符），一节点一主键： {"integer": n}/{"enumerated": n}/{"boolean": true}/{"null": true}； {"oid": "1.2.840…"}（首弧 0/1 时次弧≤39）； {"octet_string": "<hex>"}/{"bit_string": {"hex","unused_bits":0..7}}； {"utf8_string"|"printable_string"|"ia5_st

Parameter	Type	Required	Notes
json_payload	string	no	待编码的结构化消息 JSON 文本（≤65536 字符）。CBOR：{"$bytes":"<hex>"} 渲染 byte string、{"$tag":n,"value":…} 渲染 tagged value；DER：ASN.1 节点 DSL（一节点一主键，如 {"sequence":[{"oid":"1.2…"}]}，形态清单见 der_encode 工具描述）
der	boolean	no	True=规范 DER（X.690 §10 定长最短 + SET OF 按 §11.6 排序）；与 ber_indefinite 互斥
ber_indefinite	boolean	no	True=构造容器不定长 BER（0x80 + 两字节 EOC 递归，原语保持定长；AWS KMS 回包同款形态）

Where are you running it?

Tool surface

Release history

CipherHUB Cryptography Toolkit MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also