The original thomseddon/traefik-forward-auth is a "minimal forward authentication service that provides Google oauth based login and authentication for the traefik reverse proxy/load balancer."
This is a partial rewrite to support generic OIDC Providers that provide OpenID Provider Issuer Discovery but may not support the UserInfo endpoint.
noelcatt/traefik-forward-auth and funkypenguin/traefik-forward-auth also made thomseddon/traefik-forward-auth apply to generic OIDC, but they are now based on an older version which does not support rules and also require the UserInfo endpoint to be supported.
The instructions for thomseddon/traefik-forward-auth are useful, keeping in mind that this version:
- Does not support legacy configuration (
cookie-domains,cookie-secret,cookie-secure,prompt). - Does not support Google-specific configuration (
providers,providers.google.client-id,providers.google.client-secret,providers.google.prompt). - Does support
provider-uri,client-id,client-secretconfiguration. - Uses an OIDC Discovery endpoint to find authorization and token endpoints.
- Does not require the OIDC Provider to support the optional UserInfo endpoint.
- Returns 401 rather than redirect to OIDC Login if an unauthenticated request is not for HTML (e.g. AJAX calls, images).
- Sends a username cookie as well
- If
auth-hostis set andcookie-domainsis not set, traefik-forward-auth will redirect any requests using other hostnames toauth-host. Setauth-hostto the OIDC redirect host to ensure that use of the IP or other DNS names will be redirected and get a suitable cookie.