萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android WebView 實現 OAuth 2.0 Implicit Grant 授權流程完整指南

行動端 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 回應資料 -------|                            |

Android 實作關鍵點

  1. WebView 設定: 啟用 JavaScript、Dom Storage、允許混合內容 (API 21+)。
  2. 自定義 Scheme 攔截: 在 shouldOverrideUrlLoading 中識別 myapp://oauth2redirect,解析 Fragment 參數。
  3. 狀態驗證: 比對 state 參數防止 CSRF 攻擊。
  4. Token 儲存: 加密儲存 access_token、expires_in、refresh_token (若有)。
  5. 清理 WebView: 授權完成後銷毀 WebView,避免洩漏 Cookie/快取。

完整程式碼實作

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();
        }
    }
}

AndroidManifest 設定

<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)。
  • ✅ Token 加密儲存 (EncryptedSharedPreferences / SQLCipher / Keystore)。
  • ✅ Token 過期自動刷新 (若有 Refresh Token) 或重新授權。
  • ✅ WebView 僅載入授權頁域名,可設定 WebViewClient.shouldOverrideUrlLoading 白名單。

為什麼不建議在行動端用 Authorization Code Grant?

  • 需儲存 client_secret 於客戶端 → 反編譯即洩漏。
  • 需後端協助換 Token (或客戶端直接呼叫 Token Endpoint 暴露 secret)。
  • PKCE (Proof Key for Code Exchange) 雖可緩解,但實作複雜度高,Implicit Grant 對於純行動端無後端場景更簡潔。
Google / Facebook / GitHub 等大型身分提供者已逐步淘汰 Implicit Grant,推薦使用 Authorization Code Grant + PKCE。本文方案適用於自建 OAuth Server 或仍支援 Implicit Grant 的舊版提供者。新專案請優先實作 PKCE 流程 (可參考 AppAuth 庫)。
copyright © 萬盛學電腦網 all rights reserved