行動端 App 整合第三方登入 (Google、Facebook、GitHub、自家 OAuth Server) 時,推薦使用 OAuth 2.0 Implicit Grant (隱式授權) 流程:在 WebView 載入授權頁,使用者登入授權後,授權伺服器將 access_token 直接以 URL Fragment (#access_token=...) 形式重導向至 redirect_uri,App 攔截該 URL 解析 Token,無需客戶端密鑰 (client_secret),安全性較適合無後端保護能力的行動端原生 App。
App (WebView) Authorization Server Resource Server
| | |
|--- GET /authorize?response_type=token&client_id=...&redirect_uri=myapp://oauth2redirect&scope=...&state=xyz --->|
| | |
|<-- 用戶登入/授權頁面 --| |
| | |
|<-- 302 Redirect: myapp://oauth2redirect#access_token=xxx&token_type=Bearer&expires_in=3600&state=xyz ---|
| | |
|--- 攔截 URL、解析 Fragment 取得 access_token --->|
| | |
|--- Authorization: Bearer xxx --->| (呼叫 API) |
| | |
|<-- API 回應資料 -------| |
shouldOverrideUrlLoading 中識別 myapp://oauth2redirect,解析 Fragment 參數。state 參數防止 CSRF 攻擊。access_token、expires_in、refresh_token (若有)。public class OAuthWebViewActivity extends AppCompatActivity {
private static final String AUTH_URL = "https://auth.example.com/oauth/authorize";
private static final String CLIENT_ID = "your_client_id";
private static final String REDIRECT_URI = "myapp://oauth2redirect"; // 需在後台註冊
private static final String SCOPE = "profile email";
private static final String STATE = UUID.randomUUID().toString(); // 防 CSRF
private WebView webView;
private TextView tvProgress;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_oauth_webview);
webView = findViewById(R.id.webview);
tvProgress = findViewById(R.id.tv_progress);
setupWebView();
loadAuthPage();
}
private void setupWebView() {
WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true);
settings.setDomStorageEnabled(true);
settings.setDatabaseEnabled(true);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
settings.setMixedContentMode(WebSettings.MIXED_CONTENT_ALWAYS_ALLOW);
}
webView.setWebViewClient(new WebViewClient() {
@Override
public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
String url = request.getUrl().toString();
return handleRedirectUrl(url);
}
@Override // API 23 以下相容
public boolean shouldOverrideUrlLoading(WebView view, String url) {
return handleRedirectUrl(url);
}
@Override
public void onPageStarted(WebView view, String url, Bitmap favicon) {
tvProgress.setText("載入中...");
}
@Override
public void onPageFinished(WebView view, String url) {
tvProgress.setVisibility(View.GONE);
}
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
Toast.makeText(OAuthWebViewActivity.this, "載入失敗: " + error.getDescription(), Toast.LENGTH_LONG).show();
finish();
}
});
}
private void loadAuthPage() {
String url = AUTH_URL + "?" +
"response_type=token" +
"&client_id=" + URLEncoder.encode(CLIENT_ID, "UTF-8") +
"&redirect_uri=" + URLEncoder.encode(REDIRECT_URI, "UTF-8") +
"&scope=" + URLEncoder.encode(SCOPE, "UTF-8") +
"&state=" + STATE;
webView.loadUrl(url);
}
private boolean handleRedirectUrl(String url) {
// 檢查是否為我們的 redirect_uri
if (url.startsWith(REDIRECT_URI)) {
// 解析 Fragment 部分 (#access_token=xxx&...)
Uri uri = Uri.parse(url);
String fragment = uri.getFragment(); // 取得 # 後內容
if (fragment != null) {
// 解析鍵值對
Map params = parseFragment(fragment);
String receivedState = params.get("state");
if (!STATE.equals(receivedState)) {
Toast.makeText(this, "State 不匹配,可能遭 CSRF 攻擊", Toast.LENGTH_LONG).show();
finish();
return true;
}
String accessToken = params.get("access_token");
String tokenType = params.get("token_type");
String expiresIn = params.get("expires_in");
String refreshToken = params.get("refresh_token"); // Implicit Grant 通常不回傳 refresh_token
if (!TextUtils.isEmpty(accessToken)) {
// 成功!儲存 Token 並通知呼叫者
saveToken(accessToken, tokenType, expiresIn, refreshToken);
setResult(RESULT_OK, new Intent().putExtra("access_token", accessToken));
finish();
} else {
String error = params.get("error");
String errorDesc = params.get("error_description");
Toast.makeText(this, "授權失敗: " + error + " - " + errorDesc, Toast.LENGTH_LONG).show();
finish();
}
}
return true; // 我們已處理,WebView 不再載入
}
return false; // 非我們的 Scheme,讓 WebView 正常載入
}
private Map parseFragment(String fragment) {
Map map = new HashMap<>();
for (String pair : fragment.split("&")) {
String[] kv = pair.split("=", 2);
if (kv.length == 2) {
map.put(kv[0], URLDecoder.decode(kv[1], "UTF-8"));
}
}
return map;
}
private void saveToken(String accessToken, String tokenType, String expiresIn, String refreshToken) {
// 加密儲存至 EncryptedSharedPreferences 或 Room + SQLCipher
// 並計算過期時間點: System.currentTimeMillis() + Long.parseLong(expiresIn) * 1000
}
@Override
protected void onDestroy() {
super.onDestroy();
if (webView != null) {
webView.loadUrl("about:blank");
webView.clearHistory();
webView.clearCache(true);
webView.destroy();
}
}
}
<activity
android:name=".OAuthWebViewActivity"
android:launchMode="singleTask"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="myapp" android:host="oauth2redirect" />
</intent-filter>
</activity>
state 參數防 CSRF。redirect_uri 使用自定義 Scheme (myapp://) 而非 https://,避免被其他 App 攔截。client_secret 絕不 放入客戶端代碼 (Implicit Grant 不需 client_secret)。WebViewClient.shouldOverrideUrlLoading 白名單。client_secret 於客戶端 → 反編譯即洩漏。Google / Facebook / GitHub 等大型身分提供者已逐步淘汰 Implicit Grant,推薦使用 Authorization Code Grant + PKCE。本文方案適用於自建 OAuth Server 或仍支援 Implicit Grant 的舊版提供者。新專案請優先實作 PKCE 流程 (可參考 AppAuth 庫)。