Skip to main content
App mobile phát hành tới máy người dùng nên không giữ được bí mật: dùng client public với Authorization Code kèm PKCE S256, đăng nhập qua trình duyệt hệ thống và nhận kết quả qua custom scheme hoặc universal link. Trang này giải thích luồng đó và có mẫu cho Android, iOS và Flutter.

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

Mỗi nền tảng dùng một client riêng. Không dùng chung client của bản web.

App biết gọi Keycloak ở đâu?

Custom scheme chỉ dùng cho chiều Keycloak trả kết quả về app. Chiều app gọi Keycloak luôn đi bằng https tới issuer khai trong code. Từ issuer, thư viện tự tải discovery để lấy địa chỉ trang đăng nhập, token endpoint và logout endpoint.
1

App đọc discovery

App gọi https://<id-host>/realms/<realm>/.well-known/openid-configuration để lấy authorization_endpoint, token_endpoint, end_session_endpoint.
2

App mở trình duyệt hệ thống

Trình duyệt mở trang đăng nhập với client_id, redirect_uri=com.dbiz.<app>:/oauth2redirect, code_challenge và state. redirect_uri chỉ là địa chỉ trả về.
3

Người dùng đăng nhập

Người dùng nhập tài khoản trên trang của Keycloak, không phải trong app.
4

Hệ điều hành chuyển kết quả cho app

Keycloak chuyển trình duyệt tới com.dbiz.<app>:/oauth2redirect?code=...&state=.... Hệ điều hành thấy scheme đã được app đăng ký nên mở app và đưa URL cho app.
5

App đổi code lấy token

App gọi token endpoint bằng https, gửi code và code_verifier, nhận access token, id token và refresh token.
Khai scheme trong Info.plist (iOS) hay AndroidManifest / build.gradle (Android) không trỏ tới server nào. Nó chỉ báo hệ điều hành rằng URL bắt đầu bằng scheme đó thì mở app này. Keycloak không gọi thẳng vào app; nó chỉ chuyển hướng trình duyệt. Universal link (iOS) và App Link (Android) an toàn hơn custom scheme vì app khác không chiếm được. Đổi lại, cần một host công khai phục vụ /.well-known/apple-app-site-association và /.well-known/assetlinks.json.
Dùng trình duyệt hệ thống (ASWebAuthenticationSession trên iOS, Custom Tabs trên Android). Không dùng WebView nhúng để đăng nhập.

Mã mẫu

Khai scheme redirect cho từng nền tảng (viết thường, dạng reverse-domain):
android/app/build.gradle.kts
ios/Runner/Info.plist
lib/auth.dart
Nếu không muốn thư viện tự đọc discovery, truyền serviceConfiguration thay cho issuer:
lib/auth_static.dart
React Native dùng react-native-app-auth với các giá trị tương tự.

Lưu token an toàn

  • Lưu refresh token trong Keychain (iOS) hoặc Keystore / EncryptedSharedPreferences (Android). Flutter dùng flutter_secure_storage.
  • Giữ access token trong bộ nhớ.
  • Refresh token báo invalid_grant thì xoá token và cho người dùng đăng nhập lại.