JSON Web Token (JWT) #

A dart implementation of the famous javascript library jsonwebtoken.

JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties.

https://jwt.io allows you to decode, verify and generate JWT.

Usage #

Import #

import 'package:dart_jsonwebtoken/dart_jsonwebtoken.dart';

Creating & signing a JWT #

// Create a json web token
// Pass the payload to be sent in the form of a map
final jwt = JWT(

  // Payload
  {
    'id': 123,

    'server': {
      'id': '3e4fc296',
      'loc': 'euw-2',
    }

  },

  issuer: 'https://github.com/jonasroussel/dart_jsonwebtoken',

);

// Sign it (default with HS256 algorithm)
token = jwt.sign(SecretKey('secret passphrase'));

print('Signed token: $token\n');

Check if the JWT made is correct. #

try {
  // Verify a token
  final jwt = JWT.verify(token, SecretKey('secret passphrase'));

  print('Payload: ${jwt.payload}');

} on JWTExpiredError {

  print('jwt expired');

} on JWTError catch (ex) {

  print(ex.message); // ex: invalid signature

}

You can also, decode the token without checking its signature #

final jwt = JWT.decode(token);

print('Payload: ${jwt.payload}');

Supported Algorithms #