Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用查詢參數和標頭

本頁說明如何使用 Identity-Aware Proxy (IAP) 查詢參數和標頭，強化應用程式 UI 或提供疑難排解選項。

查詢參數

在網址查詢字串中設定 gcp-iap-mode 參數，即可執行不同動作。這些查詢參數可與任何路徑一併加入，不限於根網址。

傳遞下列參數值會傳回包含使用者身分的 JSON 字典：

YOUR_APP_URL?gcp-iap-mode=IDENTITY

只要登入 Google 帳戶，即使該帳戶沒有應用程式存取權，也能使用這項功能。您可以直接前往該網址，也可以參考該網址向其提出要求。以下是網址傳回的值範例：

{"email":"accounts.google.com:USER_EMAIL","sub":"accounts.google.com:118133858486581853996"}

您可能會發現這個值可協助您個人化應用程式 (例如顯示使用者名稱)、將身分識別資訊傳送至其他頁面，或擷取記錄中的使用情況資料。

下列參數值會清除 IAP 登入 Cookie：

YOUR_APP_URL?gcp-iap-mode=CLEAR_LOGIN_COOKIE

傳遞這個參數會清除應用程式的所有 IAP 發行 Cookie，並將瀏覽器導覽至 YOUR_APP_URL。如果瀏覽器與應用程式的識別資訊提供者 (IdP) 之間有有效的工作階段，且 IdP 只使用一個帳戶，系統可能會進行無聲登入。如果使用多個帳戶，系統會開啟帳戶選取頁面，方便你切換設定檔。

IAP 可將無效的 JWT 傳遞至測試網頁，協助您測試 JWT 驗證邏輯。

舉例來說，如果任何要求包含查詢參數 gcp-iap-mode=SECURE_TOKEN_TEST 和 iap-secure-token-test-type=SIGNATURE，IAP 就會傳遞簽章無效的 JWT。驗證邏輯應會偵測到無效簽章。

您可以將適當的參數附加至要求，針對下列任一情境測試驗證邏輯。

參數	測試案例
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`NOT_SET`	有效的 JWT。
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`FUTURE_ISSUE`	核發日期設定於未來。
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`PAST_EXPIRATION`	到期日期設定於過去。
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`ISSUER`	不正確的核發單位。
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`AUDIENCE`	不正確的目標對象。
?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=`SIGNATURE`	使用錯誤的簽署者簽署。

當 IAP 產生 HTTP 回應時 (例如拒絕存取 (403) 或要求驗證 (302 或 401))，會新增 X-Goog-IAP-Generated-Response HTTP 回應標頭。藉由偵測此標頭是否存在，您即可：