数安商用密码
文档首页 / Python 示例

Python 示例

Python SDK 完整示例:SM4加密、SM2签名、SM3哈希

撰写中

本页给出 Python 接入的完整最小示例:安装、初始化、SM4 加解密、SM2 签名验签、异常处理。

💡
下文代码与接口为示例,方法名与参数以你拿到的实际 SDK / 接口版本为准;需要真实接入凭证与文档请联系技术支持

安装

pip install dscc-sdk

初始化客户端

from dscc import CryptoClient

client = CryptoClient(
    endpoint="https://your-host",   # 平台地址
    app_id="your_app_id",
    app_secret="your_app_secret",
)

SM4 加解密

cipher = client.sm4_encrypt(key_id="kms-key-001", plaintext="敏感数据", mode="CBC")
print("密文:", cipher)
plain = client.sm4_decrypt(key_id="kms-key-001", ciphertext=cipher)
print("明文:", plain)

SM2 签名与验签

sig = client.sm2_sign(key_id="sign-key-001", data="待签名内容")
ok  = client.sm2_verify(key_id="sign-key-001", data="待签名内容", signature=sig)
print("验签结果:", ok)

异常处理

from dscc import CryptoError

try:
    cipher = client.sm4_encrypt(key_id="kms-key-001", plaintext="x")
except CryptoError as e:
    print("调用失败:", e.code, e.message)

下一步:SM4 加密接口 · 完整 API 参考 · SDK 说明