@cappern/node-red-dashboard-2-oauth2-auth

@cappern/node-red-dashboard-2-oauth2-auth

A Node-RED Dashboard 2 plugin that integrates with oauth2-proxy.
It extracts user information from the HTTP headers added by oauth2-proxy and makes them available inside Dashboard flows via msg._client.user.

🚀 Features

• Automatically attaches user info to msg._client.user
• Supports common oauth2-proxy headers:
  • x-auth-request-user, x-forwarded-user
  • x-auth-request-email, x-forwarded-email
  • x-auth-request-preferred-username
• Adds socketId and socketIp to help trace individual client sessions
• Prevents unauthenticated users from interacting with flows (configurable in hook onIsValidConnection)

📦 Installation

From your Node-RED user directory (e.g. ~/.node-red or /data inside Docker):

npm install @cappern/node-red-dashboard-2-oauth2-auth

Restart Node-RED after installation.

🔧 Usage

• Run Node-RED Dashboard 2 behind oauth2-proxy
  (for example with Traefik, Nginx, or another reverse proxy).
• Ensure oauth2-proxy is configured to forward user headers (e.g. --set-xauthrequest).
• Open Dashboard → Sidebar → Client Data.
  You should see OAuth2 Proxy listed as a client data provider.
• In your flows, you can now access user info:

{
  "_client": {
    "user": {
      "userId": "jdoe",
      "email": "[e-mail]",
      "username": "jdoe"
    },
    "socketId": "s0meid",
    "socketIp": "192.168.1.100"
  }
}

📜 License

This project is licensed under the AGPL-3.0-or-later.

🤝 Contributing

Pull requests and issues are welcome!
Check out the issues page.