Metadata-Version: 2.4
Name: rs-license
Version: 1.0.0
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Summary: JWT HS256 license verification library (Rust backend)
Keywords: jwt,license,rust,pyo3,security
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# rs_license —— JWT HS256 授权校验库

基于 PyO3 + Rust 的高安全性 License 校验库。验签逻辑全部在 Rust 二进制内部完成，Python 仅做简单调用。

## 安全特性

1. **密钥混淆存储**：真实密钥 XOR 掩码后分片打散存储，运行时动态还原，源码中无明文密钥。
2. **内存清零**：密钥使用后立即 `fill(0)` 清零，防止内存 dump 抓取。
3. **Linux 反调试**：检测 `/proc/self/status` 的 TracerPid，调试器附加时返回错误密钥使验签失效。
4. **签发隔离**：`generate_token` 仅 dev 模式编译，Release 包完全不含签发能力。
5. **符号剥离**：Release 编译剥离全部符号表、函数名、行号信息。

## 文件结构

```
├── Cargo.toml           # Rust 依赖与编译配置
├── pyproject.toml       # maturin 打包配置
├── src/
│   └── lib.rs           # 核心代码（验签/签发/密钥混淆/反调试）
├── tools/
│   └── gen_key_array.py # 密钥分片生成工具
├── demo.py              # 使用 Demo
└── README.md            # 本文件
```

## 快速开始

### 1. 安装 maturin

```bash
pip install maturin
```

### 2. 开发调试编译（含 generate_token）

```bash
cd rs_license
maturin develop --features dev
```

### 3. Release 正式打包（不含 generate_token）

```bash
maturin build --release
# 产物：target/wheel/rs_license-1.0.0-*.whl
```

### 4. Python 使用

```python
import sys
from rs_license import verify_token, LicenseCode

token = "eyJhbG..."  # 我方签发的 Token
resp = verify_token(token)

if resp.code != LicenseCode.OK:
    print(f"授权失败: {resp.message}")
    sys.exit(1)

print(f"授权通过，客户: {resp.client_id}")
```

## 生成新密钥

```bash
cd tools
python3 gen_key_array.py
# 按提示输入/生成密钥，将输出的数组替换到 src/lib.rs 中
```

## 编译加固

```bash
# UPX 加壳
upx --best --ultra-brute target/release/librs_license.so

# 上传 PyPI
pip install twine
twine upload target/wheel/rs_license-1.0.0-*.whl
```

