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ằnghttps 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.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.
Mã mẫu
- Flutter
- Android (AppAuth)
- iOS (AppAuth)
Khai scheme redirect cho từng nền tảng (viết thường, dạng reverse-domain):Nếu không muốn thư viện tự đọc discovery, truyền
android/app/build.gradle.kts
ios/Runner/Info.plist
lib/auth.dart
serviceConfiguration thay cho issuer:lib/auth_static.dart
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_grantthì xoá token và cho người dùng đăng nhập lại.