👑 Nim lang bindings for LibJWT
JSON Web Token Library
nimble install webtokens
This package provides Nim bindings for LibJWT, a C library that supports the following standards JWS, JWE, JWK, JWA and JWTs. It allows you to create, sign, verify, and decode JSON Web Tokens in your Nim applications.
Note
👌 Low-level and high-level APIs are provided to work with JWTs, JWKs, and JWS/JWE tokens.
Check the official LibJWT installation guide
Here is a simple example demonstrating how to create and sign a JSON Web Token (JWT) using HMAC SHA-256 algorithm with the webtokens Nim package.
{.passL:"-L/opt/local/lib -ljwt", passC:"-I /opt/local/include".}
import std/[times, json]
import webtokens
# Generate a JWK Set with one random HMAC (oct) key
let jwksJson = generateJwkSet(1, 32)
let set = loadJwkSetFromJson($jwksJson)
let key = set.findByKid("hmac-key-0")
let alg = parseAlg("HS256")
# Initialize JWT Builder
var builder = newJwtBuilder()
builder.setKey(alg, key)
builder.setHeader("typ", "JWT")
builder.setHeader("kid", key.itemKid())
builder.setIss("example-app")
builder.setSub("user123")
builder.setExpIn(3600) # token expires in 1 hour
# Generate the token
let token = builder.generate()
echo "Generated JWT: ", token
# Now, you can use this token for authentication/authorization
var verifier = newJwtChecker()
verifier.setKey(alg, key)
verifier.setLeeway(JWT_CLAIM_EXP, 5) # small clock skew
if verifier.verify(token):
echo "Verified OK!"todo more examples
- 🐛 Found a bug? Create a new Issue
- 👋 Wanna help? Fork it!
- 😎 Get €20 in cloud credits from Hetzner
Made by Humans from OpenPeeps.
Copyright OpenPeeps & Contributors — All rights reserved.