jwt-utils
v1.0.5
Published
JSON Web Tokens (JWT) utils
Downloads
240
Readme
jwt-utils
JSON Web Tokens (JWT) utils.
This module is able to parse and generate both encrypted and unencrypted JWT tokens.
- A hash key (
hashKey
) is needed to generate a JWT signature. - An encryption key (
encryptKey
) is needed only if you need to deal with encrypted JWT tokens.
This module only allows hexadecimal strings as hash and encryption keys. The encryption key must be
a 32-length hexadecimal value (16 bytes) if the encryption algorithm is A128CBC
.
The kid
(key identifier) goes in the JWT header, and serves as a client identifier, in case you need
to use different keys for different clients.
Installation
npm install jwt-utils
Examples
var config = { expiration: 600};
var jwt = require('jwt-utils')(config);
// Encode JWT token
jwt.buildJWT(payload, header, hashKey, function(err, token) {
if (!err) {
console.log(token); // something in the format "aaa.bbb.ccc"
}
});
// Decode JWT token
jwt.readJWT(token, hashKey, function(err, token) {
if (!err) {
console.log(token.payload);
console.log(token.header);
}
});
// Encrypt JWT token
jwt.buildJWTEncrypted(payload, header, encryptKey, hashKey, function(err, token) {
if (!err) {
console.log(token); // something in the format "aaa.bbb.ccc.ddd.eee"
}
});
// Decrypt JWT token
jwt.readJWTEncrypted(token, encryptKey, hashKey, function(err, token) {
if (!err) {
console.log(token.payload);
console.log(token.header);
}
});
// Read JWT header
jwt.readJWTHeader(token, function(err, header) {
if (!err) {
console.log(header);
}
});
Configuration
- expiration: Expiration time in seconds to generate exp field in token (this functionality can be disabled by setting the value to 0).
- futureTolerance: Tolerance seconds to find out if a jwt comes from the future or not.
Development information
npm test
Errors:
The following file has registered the error of this library: errors.json
License
Copyright 2015 Telefónica Investigación y Desarrollo, S.A.U
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.