/pygmlib

gmlib密码库的python绑定

Primary LanguageC++MIT LicenseMIT

pygmlib

GMLib项目的python绑定，利用pybind11进行绑定

已经通过测试的环境

操作系统 CPU python版本
Windows11 i5-12500H 3.9
Windows11 i5-12500H 3.10

1 快速开始

1.1 通过pypi安装（推荐）

pip install pygmlib

1.2 通过源码包安装（推荐）

在pypi主页下载pygmlib项目的源码包并解压

  • 运行
pip install ./pygmlib

1.3 通过github项目安装

  • 克隆仓库
git clone https://github.com/oldprincess/py-gmlib.git
  • 获取子模块
cd py-gmlib
git submodule update --init --recursive
cd ..
  • pip安装pygmlib
pip install ./pygmlib

2 支持的密码算法

  • SM3
  • SM4: ECB, CBC, CFB, OFB, CTR, GCM
  • AES: ECB, CBC, CFB, OFB, CTR, GCM

3 使用样例

下面的样例实现SM4算法ECB模式的加密和解密功能，并校验正确性

import pygmlib

sm4_key = bytes(16)  # 16 bytes ZERO
sm4_pt = bytes(16)  # 16 bytes ZERO
# sm4 ecb encrypt
sm4e = pygmlib.cipher.Sm4EcbEncryptor(sm4_key)
ct = sm4e.update(sm4_pt)
ct += sm4e.final()
# sm4 ecb decrypt
sm4d = pygmlib.cipher.Sm4EcbDecryptor(sm4_key)
pt = sm4d.update(ct)
pt += sm4d.final()

assert pt == sm4_pt
# key: 00000000000000000000000000000000
# pt : 00000000000000000000000000000000
# ct : 9f1f7bff6f5511384d9430531e538fd3
print("key:", sm4_key.hex())
print("pt :", sm4_pt.hex())
print("ct :", ct.hex())