create-express-auth-middleware

Library to easily create Express JS authentication and authorization middlewares using predicate functions.

Installation

1npm install create-express-auth-middleware

Example

View samples folder for more specific examples

1. Make a API call from client, and include an Authorization header, e.g.

   Authorization: Bearer <your-client-token>
   

2. Create Express app with predicate based authentication and authorization middlewares

   1const app = require("express")();
   2const { create_authn_middleware, create_authz_middleware } = require("create-express-auth-middleware");
   3
   4// Make all routes in this express app to be authentication protected.
   5// Meaning all routes defined later can only be called if the request passes this predicate function
   6// This DOES NOT mean that routes are fully protected yet,
   7// as you need to ensure users have sufficient permission to access APIs using authorization middleware.
   8app.use(create_authn_middleware((req) => req.get("Authorization") === "some_JWT_Value"));
   9
   10// The actual route that requires both authentication and authorization to run.
   11app.get(
   12    "/data/:userID",
   13
   14    // Add authorization middleware to ensure users can only access their own data
   15    // Uses an imaginary decodeJWT function
   16    // Checks that the specified userID in the URL matches user's own userID value in their token.
   17    create_authz_middleware((req) => decodeJWT(req.get("Authorization")).userID === req.params.userID),
   18
   19    // Uses an imaginary rate limiting function
   20    // If the function fails, the error object is returned,
   21    // The object can contain 'status' to override the error status code,
   22    // and can have a 'error' string to override the default error message
   23    create_authz_middleware((req) => isNotRateLimited(req) || { status: 429, error: "Too many requests" }),
   24
   25    // This request handler will only run if both predicate above returns true!
   26    (req, res) => res.status(200).json({ data: "Protected user data" })
   27);

3. If authentication failed, you get a 401 code with the following response by default

   1{ "ok": false, "error": "Authentication Failed" }

4. If authorization failed, you get a 403 code with the following response by default

   1{ "ok": false, "error": "Authorization Failed" }

The only difference between authentication middlewares and authorization middlewares is their error HTTP status codes and their default error responses as shown above.

Using with Auth providers

Instead of building your own authentication and authorization backend, you can use auth providers like Firebase Auth, Okta, Auth0 to provide auth services and just use this library to create authentication and authorization middlewares built on top of their API.

Integrations available

• Firebase Auth

License and Author

This project is made available under MIT LICENSE and written by JJ