Skip to main content
Web có backend giữ được bí mật phía máy chủ, nên dùng client confidential có client secret. App không tự làm đăng nhập thì có thể đặt sau oauth2-proxy. Trang này gồm cấu hình client và mẫu cho oauth2-proxy, Next.js Auth.js và Spring Boot.

Cấu hình cần cung cấp cho client

Client secret đọc từ kho secret của nền tảng qua biến môi trường. Không đưa secret vào mã nguồn hay image. App đọc biến môi trường lúc khởi động, nên sau khi xoay secret phải khởi động lại app.

Mẫu oauth2-proxy

oauth2-proxy
Muốn phân quyền theo group thay vì organization: đặt --oidc-groups-claim=groups và --allowed-group=/nhom-cha/NHOM_CON (đường dẫn đầy đủ). --backend-logout-url giúp nút đăng xuất của proxy (/oauth2/sign_out) kết thúc luôn phiên Keycloak. Xem Đăng xuất.
oauth2-proxy đọc discovery ngay lúc khởi động. Issuer sai hoặc Keycloak chưa sẵn sàng thì proxy thoát và app phía sau ngừng phục vụ.

Mẫu Next.js Auth.js

.env

Mẫu Spring Boot

application.yaml

Backend chạy cùng hạ tầng với Keycloak

Nếu đội vận hành cung cấp địa chỉ nội bộ của Keycloak, backend có thể tải discovery và JWKS qua địa chỉ đó để không vòng ra Internet. Issuer vẫn khai là địa chỉ công khai https://<id-host>/realms/<realm>; chỉ đổi URL tải metadata.