gmkitx API - v0.10.1
    正在准备搜索索引...

    接口 VerifyOptions

    验签选项

    SM2 验签算法的可配置选项,必须与签名时使用的选项保持一致

    interface VerifyOptions {
        curveParams?: SM2CurveParams;
        inputFormat?: InputFormatType;
        signatureFormat?: SM2SignatureInputFormat;
        skipZComputation?: boolean;
        userId?: string;
    }
    索引
    curveParams?: SM2CurveParams

    标准曲线参数兼容声明。当前实现不支持自定义曲线。

    inputFormat?: InputFormatType

    签名输入格式

    • hex:十六进制字符串
    • base64:Base64 编码字符串

    不传时会自动识别 hex/base64(优先按 hex 识别)

    signatureFormat?: SM2SignatureInputFormat

    签名格式

    • raw(默认): 签名为 Raw 格式(r || s)
    • der: 签名为 DER 编码格式
    • auto: 自动识别签名格式(仅在显式指定时启用)
    skipZComputation?: boolean

    是否跳过 Z 值计算(必须与签名时保持一致)

    true 只用于验证采用 e = SM3(M) 的旧协议签名;标准签名必须保留默认值 false。两端设置不一致时验签返回 false

    非标准旧协议兼容选项。新代码应使用标准 SM2 身份绑定流程。

    userId?: string

    用户 ID(必须与签名时使用的相同)

    本库默认值:'1234567812345678'(保持向后兼容)

    ⚠️ 重要:签名和验签必须使用相同的 userId,否则验签会失败

    兼容约定:省略值或空字符串都会回落到 DEFAULT_USER_ID。 如需自定义身份,请传入非空字符串,并确保签名端使用相同值。