oauth2-proxy/contrib/local-environment
Stefan Markmann ec4adb4aa9
docs(nginx): Clarify auth_request redirect pattern with named location
Update the nginx integration documentation to recommend using a named location
(@oauth2_signin) for the error_page directive instead of the previous
'error_page 401 =403' approach.

The named location pattern ensures the browser receives a proper 302 redirect,
which is required for --skip-provider-button=true to work correctly.

The previous pattern (error_page 401 =403 /oauth2/sign_in) returned a 403
status with a Location header. Browsers do not auto-follow redirects on 403
responses, causing users to see a 'Found.' link instead of being automatically
redirected to the IdP.

Changes:
- Updated main nginx example to use @oauth2_signin named location
- Added 'Understanding the error_page redirect pattern' section
- Added warning about the limitations of 'error_page 401 =403'
- Updated local test environment (contrib/local-environment/nginx.conf)

Refs: #334
Signed-off-by: Stefan Markmann <stefan@markmann.net>
2026-01-18 00:48:41 +01:00
..
keycloak chore(examples): update keycloak to v25 (#2706) 2024-07-18 23:57:15 +02:00
kubernetes chore(deps): update helmv3 (#3189) 2025-10-28 07:53:12 +01:00
traefik Add example local environment with traefik (#1091) 2021-03-22 13:55:25 +00:00
Makefile fix gitea token validation by allowing custom validation url and extracting the proper base api url for github cloud, github enterprise and gitea (#2194) 2023-09-14 10:09:57 +01:00
README.md Fix and enhance OIDC example (#934) 2020-12-19 15:48:33 +00:00
dex.yaml Fix local-environment ports (#3136) 2025-07-20 20:32:50 +02:00
docker-compose-alpha-config.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
docker-compose-gitea.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
docker-compose-keycloak.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
docker-compose-nginx.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
docker-compose-traefik.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
docker-compose.yaml update to release version v7.14.1 2026-01-17 15:08:04 +00:00
nginx.conf docs(nginx): Clarify auth_request redirect pattern with named location 2026-01-18 00:48:41 +01:00
oauth2-proxy-alpha-config.cfg fix alpha config example 2025-11-16 22:38:26 +01:00
oauth2-proxy-alpha-config.yaml fix test setup and add local image build make target 2025-11-16 22:38:46 +01:00
oauth2-proxy-gitea.cfg fix gitea token validation by allowing custom validation url and extracting the proper base api url for github cloud, github enterprise and gitea (#2194) 2023-09-14 10:09:57 +01:00
oauth2-proxy-keycloak.cfg Fix local-environment ports (#3136) 2025-07-20 20:32:50 +02:00
oauth2-proxy-nginx.cfg Fix local-environment ports (#3136) 2025-07-20 20:32:50 +02:00
oauth2-proxy-traefik.cfg Fix local-environment ports (#3136) 2025-07-20 20:32:50 +02:00
oauth2-proxy.cfg Fix local-environment ports (#3136) 2025-07-20 20:32:50 +02:00

README.md

oauth2-proxy: local-environment

Run make up to deploy local dex, etcd and oauth2-proxy instances in Docker containers. Review the Makefile for additional deployment options.