firebase-token-verifier

Firebase JWT verifier, implements Verify ID tokens using a third-party JWT library. Use as a lightweight alternative to the Firebase Admin SDK if all you need to do is verify or validate a Firebase JWT.

Install

npm install --save firebase-token-verifier

Usage

firebase-token-verifier can be used with Promises, async, or callbacks.

validate() is just a wrapper around verify() that also checks the project ID (audience/issuer), and optionally the user ID (subject).

1const verifier = require('firebase-token-verifier');
2const token = 'eyJhb...';

Promise

verify

1verifier.verify(token)
2.then((verified) => {
3  console.log('Verified!');
4  console.log(JSON.stringify(verified, null, 2));
5})
6.catch((err) => {
7  console.log('Error!');
8  console.log(err);
9});

validate

1// userId is optional
2// verifier.validate(token, projectId)
3verifier.validate(token, projectId, userId)
4.then((validated) => {
5  console.log('Validated');
6  console.log(JSON.stringify(validated, null, 2));
7})
8.catch((err) => {
9  console.log('Error!');
10  console.log(err);
11})

async

verify

1try {
2  let verified = await verifier.verify(token);
3  console.log('Verified!');
4  console.log(JSON.stringify(verified, null, 2));
5} catch(err) {
6  console.log('Error!');
7  console.log(err);
8}

validate

1try {
2  // userId is optional
3  // verifier.validate(token, projectId)
4  let validated = await verifier.validate(token, projectId, userId);
5  console.log('Validated!');
6  console.log(JSON.stringify(validated, null, 2));
7} catch(err) {
8  console.log('Error!');
9  console.log(err);
10}

callback

verify

1verifier.verify(token, (err, verified) => {
2  if(err) {
3    console.log('Error!');
4    console.log(err);
5  } else {
6    console.log('Verified!');
7    console.log(JSON.stringify(verified, null, 2));
8  }
9})

validate

1// userId is optional
2// verifier.validate(token, projectId, callback)
3verifier.validate(token, projectId, userId, (err, validated) => {
4  if(err) {
5    console.log('Error!');
6    console.log(err);
7  } else {
8    console.log('Validated!');
9    console.log(JSON.stringify(validated, null, 2));
10  }
11})

Examples

Please see demo.sh and demo/*.js.

$ sh demo.sh