Skip to main content
API chỉ nhận token do app khác gửi tới (resource server) không cần client riêng. API tự kiểm access token trên mỗi request bằng khoá công khai của Keycloak. Trang này liệt kê các điểm phải kiểm và mẫu cho Python và Spring Boot.

Các điểm phải kiểm

Mặc định access token của Keycloak chỉ có aud: account. Muốn kiểm aud, hãy yêu cầu client phát token có audience mapper trỏ tới tên API của bạn.
Nếu nhiều client cùng gọi một API (ví dụ bản web, mobile, desktop của cùng app), quy tắc dễ bảo trì là: chấp nhận khi aud chứa tên API, hoặc azp nằm trong danh sách được phép. Kiểm cứng một giá trị azp duy nhất sẽ chặn các bản còn lại.

Mẫu Python (PyJWT)

verify_token.py

Mẫu Spring Boot

application.yaml
Backend chạy cùng hạ tầng với Keycloak có thể tải JWKS qua địa chỉ nội bộ do đội vận hành cung cấp (jwk-set-uri), nhưng issuer-uri vẫn là địa chỉ công khai.

Phân biệt token người dùng và token máy

Token của service account có preferred_username dạng service-account-<client-id> và azp là client đó. Nếu API có thao tác chỉ dành cho người dùng thật, hãy kiểm điều này. Xem Service-to-service.