alcoholic_jwt

这是一个使用JWKS中的密钥进行JWT验证的库，仅此而已。

RS256是JWT中最常用的非对称签名机制，例如在Google或Aprila的API中。

库的名称来源于尝试使用其他为类似目的制作的Rust库可能产生的潜在副作用。

使用概述

您从某个使用RS256签名并提供公钥的JWKS格式的身份验证提供者处检索JWT。

以下是一个在kid声明中提供用于签名的密钥ID的令牌的示例

extern crate alcoholic_jwt;

use alcoholic_jwt::{JWKS, Validation, validate, token_kid};

// The function implied here would usually perform an HTTP-GET
// on the JWKS-URL for an authentication provider and deserialize
// the result into the `alcoholic_jwt::JWKS`-struct.
let jwks: JWKS = jwks_fetching_function();

let token: String = some_token_fetching_function();

// Several types of built-in validations are provided:
let validations = vec![
  Validation::Issuer("auth.test.aprila.no".into()),
  Validation::SubjectPresent,
];

// If a JWKS contains multiple keys, the correct KID first
// needs to be fetched from the token headers.
let kid = token_kid(&token)
    .expect("Failed to decode token headers")
    .expect("No 'kid' claim present in token");

let jwk = jwks.find(&kid).expect("Specified key not found in set");

validate(token, jwk, validations).expect("Token validation has failed!");

内部机制

这个库旨在仅使用可信的现成组件来完成工作。加密操作由openssl crate提供，JSON序列化由serde_json提供。

贡献

此项目在TVL单一代码库中开发。要工作于此，您可以使用整个存储库的本地克隆，或仅克隆alcoholic_jwt子树。

https://code.tvl.fyi/depot.git:/net/alcoholic_jwt.git

请遵循TVL贡献指南。