跳至內容

如何對 Application Load Balancer 中的驗證問題進行疑難排解?

3 分的閱讀內容
0

在 Application Load Balancer 中設定驗證時收到錯誤訊息。

解決方法

身分提供者 (IdP) 或 Application Load Balancer 的錯誤設定,可能會在設定 Application Load Balancer 的驗證時造成錯誤。若要對驗證錯誤進行疑難排解,請完成下列任務。

HTTP 400: Bad Request

redirect_mismatch

當 IdP 與 Application Load Balancer 之間的重新導向網址組態不相符時,redirect_mismatch 錯誤會導致 HTTP 400。

如果您使用 Amazon Cognito,請將回呼網址設定為 https://domain/oauth2/idpresponse。如果您使用不同的 IdP,請將重新導向 URI 設定為 https://domain/oauth2/idpresponse。

注意: 請將 domain 替換為用於存取 Application Load Balancer 的網域。

HTTP 401: Unauthorized

若要解決 "HTTP 401: Unauthorized" 錯誤,請完成下列任務:

組態問題

更新下列組態,使其在您的 Application Load Balancer 與 IdP 上相符:

  • 發行者
  • 授權端點
  • 權杖端點
  • 用戶端 ID/用戶端密碼

此外,請根據您的使用案例,將 Action on unauthenticated request 設定為 Allow、Authenticate (client reattempt) 或 Deny (傳回 401)。

驗證 Cookie 問題

如果您的存取日誌錯誤碼為 "AuthInvalidCookie",則表示驗證 Cookie 無效或格式錯誤。清除瀏覽器 Cookie 並重試驗證。請確保您的用戶端在工作流程期間傳送驗證 Cookie。

無效或遺漏驗證 nonce

如果您的存取日誌錯誤碼為 "AuthInvalidAWSALBAuthNonce" 或 "AuthMissingAWSALBAuthNonce",則表示驗證狀態中的 nonce 與瀏覽器 Cookie 不符。Cookie 可能不同或可能遺漏。請確保您的用戶端在工作流程期間傳送驗證 nonce Cookie。

無效或遺漏狀態參數

如果您的存取日誌錯誤碼為 "AuthInvalidStateParam" 或 "AuthMissingStateParam",則表示驗證回應中的狀態參數無效或遺漏。設定您的 IdP 以在驗證流程中傳回狀態參數。檢查狀態是否尚未過期。

遺漏授權碼

如果您的存取日誌錯誤碼為 "AuthMissingCodeParam",則表示 IdP 回呼回應中遺漏授權碼參數。設定您的 IdP 以使用「授權碼」授予類型傳回授權碼。檢查您的 IdP 日誌中的錯誤回應,例如 "Service not found" 或 "access_denied"。

無效 ID 權杖

如果您的存取日誌錯誤碼為 "AuthInvalidIdToken",則表示無法驗證來自 IdP 的 ID 權杖。確認 ID 權杖中的發行者是否與 Application Load Balancer 驗證設定中設定的發行者相符。檢查您的 Application Load Balancer 組態中的權杖端點網址、用戶端 ID 和權杖簽署演算法是否正確。

遺漏主機標頭

如果您的存取日誌錯誤碼為 "AuthMissingHostHeader",則表示來自授權端點的驗證回應遺漏主機標頭欄位。檢查您的 IdP 組態,以確保其在回應中包含主機標頭。

HTTP 500: Internal Server Error 錯誤

負載平衡器必須能夠與 IdP 權杖端點 (TokenEndpoint) 和 IdP 使用者資訊端點 (UserInfoEndpoint) 進行通訊。當負載平衡器與這些端點通訊時,Application Load Balancer 僅支援 IPv4。

若要解決 "HTTP 500: Internal Server Error" 的錯誤,請完成下列任務:

私人網域名稱問題

確認 IdP 端點 DNS 名稱是否可公開解析。驗證功能無法解析私有網域名稱。

傳出規則****問題

將傳出規則新增至負載平衡器安全群組,該群組允許透過 HTTPS 連接埠 443 傳輸至 IdP 端點的流量。

IdP 端點問題

確保負載平衡器子網路的存取控制清單 (ACL) 允許往返 IdP 端點的流量:

  • 針對輸出規則,您必須將指定目的地 IP (IdP 端點) 和目標 TCP 連接埠 443 設定為 Allow (允許)。
  • 針對輸入規則,您必須將來源 IP (IdP 端點) 和目標 TCP 連接埠範圍 1024-65535 設定為 Allow (允許)。
  • 設定負載平衡器子網路路由表以連接 IdP 端點:
    針對面向網際網路的負載平衡器,請設定網際網路閘道的預設路由來連接公用 IdP 端點。
    針對具有 dualstack-without-public-ipv4 IP 位址的內部負載平衡器或平衡器,請設定 NAT 閘道或執行個體預設路由來連接公用 IdP 端點。
    針對所有其他網路拓樸,您必須有足夠的端到端路由,才能連接 IdP 端點。

回應時間問題

確保 IdP 權杖或使用者資訊端點在 5 秒內回應。如果您的存取日誌錯誤碼為 "AuthTokenEpRequestTimeout" 或 "AuthUserinfoEpRequestTimeout",則負載平衡器會產生 HTTP 500 錯誤。請確認您的 IdP 端點是否可存取,且未發生延遲或連線逾時問題。使用 ELBAuthLatency 指標進行監視,以識別緩慢的 IdP 回應時間。

