npmpackage.info

Gathering detailed insights and metrics for express-jwt-authz

Other packages similar to express-jwt-authz

express-jwt

8.5.1

JWT authentication middleware.

@aserto/aserto-node

0.33.7

Aserto Node SDK

express-jwt-decode

1.0.1

JWT decoding middleware.

@667/express-jwt-authz

2.4.1-1

Validate a JWTs scope to authorize access to an endpoint

Gathering detailed insights and metrics for express-jwt-authz

express-jwt-authz - 2.4.1 | npmpackage.info

express-jwt-authz

Validate the JWT scope to authorize access to an endpoint

2.4.1

MIT

JavaScript

7.57 kB

4.7

Installations

npm install express-jwt-authz

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=6

Node Version

13.10.1

NPM Version

6.13.7 Pull Requests

Open

1

Total

35

Closed

13

Merged

21

Issues

Open

3

Total

19

Closed

16

Releases

v2.4.1

Updated on Jul 21, 2020

v2.4.0

Updated on Jun 12, 2020

View All 2 releases

Languages

JavaScript

JavaScript (100%)

Developer

auth0

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

99 Stars

61 Commits

39 Forks

80 Watchers

4 Branches

41 Contributors

Updated on Jun 23, 2025

Maintainers

View All 41 Contributors

Package Meta Information

Latest Version

2.4.1

Package Id

express-jwt-authz@2.4.1

Unpacked Size

7.57 kB

Size

3.26 kB

File Count

NPM Version

6.13.7

Node Version

13.10.1

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

express @types/express

Dev Dependencies

chai husky mocha prettier pretty-quick

express-jwt-authz

Validate a JWTs scope to authorize access to an endpoint.

Install

$ npm install express-jwt-authz

express@^4.0.0 is a peer dependency. Make sure it is installed in your project.

Usage

Use together with express-jwt to both validate a JWT and make sure it has the correct permissions to call an endpoint.

1var jwt = require('express-jwt');
2var jwtAuthz = require('express-jwt-authz');
3
4var options = {};
5app.get('/users',
6  jwt({ secret: 'shared_secret' }),
7  jwtAuthz([ 'read:users' ], options),
8  function(req, res) { ... });

If multiple scopes are provided, the user must have at least one of the specified scopes.

1app.post('/users',
2  jwt({ secret: 'shared_secret' }),
3  jwtAuthz([ 'read:users', 'write:users' ], {}),
4  function(req, res) { ... });
5
6// This user will be granted access
7var authorizedUser = {
8  scope: 'read:users'
9};

To check that the user has all the scopes provided, use the checkAllScopes: true option:

1app.post('/users',
2  jwt({ secret: 'shared_secret' }),
3  jwtAuthz([ 'read:users', 'write:users' ], { checkAllScopes: true }),
4  function(req, res) { ... });
5
6// This user will have access
7var authorizedUser = {
8  scope: 'read:users write:users'
9};
10
11// This user will NOT have access
12var unauthorizedUser = {
13  scope: 'read:users'
14};

The JWT must have a scope claim and it must either be a string of space-separated permissions or an array of strings. For example:

// String:
"write:users read:users"

// Array:
["write:users", "read:users"]

Options

failWithError: When set to true, will forward errors to next instead of ending the response directly. Defaults to false.
checkAllScopes: When set to true, all the expected scopes will be checked against the user's scopes. Defaults to false.
customUserKey: The property name to check for the scope key. By default, permissions are checked against req.user, but you can change it to be req.myCustomUserKey with this option. Defaults to user.
customScopeKey: The property name to check for the actual scope. By default, permissions are checked against user.scope, but you can change it to be user.myCustomScopeKey with this option. Defaults to scope.

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

Author

Auth0

License

This project is licensed under the MIT license. See the LICENSE file for more info.

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

10

Security-Policy

Determines if the project has published a security policy.

9

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

6

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

2

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

SAST

Determines if the project uses static code analysis.

Score

4.7

/10

Last Scanned on 2025-07-14

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More