hunt-jwt 0.2.0-beta.4
A D implementation of JSON Web Tokens
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
<a href="https://code.dlang.org/packages/jwt" title="Go to jwt"><img src="https://img.shields.io/dub/v/jwt.svg" alt="Dub version"></a>
JWT
A Simple D implementation of JSON Web Tokens. It's forked from https://github.com/zolamk/jwt.
Supported Algorithms
- none
- HS256
- HS384
- HS512
- RS256
- RS384
- RS512
- ES256
- ES384
- ES512
This library uses semantic versioning 2.0.0
What's New
- added support for
arrays
andobjects
in claims - removed
verify
function that doesn't take algorithm type, see why here - changed
verify
function to take an array of algorithms to support multiple algorithms - renamed
InvalidSignature
toInvalidSignatureException
How To Use
Encoding
import jwt.jwt;
import jwt.algorithms;
import std.json;
void main() {
JSONValue user = ["id": JSONValue(60119), "uri": JSONValue("https://api.we.are/60119")];
JwtToken token = new JwtToken(JwtAlgorithm.HS512);
token.claims.exp = Clock.currTime.toUnixTime();
token.claims.set("user", user);
token.claims.set("data", [JSONValue("zm"), JSONValue(58718)]);
string encodedToken = token.encode("supersecret");
// work with the encoded token
}
Verifying
import jwt.jwt;
import jwt.exceptions;
import jwt.algorithms;
void main() {
// get encoded token from header or ...
try {
JwtToken token = JwtToken.verify(encodedToken, "supersecret");
writeln(token.claims.getInt("id"));
JSONValue user = token.claims.getObject("user");
JSONValue[] a = token.claims.getArray("data");
long userID = user["id"].integer();
string uri = user["uri"].str();
writeln(userID);
writeln(uri);
writeln(a[0].str());
writeln(a[1].integer());
} catch (InvalidAlgorithmException e) {
writeln("token has an invalid algorithm");
} catch (InvalidSignatureException e) {
writeln("This token has been tampered with");
} catch (NotBeforeException e) {
writeln("Token is not valid yet");
} catch (ExpiredException e) {
writeln("Token has expired");
}
}
Encoding without signature
import jwt.jwt;
import jwt.algorithms;
void main() {
JwtToken token = new JwtToken(JwtAlgorithm.NONE);
token.claims.exp = Clock.currTime.toUnixTime();
token.claims.set("id", 60119);
string encodedToken = token.encode();
// work with the encoded token
}
Verifying without signature
import jwt.jwt;
import jwt.exceptions;
import jwt.algorithms;
void main() {
// get encoded token from header or ...
try {
JwtToken token = JwtToken.verify(encodedToken);
writeln(token.claims.getInt("id"));
} catch (NotBeforeException e) {
writeln("Token is not valid yet");
} catch (ExpiredException e) {
writeln("Token has expired");
}
}
Limitations
- ##### Since Phobos doesn't(hopefully yet) support RSA algorithms this library only provides HMAC signing.
Note
- 0.2.0-beta.4 released 3 years ago
- huntlabs/hunt-jwt
- MIT
- Copyright © 2021, HuntLabs
- Authors:
- Dependencies:
- hunt-openssl
- Versions:
-
0.2.0-beta.4 2021-Apr-26 0.2.0-beta.3 2021-Apr-26 0.2.0-beta.2 2021-Mar-04 0.2.0-beta.1 2020-Nov-23 0.1.0-beta.2 2020-Jul-23 - Download Stats:
-
-
1 downloads today
-
5 downloads this week
-
12 downloads this month
-
2303 downloads total
-
- Score:
- 0.7
- Short URL:
- hunt-jwt.dub.pm