大小限制問題

請確認使用者宣告未超過大小限制。如果您的存取日誌錯誤碼為 "AuthUserinfoResponseSizeExceeded",則從 IdP 接收的使用者宣告可能過大。從 IdP 接收的使用者宣告大小必須為 11 KB 或更小。如果宣告超過此限制,請減少 ID 權杖或使用者資訊回應中包含的宣告數量。使用 ELBAuthUserClaimsSizeExceeded CloudWatch 指標進行監控。

無效權杖回應問題

請確保 IdP 未提供無效的權杖回應。如果您的存取日誌錯誤碼為 "AuthInvalidTokenResponse",則來自權杖端點的回應無效或格式錯誤。請確認您的 IdP 權杖端點是否傳回格式正確的 OAuth2 權杖回應。

授權碼問題

請確保 IdP 未提供無效或過期的授權碼。如果您的存取日誌錯誤碼為 "AuthInvalidGrantError",則來自 IdP 的授權碼已過期或遭到重複使用。請確保在過期前將該程式碼交換為權杖,且未遭到重複使用。請確認您的 IdP 是否設定為使用「授權碼」授予類型,這是 Application Load Balancer 唯一支援的 OAuth2 授予類型。

無效使用者資訊回應問題

如果您的存取日誌錯誤碼為 "AuthInvalidUserinfoResponse",則來自使用者資訊端點的回應無效或格式錯誤。它可能包含 NULL 或無效的查詢引數。請確認您的 IdP 使用者資訊端點是否根據 OpenID Connect 規格傳回格式正確的回應。

來自 IdP 端點的 HTTP 561: Unauthorized 錯誤

當 Application Load Balancer 從 IdP 端點收到錯誤回應時,就會發生 HTTP 561 錯誤。使用 ELBAuthError CloudWatch 指標監控此錯誤。

若要解決 HTTP 561 錯誤,請完成下列任務:

驗證 IdP 端點組態

  • 檢查 Application Load Balancer 接聽程式組態中的權杖端點網址與使用者資訊端點網址是否正確。
  • 確保用戶端 ID 與用戶端密碼有效,且與您的 IdP 組態相符。
  • 請確認用戶端密碼未過期,或在未更新負載平衡器組態的情況下遭到輪替。

檢查 IdP 端點可用性與回應

如果您的存取日誌錯誤碼為 "AuthTokenEpRequestFailed" 或 "AuthUserinfoEpRequestFailed",請確認您的 IdP 權杖端點與使用者資訊端點是否可存取。它們必須傳回 2XX 成功回應。檢閱您的 IdP 日誌中的錯誤訊息,例如 "invalid_client"、"invalid_request"、速率限制問題或服務中斷。

驗證權杖與範圍組態

確保授權碼尚未過期。檢查您是否已授予所需的範圍,包括 openid、email 或 profile。

確認 IdP 端點憑證是否與設定的主機名稱相符

如果您的存取日誌錯誤碼為 "AuthTokenEpRequestFailed" or "AuthUserinfoEpRequestFailed",則表示 IdP 端點所提供的憑證未包含設定的主機名稱。Application Load Balancer 會驗證設定的 IdP 端點網址中的主機名稱是否與憑證的主體別名 (SAN) 或通用名稱 (CN) 相符。如果 IdP 端點所提供的憑證未包含設定的主機名稱,負載平衡器將會拒絕連線。請確認您的 IdP 端點憑證在其 SAN 或 CN 中是否包含設定的主機名稱。或者,更新您的 Application Load Balancer 組態,以使用與現有憑證相符的主機名稱。

使用 CloudWatch 監控驗證

您可以使用下列 Amazon CloudWatch 指標來監控驗證效能與錯誤:

  • ELBAuthSuccess: 追蹤成功的驗證動作
  • ELBAuthFailure: 追蹤因憑證無效或存取遭拒而導致的驗證失敗 (HTTP 401 錯誤)
  • ELBAuthError: 追蹤因組態錯誤或 IdP 連線問題而導致的驗證錯誤 (HTTP 500/561 錯誤)
  • ELBAuthUserClaimsSizeExceeded: 追蹤使用者宣告超過 11 KB 的情況
  • ELBAuthLatency: 以毫秒為單位測量 IdP 回應時間
  • ELBAuthRefreshTokenSuccess: 追蹤成功的權杖重新整理作業

開啟存取日誌以擷取 error_reason 欄位,其中包含用於詳細疑難排解的特定錯誤碼。如需詳細資訊,請參閱 Access logs for your Application Load Balancer (Application Load Balancer 的存取日誌)。

其他 HTTP 錯誤代碼

若要對 Application Load Balancer 產生的其他 HTTP 錯誤碼進行疑難排解,請參閱 The load balancer generates an HTTP error (負載平衡器產生 HTTP 錯誤)。

相關資訊

Simplify login with Application Load Balancer built-in authentication (使用 Application Load Balancer 內建驗證簡化登入)

Authenticate users using an Application Load Balancer (使用 Application Load Balancer 來驗證使用者身分)

Application-specific settings with app clients (使用應用程式用戶端的應用程式特定設定)

AWS 官方已更新 6 個月前