djpbessems/lucidAuth
1
1
Fork 0
Code Issues Pull Requests Releases 2 Wiki Activity
f7760ab568
lucidAuth/README.md

1.4 KiB
Raw Blame History

lucidAuth

Forward Authentication for use with proxies (caddy, nginx, traefik, etc)

Usage

  • Create a new folder, navigate to it in a commandprompt and run the following command: git clone https://code.spamasaurus.com/djpbessems/lucidAuth.git
  • Edit include/lucidAuth.config.php.example to reflect your configuration and save as include/lucidAuth.config.php
  • Create a new website (within any php-capable webserver) and make sure that the documentroot points to the public folder
  • Check if you are able to browse to https://<fqdn>/lucidAuth.login.php (where <fqdn> is the actual domain -or IP address- your webserver is listening on)
  • Edit your proxy's configuration to use the new website as forward proxy:

    • in Caddy/nginx (planned for a later stage)

    • in Traefik

    Add the following lines (change to reflect your existing configuration): 
    [frontends.server1]
  entrypoints = ["https"]
  backend = "server1"
  [frontends.server1.auth.forward]
    address = "https://<fqdn>/lucidAuth.validateRequest.php"
  [frontends.server1.routes]
    [frontends.server1.routes.ext]
      rule = "Host:<fqdn>"

Questions or bugs

Feel free to open issues in this repository.