Skip to main content

Crate jwc

Crate jwc 

Source
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)

Functions§

b64url_decode
b64url_encode