Expand description
§jwc - 国密 JSON Web 密码应用语法规范 (GM/T 0125—2022)
jwc 是一个基于纯 Rust 实现的、严格遵循中华人民共和国密码行业标准 GM/T 0125—2022 的 JSON Web 密码应用体系库,
同时也与国际标准 RFC 7515 (JWS)、RFC 7516 (JWE)、RFC 7517 (JWK)、RFC 7519 (JWT) 保持高度兼容。
§核心规范覆盖
- GM/T 0125.1—2022: 算法标识 (
SGD_SM3_SM2,SGD_SM3_HMAC,SGD_SM2_3,SGD_SM4_CCM,SGD_SM4_GCM等) - GM/T 0125.2—2022: 数字签名 (JWS,支持 Compact、Flattened 与 General 序列化)
- GM/T 0125.3—2022: 数据加密 (JWE,支持 SM2 密钥封装、SM4-GCM/CCM 认证加密与 DEFLATE 压缩)
- GM/T 0125.4—2022: 密钥规范 (JWK 与 JWK Set 集合管理,支持硬件密码机/KMS 回调扩展)
§快速上手
§1. 国密 JWT 签发与校验 (SM2 / SM3-HMAC)
use jwc::prelude::*;
use serde::{Serialize, Deserialize};
#[derive(Serialize, Deserialize, Debug, PartialEq)]
struct UserClaims {
user_id: String,
role: String,
}
// 生成 SM2 密钥对
let sm2_key = Jwk::generate_sm2()?.with_kid("key-01");
let pub_key = sm2_key.to_public_key();
// 构造声明并签发 Token
let claims = Claims::new(UserClaims {
user_id: "admin".into(),
role: "superuser".into(),
}).with_issuer("https://auth.example.com").with_expires_in(3600);
let token = Jwt::encode(&claims, &sm2_key)?;
// 校验并解析 Token
let validation = Validation::new().with_issuer("https://auth.example.com");
let data: TokenData<UserClaims> = Jwt::decode(&token, &pub_key, &validation)?;
assert_eq!(data.claims.custom.user_id, "admin");§2. JWC 一键签密 (Sign-then-Encrypt 端到端传输)
use jwc::prelude::*;
let sender = Jwk::generate_sm2()?.with_kid("sender-key");
let receiver = Jwk::generate_sm2()?.with_kid("receiver-key");
// 发送方:一键签名 + DEFLATE 压缩 + SM4-GCM 加密
let sealed_token = Jwc::seal(
b"Confidential Data",
&sender,
&receiver.to_public_key(),
Enc::Sm4Gcm,
true, // compress
Format::Compact,
)?;
// 接收方:一键解密 + 自动解压 + 验签
let original = Jwc::unseal(&sealed_token, &receiver, &sender.to_public_key())?;
assert_eq!(original, b"Confidential Data");Re-exports§
pub use Alg as Algorithm;pub use error::JwcError;pub use jwe::Jwe;pub use jwe::JweRecipient;pub use jwk::DecryptFn;pub use jwk::Jwk;pub use jwk::JwkEc;pub use jwk::JwkOct;pub use jwk::JwkOkp;pub use jwk::JwkSet;pub use jwk::JwkSm2;pub use jwk::JwkSm9;pub use jwk::SignFn;pub use jwk::Sm2Key;pub use jws::Jws;pub use jws::JwsSignature;pub use jwt::Claims;pub use jwt::Jwt;pub use jwt::TokenData;pub use jwt::Validation;
Modules§
- algorithms
- 密码学算法实现模块
- crypto
- error
- 统一错误处理定义 (JwcError)
- jwe
- JSON Web 加密 (JWE) 模块
- jwk
- jws
- jwt
- JSON Web Token (JWT) 强类型封装模块
- prelude
Structs§
- Jwh
- JSON Web 头部对象 (JWH)
Enums§
- Alg
- 签名、鉴别与密钥加密算法标识 (alg)
- Curve
- 椭圆曲线标识 (crv) 参数
- Enc
- 内容加密算法标识 (enc)
- Format
- 报文输出序列化格式
- Jwc
- JSON Web 密码应用语法统领枚举 (涵盖数字签名 JWS 与数据加密 JWE)
- JwcOutput
- JWC 万能处理输出结果
- KeyOp
- 密钥操作 (key_ops) 参数
- KeyType
- 密钥类型 (kty) 参数
- KeyUse
- 公钥用法 (use) 参数
- Zip
- 明文压缩算法标识 (zip)