github.com/emmansun/gmsm@v0.29.1/docs/cfca.md (about)

     1  # CFCA互操作性指南
     2  这是一份**不完整**的CFCA互操作性指南。
     3  
     4  ## 什么是CFCA
     5  CFCA是中国金融认证中心的英文缩写。
     6  
     7  ## 什么是SADK
     8  SADK（Security Application Development Kit）是CFCA推出的一套支持全平台、全浏览器、多语言的安全应用开发套件。实现了证书下载、证书应用过程中的全业务功能覆盖，可与客户业务系统、CFCA RA、CA、统一下载平台无缝对接，为用户提供证书下载、证书更新、签名验签、加密解密等全方位的数字证书安全服务。具体说明请参考[数字证书安全应用开发套件SADK](https://www.cfca.com.cn/20150807/101228565.html)。
     9  
    10  其JAVA版本(其它语言版本未知)基本上是一个基于[Bouncy Castle](https://www.bouncycastle.org/)的实现（当然它看起来也支持JNI接入OpenSSL、U盾？）。
    11  
    12  ## 为什么会有互操作性问题
    13  * SADK存在较早，可能有些实现早于标准发布。
    14  * SADK版本较多，不同版本也会有互操作性兼容问题。
    15  * 其它未知原因。
    16  
    17  因为我也找不到SADK的版本历史或者Change Log，这里只是根据有限资料的一些判断。
    18  
    19  ## 容易出现互操作性问题的功能
    20  相对而言，互操作性问题主要出现在SM2椭圆曲线公钥密码算法应用上，特别是加解密、数字信封加解密上。
    21  
    22  ### SM2加解密
    23  加解密算法实现部分没有什么互操作性问题，主要是密文格式问题。
    24  
    25  #### SADK 3.2之前版本
    26  由于没有版本历史，所以这里只是大致推测（如果有不准确之处，敬请指出）。  
    27  SADK 3.2之前的版本，只支持C1C2C3密文格式，而且C1只支持非压缩点格式，且输出忽略0x04这个点非压缩标识。  
    28  
    29  | 随机点 | 密文 | SM3哈希值 |  
    30  | :--- | :--- | :--- |  
    31  | C1 (64 bytes) | C2 | C3 (32 bytes) |  
    32  
    33  所以如果和SADK 3.2之前的应用交互，加密输出格式只能选C1C2C3，且密文通过切片操作忽略首字节（0x04这个点非压缩标识）；反之，如果是解密SADK 3.2之前的应用提供的密文，则要指定C1C2C3格式，同时，自己在密文前添加0x04这个点非压缩标识。**互操作的重要前提是知道对方的密文格式**。
    34  
    35  #### SADK 3.2+版本
    36  SADK 3.2之后的版本，支持下列SM2密文格式(encryptedType)：
    37  
    38  | encryptedType | 输出格式 | 用本软件库如何解密 |   
    39  | :--- | :--- | :--- |  
    40  | 0 | ASN.1编码格式 ```EncryptUtil.encrypt``` 方法默认 | 正常解密 |
    41  | 2 | C1C3C2 格式，带0x04这个点非压缩标识 | 正常解密 |
    42  | 4 | C1C3C2 格式，不带0x04这个点非压缩标识 （```EncryptUtil.encryptMessageBySM2 / EncryptUtil.encryptFileBySM2``` 方法默认） | 添加0x04前缀后解密 |
    43  | 8 | C1C2C3 格式，带0x04这个点非压缩标识 | 指定解密Opts后解密 |
    44  | 16 | C1C2C3 格式，不带0x04这个点非压缩标识 | 添加0x04前缀，同时指定解密Opts后解密 |  
    45  
    46  
    47  **SADK 3.2之后的版本，解密过程**：  
    48  1. 先尝试是否ASN.1格式，如果是，就解密；否则，
    49  2. 当**C1C3C2，不带0x04这个点非压缩标识**的格式处理，如果解密成功，则结束；否则，
    50  3. 当**C1C2C3，不带0x04这个点非压缩标识**的格式处理。
    51  
    52  从这个解密流程来看，SADK 3.2+可以解密 SADK 3.2之前的SM2密文，反之不行。
    53  
    54  所以如果和SADK 3.2之后的应用交互，加密输出格式可以是ASN.1编码格式，或者是不带0x04这个点非压缩标识的C1C3C2/C1C2C3格式；反之，如果是解密使用SADK 3.2+的应用提供的密文，则要先区分是否是ASN.1格式，是的话就比较简单；不是的话则要指定C1C3C2格式，同时，自己在密文前添加0x04这个点非压缩标识。**互操作的重要前提是知道对方的密文格式**。
    55  
    56  ### SM2数字信封加解密
    57  互操作性问题主要出在：
    58  1. 数据对称加密所用密钥的SM2密文格式。
    59  2. 对称加密算法的OID。
    60  
    61  #### SADK 3.2之前版本
    62  1. 数据对称加密密钥的密文格式为**C1C2C3 格式，不带0x04这个点非压缩标识**。这个不符合《GM/T 0010-2012 SM2密码算法加密签名消息语法规范》以及《GB/T 35275-2017 信息安全技术 SM2密码算法加密签名消息语法规范》。
    63  2. SM4-CBC的OID，使用了["SM4" block cipher](https://oid-rep.orange-labs.fr/get/1.2.156.10197.1.104)，而不是["SMS4-CBC"](https://oid-rep.orange-labs.fr/get/1.2.156.10197.1.104.2)。
    64  
    65  本软件库的```pkcs7.EncryptCFCA```方法```DecryptCFCA```方法提供了SADK 3.2之前版本的信封加解密兼容性，记得cipher参数选择```pkcs.SM4```。
    66  
    67  #### SADK 3.2+版本
    68  1. 数据对称加密密钥的密文格式为**ASN.1编码格式**，这个符合《GB/T 35275-2017 信息安全技术 SM2密码算法加密签名消息语法规范》。
    69  2. SM4-CBC的OID，使用了["SM4" block cipher](https://oid-rep.orange-labs.fr/get/1.2.156.10197.1.104)，而不是["SMS4-CBC"](https://oid-rep.orange-labs.fr/get/1.2.156.10197.1.104.2)。
    70  
    71  本软件库的```pkcs7.EncryptSM```方法```Decrypt```方法提供了SADK 3.2+版本的信封加解密兼容性，记得cipher参数选择```pkcs.SM4```。
    72  
    73  从SADK 的向下兼容性来看，SADK 3.2+能够解密SADK 3.2之前版本的数字信封加密数据，反之不行。
    74  
    75  ### 解密时自动检测？
    76  要穷举、尝试所有可能的密文格式不是不可以，但这会或多或少地影响解密的性能。你要和对方集成，还是知己知彼比较好，对于加解密来说，对用户透明不代表是好事。本软件库的SM2解密也实现了一定的自动检测（通过首字节判断，基于首字节只有固定那几个的假设）：
    77  * 0x30 - ASN.1格式。
    78  * 0x04 - C1为非压缩点格式，具体是C1C3C2还是C1C2C3取决于解密时的选项参数，默认为C1C3C2。
    79  * 0x02/0x03 - C1为压缩点格式，具体是C1C3C2还是C1C2C3取决于解密时的选项参数，默认为C1C3C2。
    80  
    81  ### SM2私钥、证书的解析
    82  这个是CFCA自定义的，未见相关标准，可以通过```cfca.ParseSM2```来解析。