Skip to content

Latest commit

 

History

History
executable file
·
24 lines (15 loc) · 1.22 KB

README.md

File metadata and controls

executable file
·
24 lines (15 loc) · 1.22 KB

xo-server-auth-trustedheader

HTTP Trusted Header authentication plugin for XO-Server

Usage

If your XO instance is proxied behind a TLS-enabled web server, this plugin can be used to authenticate users based on an HTTP header. The first time a user signs in, XO will create a new user with the passed identifier as the username.

This plugin is based on passport-trusted-header. More information can be found in its README but usually no further configuration is necessary

Like all other xo-server plugins, it can be configured directly via the web interface, see the plugin documentation.

Security

The connection between your proxy web server and web app must be secure. The front-end web server must whitelist HTTP headers to send to the web app, and it must be impossible for external processes to reach the web app or interfere with connections between the web server and Node.js.

This authentication method is completely insecure if these conditions are not met!

License

AGPL-3.0-or-later