2 releases
0.0.1-rc2 | Nov 15, 2023 |
---|---|
0.0.1-rc0 | Feb 16, 2023 |
#1203 in Cryptography
32KB
675 lines
BeNu
Simple & Compact Binary Credentials
Not Done |
---|
Fields
Name | Flag | Type | Description |
---|---|---|---|
TYP |
0x1 |
byte |
The type of the token (e.g. user or session) |
SUBJECT |
0x2 |
data |
The subject of the token |
INCREMENT |
0x4 |
int |
An increment for invalidating tokens |
BEFORE |
0x8 |
int |
When the token expires |
AFTER |
0x10 |
int |
When the token is valid from |
DATA |
0x20 |
data |
Defined token claims |
SALT |
0x40 |
data |
An pinch of extra salt (why not?) |
Usage
use std::time::Duration;
use crate::signed::SignedToken;
use crate::{Header, Token};
// define key
let key = [0u8; 32];
// build the token
let token = Token::builder()
.typ(0x01)
.subject("Sam")
.data("Hello World!")
.before(Duration::from_secs(300));
println!("{:?}", token);
// seal and sign the token with the key
let token = token
.seal()
.sign(key.as_ref());
println!("{:?} -> {:?}", token.len(), token);
// create a signed token
let token = SignedToken::decode(&token).unwrap()
// verify the token with the key
.verify(&key.as_ref()).unwrap()
// require typ, subject, data.
.require(Header::TYP | Header::SUBJECT | Header::DATA | Header::BEFORE).unwrap()
// check the token is of the given type
.match_typ(0x01).unwrap()
// validate before time
.validate().unwrap()
// unseal the token
.unseal();
// get the subject field
println!("{:?}", token.subject().unwrap().as_str());
Dependencies
~360–520KB
~11K SLoC