{"id":13480414,"url":"https://github.com/guanzhi/GmSSL","last_synced_at":"2025-03-27T10:32:45.541Z","repository":{"id":23976364,"uuid":"27359183","full_name":"guanzhi/GmSSL","owner":"guanzhi","description":"支持国密SM2/SM3/SM4/SM9/SSL的密码工具箱","archived":false,"fork":false,"pushed_at":"2024-07-31T11:27:42.000Z","size":42256,"stargazers_count":5161,"open_issues_count":311,"forks_count":1663,"subscribers_count":213,"default_branch":"master","last_synced_at":"2024-10-29T15:02:09.084Z","etag":null,"topics":["crypto","encryption","go","java","javascript","pairing","sm2","sm3","sm4","sm9","ssl","tls","zuc"],"latest_commit_sha":null,"homepage":"http://gmssl.org","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guanzhi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2014-12-01T02:33:11.000Z","updated_at":"2024-10-29T09:12:24.000Z","dependencies_parsed_at":"2023-02-17T01:30:52.711Z","dependency_job_id":"46e56a17-cdd8-4dc1-9085-3bdb04be56bf","html_url":"https://github.com/guanzhi/GmSSL","commit_stats":{"total_commits":422,"total_committers":35,"mean_commits":"12.057142857142857","dds":"0.28672985781990523","last_synced_commit":"01ade02dfa5b66e68431e1b4177d97cdc99a4a54"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanzhi%2FGmSSL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanzhi%2FGmSSL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanzhi%2FGmSSL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guanzhi%2FGmSSL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guanzhi","download_url":"https://codeload.github.com/guanzhi/GmSSL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222239320,"owners_count":16953915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crypto","encryption","go","java","javascript","pairing","sm2","sm3","sm4","sm9","ssl","tls","zuc"],"created_at":"2024-07-31T17:00:38.934Z","updated_at":"2024-10-30T14:30:30.754Z","avatar_url":"https://github.com/guanzhi.png","language":"C","readme":"# GmSSL\n\n[![CMake-Ubuntu/macOS](https://github.com/guanzhi/GmSSL/workflows/CMake/badge.svg)](https://github.com/guanzhi/GmSSL/actions/workflows/cmake.yml)\n[![CMake-Windows](https://github.com/guanzhi/GmSSL/workflows/CMake-windows/badge.svg)](https://github.com/guanzhi/GmSSL/actions/workflows/cmake-windows.yml)\n[![CMake-Android](https://github.com/guanzhi/GmSSL/actions/workflows/android-ci.yml/badge.svg)](https://github.com/guanzhi/GmSSL/actions/workflows/android-ci.yml)\n[![CMake-iOS](https://github.com/guanzhi/GmSSL/actions/workflows/ios.yml/badge.svg)](https://github.com/guanzhi/GmSSL/actions/workflows/ios.yml)\n\nGmSSL是由北京大学自主开发的国产商用密码开源库，实现了对国密算法、标准和安全通信协议的全面功能覆盖，支持包括移动端在内的主流操作系统和处理器，支持密码钥匙、密码卡等典型国产密码硬件，提供功能丰富的命令行工具及多种编译语言编程接口。\n\n\n## 主要特性\n\n* 超轻量：GmSSL 3 大幅度降低了内存需求和二进制代码体积，不依赖动态内存，可以用于无操作系统的低功耗嵌入式环境(MCU、SOC等)，开发者也可以更容易地将国密算法和SSL协议嵌入到现有的项目中。\n* 更合规：GmSSL 3 可以配置为仅包含国密算法和国密协议(TLCP协议)，依赖GmSSL 的密码应用更容易满足密码产品型号检测的要求，避免由于混杂非国密算法、不安全算法等导致的安全问题和合规问题。\n* 更安全：TLS 1.3在安全性和通信延迟上相对之前的TLS协议有巨大的提升，GmSSL 3 支持TLS 1.3协议和RFC 8998的国密套件。GmSSL 3 默认支持密钥的加密保护，提升了密码算法的抗侧信道攻击能力。\n* 跨平台：GmSSL 3 更容易跨平台，构建系统不再依赖Perl，默认的CMake构建系统可以容易地和Visual Studio、Android NDK等默认编译工具配合使用，开发者也可以手工编写Makefile在特殊环境中编译、剪裁。\n\n## 下载\n\n* GmSSL的主分支版本为 [GmSSL-3.1.1](https://github.com/guanzhi/GmSSL/releases/tag/v3.1.1)，主要增加跨平台特性，特别是对Windows/Visual Studio的支持，Windows、Android、iOS平台的开发者需要使用该版本。\n\n## 编译与安装\n\nGmSSL 3 采用了cmake构建系统。下载源代码后将其解压缩，进入源码目录，执行：\n\n```bash\nmkdir build\ncd build\ncmake ..\nmake\nmake test\nsudo make install\n```\n\n在`make install`完成后，GmSSL会在默认安装目录中安装`gmssl`命令行工具，在头文件目录中创建`gmssl`目录，并且在库目录中安装`libgmssl.a`、`libgmssl.so`等库文件。\n\n### Visual Studio环境编译\n\n在Visual Studio命令提示符下执行：\n\n```bash\nmkdir build\ncd build\ncmake .. -G \"NMake Makefiles\" -DWIN32=ON\nnmake\n```\n\n## 主要功能\n\n### 密码算法\n\n* 分组密码：SM4 (CBC/CTR/GCM/ECB/CFB/OFB/CCM/XTS), AES (CBC/CTR/GCM)\n* 序列密码：ZUC/ZUC-256, ChaCha20\n* 哈希函数: SM3, SHA-1, SHA-224/256/384/512\n* 公钥密码：SM2加密/签名, SM9加密/签名\n* MAC算法：HMAC, GHASH, CBC-MAC\n* 密钥导出函数：PBKDF2、HKDF\n* 随机数生成器：Intel RDRAND, HASH_DRBG (NIST.SP.800-90A)\n\n### 证书和数字信封\n\n* 数字证书：X.509证书, CRL证书注销列表, CSR (PKCS #10) 证书签名请求\n* 私钥加密：基于SM4/SM3口令加密的PEM格式私钥 (PKCS #8)\n* 数字信封：SM2密码消息 (GM/T 0010-2012)\n\n### SSL协议\n\n* TLCP 1.1，支持密码套`TLS_ECC_SM4_CBC_SM3 {0xE0,0x13}` (GB/T 38636-2020、GM/T 0024-2014)\n* TLS 1.2，支持密码套件`TLS_ECDHE_SM4_CBC_SM3 {0xE0,0x11}` (GB/T 38636-2020、GM/T 0024-2014)\n* TLS 1.3，支持密码套件`TLS_SM4_GCM_SM3 {0x00,0xC6}`  (RFC 8998)\n\n### 多语言接口\n\nGmSSL通过子项目提供多种多种编程语言绑定\n\n * [GmSSL-Java](https://github.com/GmSSL/GmSSL-Java) 以JNI方式实现的Java语言绑定\n * [GmSSL-PHP](https://github.com/GmSSL/GmSSL-PHP) 以PHP扩展方式实现的PHP语言绑定\n * [GmSSL-Go](https://github.com/GmSSL/GmSSL-Go) 以CGO方式实现的Go语言绑定\n * [GmSSL-Python](https://github.com/GmSSL/GmSSL-Python) 以ctypes方式实现的Python语言绑定\n * [GmSSL-JS](https://github.com/guanzhi/GmSSL-JS) 纯JavaScript实现的国密算法库\n\n### 支持国密硬件\n\nGmSSL内置支持国密SDF密码硬件（通常为PCI-E接口的密码卡或者服务器密码机）和SKF密码硬件（通常为小型USB密码钥匙）。经过测试的密码产品型号包括：\n\n* to be added.\n\n开发者也可以用GmSSL的子项目SoftSDF(https://github.com/GmSSL/SoftSDF) ，用功能等效（但是不具备密码硬件密钥保护等价的安全性）的软件SDF模块来进行开发和测试，正式部署的时候再替换为硬件SDF。\n\n### OpenSSL兼容性\n\nGmSSL 3.0版本重写了所有的代码并改变了原有API，因此当前GmSSL版本和OpenSSL不兼容，无法直接用GmSSL替换OpenSSL进行编译。GmSSL提供了子项目 OpenSSL-Compatibility-Layer (https://github.com/GmSSL/OpenSSL-Compatibility-Layer) 提供了OpenSSL的兼容层，Nginx等应用可以通过OpenSSL-Compatibility-Layer调用GmSSL功能。经过测试目前兼容层可以兼容Nginx 1.16 ~ 1.25 之间的版本。\n\n## Benchmark\n\n性能测试结果是在单核单线程且未修改处理器默认配置下5次测试中取最好效果。由于未关闭睿频或进行大小核设置，这个成绩通常会略高于多核多线程中每核心的平均成绩。\n\n```\ncmake .. -DENABLE_TEST_SPEED=ON\nmake\n./bin/sm4test; ./bin/sm3test; ./bin/sm2_signtest; ./bin/sm2_enctest; ./bin/sm9test; ./bin/zuctest\n```\n\nMacBook Pro 13-inch 2018: 2.7 GHz Quad-Core Intel Core i7, Intel  Iris Plus Graphics 655. 8 GB 2133 HMz LPDDR3. macOS Sonoma 14.3.\n\n```\nspeed_sm4_encrypt: 164.826108 MiB per second\nspeed_sm4_encrypt_blocks: 163.120495 MiB per second\nspeed_sm4_cbc_encrypt_blocks: 156.870435 MiB per second\nspeed_sm4_cbc_decrypt_blocks: 174.701097 MiB per second\nspeed_sm4_ctr_encrypt_blocks: 178.457901 MiB per second\nspeed_sm4_ctr32_encrypt_blocks: 185.007458 MiB per second\nspeed_zuc_generate_keystream: 337.403260-MiB per second\nspeed_zuc_encrypt: 356.315696-MiB per second\ntest_sm3_speed: 273.551034 MiB per second\nsm2_sign_ctx speed (ENABLE_SM2_AMD64): 4096 signs time 0.036916 seconds, 110954.599632 signs per second\nsm2_sign_ctx speed : 4096 signs time 0.236611 seconds, 17311.114023 signs per second\ntest_sm2_encrypt_ctx_speed (ENABLE_SM2_AMD64): 17879.592122 encryptions per second\ntest_sm2_encrypt_ctx_speed: 1869.314131 encryptions per second\ntest_sm9_z256_pairing_speed: 173 pairings per second\n```\n\nMacBook Air M2 2022. Apple M2. 16 GB. Sonoma 14.5.\n\n```\nspeed_sm4_encrypt: 143.180578 MiB per second\nspeed_sm4_encrypt_blocks: 190.928509 MiB per second\nspeed_sm4_cbc_encrypt_blocks: 148.519447 MiB per second\nspeed_sm4_cbc_decrypt_blocks: 187.305378 MiB per second\nspeed_sm4_ctr_encrypt_blocks: 191.195450 MiB per second\nspeed_sm4_ctr32_encrypt_blocks: 191.522725 MiB per second\nspeed_zuc_generate_keystream: 344.604781-MiB per second\nspeed_zuc_encrypt: 344.723575-MiB per second\ntest_sm3_speed: 327.298762 MiB per second\nsm2_sign_ctx speed : 4096 signs time 0.290709 seconds, 14089.691066 signs per second\ntest_sm2_encrypt_ctx_speed: 1518.575861 encryptions per second\ntest_sm9_z256_pairing_speed: 141 pairings per seconds\n```\n\n## ChangeLog\n\n自从3.1.1版本以来\n\n* 提升了全部国密算法的性能，并在`tests`测试程序中增加了国密算法的性能测试\n* 增加了SM4 ECB/CFB/OFB/CCM/XTS加密模式，带SM3-HMAC的SM4 CBC/CTR模式，并且在`gmssl`命令行工具中增加了所有SM4加密模式的选项\n* 在`gmssl`命令行中增加了GHASH计算的选项\n* 增加了`sdftest`正确性和兼容性测试命令，以独立子项目的形式提供了SDF的软件实现SoftSDF\n* 移除了RC4, MD5等已被攻破的密码算法\n\n## 开发者们\n\u003ca href=\"https://github.com/guanzhi/GmSSL/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=guanzhi/GmSSL\" /\u003e\n\u003c/a\u003e\n\n## Stargazers over time\n\n[![Stargazers over time](https://starchart.cc/guanzhi/GmSSL.svg)](https://starchart.cc/guanzhi/GmSSL)\n\n","funding_links":[],"categories":["C","Repositories"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguanzhi%2FGmSSL","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguanzhi%2FGmSSL","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguanzhi%2FGmSSL/lists"}