使用 AWS WAF 的服務連結角色 - AWS WAF、AWS Firewall Manager 與 AWS Shield Advanced

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 AWS WAF 的服務連結角色

AWS WAF 使用 AWS Identity and Access Management (IAM) 服務連結的角色。服務連結角色是直接連結至 AWS WAF 的一種特殊 IAM 角色類型。服務連結角色由 AWS WAF 預先定義,且內含該服務代您呼叫其他 AWS 服務所需的所有許可。

服務連結的角色可讓設定 AWS WAF 更為簡單,因為您不必手動新增必要的許可。AWS WAF​ 定義其服務連結角色的許可,除非另有定義,否則僅有 AWS WAF 可以擔任其角色。已定義的許可包括信任政策和許可政策。該許可政策無法連接至其他任何 IAM 實體。

您必須先刪除角色的相關資源,才能刪除服務連結角色。如此可保護您的 AWS WAF 資源,避免您不小心移除資源的存取許可。

如需關於支援服務連結角色的其他服務的資訊,請參閱可搭配 IAM 運作的 AWS 服務,尋找 Service-Linked Role (服務連結角色) 欄顯示為 Yes (是) 的服務。選擇具有連結的 Yes (是),以檢視該服務的服務連結角色文件。

AWS WAF 的服務連結角色許可

AWS WAF 使用服務連結角色 AWSServiceRoleForWAFV2Logging

AWS WAF會使用此服務連結角色將日誌寫入 Amazon Kinesis Data Firehose。只有當您在 AWS WAF 中啟用日誌時,才會使用此角色。如需更多詳細資訊,請參閱 記錄 Web ACL 流量資訊

AWSServiceRoleForWAFV2Logging 服務連結角色信任 wafv2.amazonaws.com 服務來擔任該角色。

角色的許可政策允許 AWS WAF 對指定資源完成下列動作:

  • 動作:firehose:PutRecordfirehose:PutRecordBatch的 Amazon Kinesis Data Firehose 資源上的資料流資源上的名稱開頭為「aws-waf-logs-」。例如,aws-waf-logs-us-east-2-analytics

您必須設定許可,IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊,請參閱 IAM 使用者指南中的服務連結角色許可

為 AWS WAF 建立服務連結角色

您不需要手動建立一個服務連結角色。當您在 AWS Management Console 上啟用 AWS WAF、在 AWS WAF CLI 或 AWS WAF API 中發出 PutLoggingConfiguration 請求,AWS WAF 會為您建立服務連結角色。

您必須擁有 iam:CreateServiceLinkedRole 許可才能啟用記錄。

若您刪除此服務連結角色,之後需要再次建立,您可以在帳戶中使用相同程序重新建立角色。當您啟用 AWS WAF 記錄時,AWS WAF 會為您再次建立服務連結角色。

為 AWS WAF 編輯服務連結角色

AWS WAF 不允許您編輯 AWSServiceRoleForWAFV2Logging 服務連結角色。因為可能有各種實體會參考服務連結角色,所以您無法在建立角色之後變更其名稱。然而,您可使用 IAM 來編輯角色描述。如需更多資訊,請參閱 IAM 使用者指南中的編輯服務連結角色

為 AWS WAF 刪除服務連結角色

若您不再使用需要服務連結角色的功能或服務,我們建議您刪除該角色。如此一來,您就沒有未主動監控或維護的未使用實體。然而,在手動刪除服務連結角色之前,您必須先清除資源。

注意

若 AWS WAF 服務在您試圖刪除資源時正在使用該角色,刪除可能會失敗。若此情況發生,請等待數分鐘後並再次嘗試操作。

刪除 AWSServiceRoleForWAFV2Logging 所使用的 AWS WAF 資源

  1. 在 AWS WAF 主控台上,從每個 Web ACL 移除記錄。如需更多詳細資訊,請參閱 記錄 Web ACL 流量資訊

  2. 使用 API 或 CLI,為每個 Web ACL 提交 DeleteLoggingConfiguration 請求啟用記錄功能。如需詳細資訊,請參閱 AWS WAF API 參考

使用 IAM 手動刪除服務連結角色

使用 IAM 主控台、IAM CLI 或 IAM API 刪除AWSServiceRoleForWAFV2Logging服務連結角色。如需詳細資訊,請參閱 IAM 使用者指南中的刪除服務連結角色

AWS WAF 服務連結角色的支援區域

AWS WAF在下列項目支援使用服務連結角色AWS 區域。

區域名稱 區域身分 在 AWS WAF 中支援
美國東部 (維吉尼亞北部) us-east-1
US East (Ohio) us-east-2
美國西部 (加利佛尼亞北部) us-west-1
美國西部 (奧勒岡) us-west-2
Asia Pacific (Mumbai) ap-south-1
Asia Pacific (Osaka) ap-northeast-3
Asia Pacific (Seoul) ap-northeast-2
亞太區域 (新加坡) ap-southeast-1
亞太區域 (雪梨) ap-southeast-2
亞太區域 (東京) ap-northeast-1
Canada (Central) ca-central-1
Europe (Frankfurt) eu-central-1
歐洲 (愛爾蘭) eu-west-1
Europe (London) eu-west-2
Europe (Paris) eu-west-3
南美洲 (聖保羅) sa-east-1