Skip to main content
App desktop mở được trình duyệt nên dùng Authorization Code kèm PKCE và nhận kết quả ở một cổng loopback trên 127.0.0.1 (RFC 8252). CLI hoặc thiết bị không có trình duyệt dùng Device Authorization Grant: người dùng đăng nhập trên một máy khác bằng mã ngắn.

Desktop: redirect về loopback

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

Khai một lần http://127.0.0.1/* thì Keycloak nhận mọi cổng (RFC 8252 mục 7.3), ví dụ http://127.0.0.1:53682/callback hay http://127.0.0.1:49152/.
Dùng 127.0.0.1, không dùng localhost. Khi client chỉ khai http://127.0.0.1/*, redirect về http://localhost:<cong> bị từ chối với lỗi Invalid parameter: redirect_uri.

Luồng

1

Mở cổng loopback

App mở một cổng ngẫu nhiên trên 127.0.0.1.
2

Mở trình duyệt

App mở trình duyệt hệ thống tới trang đăng nhập với redirect_uri=http://127.0.0.1:<cong>/callback và code_challenge.
3

Nhận code

Sau khi người dùng đăng nhập, trình duyệt quay về cổng đó kèm code.
4

Đổi code lấy token

App gửi code và code_verifier tới token endpoint, nhận token rồi đóng cổng.
desktop_login.py

CLI: Device Authorization Grant

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

Client dùng device grant cần thêm một bước chuẩn bị phía nền tảng. Báo trước khi gửi yêu cầu.
device-login.sh