{"id":28462,"library":"wedeploy-middleware","title":"WeDeploy Auth Middleware","description":"Express middleware for authenticating requests using WeDeploy Auth service. Supports multiple authentication methods including Basic Auth, OAuth2 bearer tokens (header, query string, cookie). Version 3.2.0 is the latest stable release. Integrates with WeDeploy platform for federated identity providers. Requires Node.js >= 7.6.0. Note: WeDeploy service is deprecated; use only for legacy systems.","status":"deprecated","version":"3.2.0","language":"javascript","source_language":"en","source_url":"https://github.com/wedeploy/wedeploy-middleware","tags":["javascript","auth","express","wedeploy","middleware"],"install":[{"cmd":"npm install wedeploy-middleware","lang":"bash","label":"npm"},{"cmd":"yarn add wedeploy-middleware","lang":"bash","label":"yarn"},{"cmd":"pnpm add wedeploy-middleware","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Middleware designed for Express framework","package":"express","optional":false}],"imports":[{"note":"Package uses CommonJS; no default ES module export available.","wrong":"import wedeployMiddleware from 'wedeploy-middleware';","symbol":"default","correct":"const wedeployMiddleware = require('wedeploy-middleware');"},{"note":"Destructuring works in CommonJS but not ES imports as no named exports.","wrong":"import { auth } from 'wedeploy-middleware';","symbol":"auth","correct":"const { auth } = require('wedeploy-middleware');"},{"note":"auth is a method on the default exported object.","wrong":null,"symbol":"wedeployMiddleware.auth","correct":"const wedeployMiddleware = require('wedeploy-middleware'); wedeployMiddleware.auth(options);"}],"quickstart":{"code":"const express = require('express');\nconst wedeployMiddleware = require('wedeploy-middleware');\n\nconst app = express();\nconst authUrl = process.env.AUTH_URL ?? 'auth.project.wedeploy.io';\n\napp.use(wedeployMiddleware.auth({ url: authUrl }));\n\napp.get('/private', (req, res) => {\n  res.json({ user: res.locals.auth.currentUser });\n});\n\napp.listen(3000);","lang":"javascript","description":"Sets up Express app with WeDeploy auth middleware, protecting a private route."},"warnings":[{"fix":"Migrate to a different authentication middleware like passport.js.","message":"WeDeploy service is deprecated. This middleware will not work with new projects.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Use app.use(middleware) to apply globally.","message":"Auth middleware does not run on unmatched routes; must be applied per route or globally.","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Set 'unauthorizedOnly' only on routes where no user should be logged in.","message":"The option 'unauthorizedOnly' may prevent access to routes intended for unauthenticated users.","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use require() instead of import.","cause":"Using ES module import syntax with CommonJS package.","error":"TypeError: wedeployMiddleware.auth is not a function"},{"fix":"Run: npm install wedeploy-middleware","cause":"Package not installed or missing from node_modules.","error":"Cannot find module 'wedeploy-middleware'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}