Files
GmSSL/README.md
2016-04-07 22:15:41 +02:00

36 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GmSSL
GmSSL (http://gmssl.org) 是支持国密算法和标准的OpenSSL分支增加了对国密SM2/SM3/SM4算法和ECIES、CPK、ZUC算法的支持实现了这些算法与EVP API和命令行工具的集成。GmSSL由北京大学信息安全实验室(http://infosec.pku.edu.cn)开发和维护。
GmSSL的`libcrypto`密码库增加的密码算法包括:
- SM2是国密椭圆曲线公钥密码标准其中包含数字签名、公钥加密和密钥交换三个具体方案以及一个256比特素域上的推荐椭圆曲线参数。GmSSL内置了SM2的推荐曲线参数实现了SM2的签名算法和公钥加密算法。
- SM3是国密密码杂凑算法标准输出的杂凑值长度为256比特。
- SM4是国密分组密码标准又名SMS4其分组长度和密钥长度均为128比特。GmSSL实现了SMS4密码及SMS4的ECB、CBC、CFB、OFB等工作模式。
- X9.63 KDF是密钥派生函数国际标准之一ECIES和SM2公钥加密方案依赖该算法GmSSL实现了X9.63 KDF并用于支持ECIES和SM2公钥加密。
- ECIES (Elliptic Curve Integrated Encryption Scheme)是椭圆曲线公钥加密的国际标准,可用于加密数据。
- CPK是由南相浩和陈钟设计的基于身份的密码。GmSSL实现了CPK的系统建立和密钥生成算法生成的密钥可以用于DSA、ECDH、ECDSA、ECIES、SM2等公钥密码算法。
- ZUC(祖冲之算法)是由我国设计的序列密码以32位字为单位输出密钥流其密钥长度和IV长度均为128比特。GmSSL的ZUC算法处于开发中。
GmSSL提供命令行工具`gmssl`可用于生成SM2签名、SM3摘要、HMAC-SM3消息认证码支持SM4和ZUC数据加解密。
``` bash
$ echo -n abc | gmssl dgst -sm3
66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0
```
显示SM2推荐椭圆曲线域参数
``` bash
$ gmssl ecparam -text -noout -name sm2p256v1 -param_enc explicit
```
在代码目录`./certs/sm2/`目录中给出了SM2证书的例子可以用`gmssl`工具进行解析
```
$ gmssl x509 -text -noout -in certs/sm2/sm2-x509.pem
$ gmssl pkcs7 -print_certs -in certs/sm2/sm2-pkcs7.pem
```
GmSSL新增的EVP对象包括`EVP_sm3()`、`EVP_sm4_ecb()`、`EVP_sm4_cbc()`、`EVP_sm4_ofb()`、`EVP_sm4_cfb()`和`EVP_zuc()`。