jsonwebtoken

安装

jsonwebtoken = "7"
serde = {version = "1.0", features = ["derive"] }

算法

• HS256
• HS384
• HS512
• RS256
• RS384
• RS512
• PS256
• PS384
• PS512
• ES256
• ES384

如何使用

use serde::{Serialize, Deserialize};
use jsonwebtoken::{encode, decode, Header, Algorithm, Validation, EncodingKey, DecodingKey};

/// 我们的声言结构型, 需要由`Serialize` 或 `Deserialize`派生
#[derive(Debug, Serialize, Deserialize)]
struct Claims {
    sub: String,
    company: String,
    exp: usize,
}

声言

#[derive(Debug, Serialize, Deserialize)]
struct Claims {
    aud: String,         // 可选。听众
    exp: usize,          // 必须。(validate_exp 在验证中默认为真值)。截止时间 (UTC 时间戳)
    iat: usize,          // 可选。发布时间 (UTC 时间戳)
    iss: String,         // 可选。发布者
    nbf: usize,          // 可选。不早于 (UTC 时间戳)
    sub: String,         // 可选。标题 (令牌指向的人)
}

标头

let token = encode(&Header::default(), &my_claims, &EncodingKey::from_secret("secret".as_ref()))?;

自定义标头和更改算法

let mut header = Header::new(Algorithm::HS512);
header.kid = Some("blabla".to_owned());
let token = encode(&header, &my_claims, &EncodingKey::from_secret("secret".as_ref()))?;

编码

// HS256
let token = encode(&Header::default(), &my_claims, &EncodingKey::from_secret("secret".as_ref()))?;
// RSA
let token = encode(&Header::new(Algorithm::RS256), &my_claims, &EncodingKey::from_rsa_pem(include_bytes!("privkey.pem"))?)?;

• 一个标头: Header 结构型
• 某些声言: 你定义的结构型
• 一个key或secret

解码

// `token` 是一个有两个参数的结构型: `标头` 和 `声言` （`声言` 为你自己定义的结构型）
let token = decode::<Claims>(&token, &DecodingKey::from_secret("secret".as_ref()), &Validation::default())?;

• 令牌或它对应的签名是无效的
• 令牌是无效的base64字符串
• 至少有一个预定的声言验证失败

let header = decode_header(&token)?;

{
"kty":"RSA",
"e":"AQAB",
"kid":"6a7a119f-0876-4f7e-8d0f-bf3ea1391dd8",
"n":"yRE6rHuNR0QbHO3H3Kt2pOKGVhQqGZXInOduQNxXzuKlvQTLUTv4l4sggh5_CYYi_cvI-SXVT9kPWSKXxJXBXd_4LkvcPuUakBoAkfh-eiFVMh2VrUyWyj3MFl0HTVF9KwRXLAcwkREiS3npThHRyIxuy0ZMeZfxVL5arMhw1SRELB8HoGfG_AtH89BIE9jDBHZ9dLelK9a184zAf8LwoPLxvJb3Il5nncqPcSfKDDodMFBIMc4lQzDKL5gvmiXLXB1AGLm8KBjfE8s3L5xqi-yUod-j8MtvIj812dkS4QMiRVN_by2h3ZY8LYVGrqZXZTcgn2ujn8uKjXLZVD5TdQ"
}
// `token` 是一个有两个参数的结构型: `标头` 和 `声言` （`声言` 为你自己定义的结构型）
let token = decode::<Claims>(&token, &DecodingKey::from_rsa_components(jwk["n"], jwk["e"]), &Validation::new(Algorithm::RS256))?;

将 SEC1 私钥转换为 PKCS8

openssl pkcs8 -topk8 -nocrypt -in sec1.pem -out pkcs8.pem

验证

#[derive(Debug, Clone, PartialEq)]
struct Validation {
pub leeway: u64,                    // Default: 0
pub validate_exp: bool,             // Default: true
pub validate_nbf: bool,             // Default: false
pub aud: Option<HashSet<String>>,   // Default: None
pub iss: Option<String>,            // Default: None
pub sub: Option<String>,            // Default: None
pub algorithms: Vec<Algorithm>,     // Default: vec![Algorithm::HS256]
}
use jsonwebtoken::{Validation, Algorithm};

// 默认验证：唯一允许的算法是HS256
let validation = Validation::default();
// 快速设置验证的方法，只需更改算法即可
let validation = Validation::new(Algorithm::HS512);
// 为exp和nbf检查添加一些余地（以秒为单位）
let mut validation = Validation {leeway: 60, ..Default::default()};
// 检查发布者
let mut validation = Validation {iss: Some("issuer".to_string()), ..Default::default()};
// 设置听众
let mut validation = Validation::default();
validation.set_audience(&"Me"); // string
validation.set_audience(&["Me", "You"]); // array of strings