View a markdown version of this page

稽核調查結果抑制 - AWS IoT Device Defender
稽核調查結果抑制的運作方式如何在主控台中使用稽核調查結果抑制如何在 CLI 中使用稽核調查結果抑制稽核調查結果抑制 API

稽核調查結果抑制

當您執行稽核時，它會報告所有不合規資源的調查結果。這表示您的稽核報告會包含您正在其中努力緩解問題之資源的調查結果，也包含已知不合規之資源 (例如測試或損毀的裝置)的調查結果。稽核會繼續報告在連續稽核執行中保持不合規之資源的調查結果，這可能會將不需要的資訊新增至您的報告。稽核調查結果抑制可讓您在定義的時段內抑制或篩選出調查結果，直到資源完成修正，或若為與測試或損毀裝置相關聯的資源，則為無限期。

注意

緩解動作不適用於抑制的稽核調查結果。如需緩解動作的詳細資訊，請參閱 緩解動作。

如需稽核調查結果抑制配額的詳細資訊，請參閱 AWS IoT Device Defender 端點和配額。

稽核調查結果抑制的運作方式

當您針對不合規資源建立稽核搜尋結果抑制時，稽核報告與通知會有不同的行為。

您的稽核報告將包含一個新區段，其中列出與報告相關聯的所有已抑制調查結果。評估稽核檢查是否合規時，不會考慮抑制的調查結果。在命令列界面 (CLI) 中使用 describe-audit-task 命令時，也會針對每個稽核檢查傳回抑制的資源計數。

若為稽核通知，評估稽核檢查是否合規時，不會考慮抑制的調查結果。在 AWS IoT Device Defender 發佈至 Amazon CloudWatch 和 Amazon Simple Notification Service (Amazon SNS) 的每個稽核檢查通知中，也會包含抑制的資源計數。

如何在主控台中使用稽核調查結果抑制

抑制稽核報告中的調查結果

下列程序顯示如何在 AWS IoT 主控台中建立稽核調查結果抑制。

  1. 在 AWS IoT 主控台的導覽窗格中，展開 Defend (防禦)，然後選擇 Audit (稽核)、Results (結果)。

  2. 選取您要檢閱的稽核報告。

    AWS IoT Device Defender 稽核結果表，當中顯示近期有最多稽核標示為不合規之多項稽核的合規狀態。

  3. 在 Non-compliant checks (不合規檢查) 區段中，於 Check name (檢查名稱) 下，選擇您有興趣的稽核檢查。

    稽核報告，當中顯示有一項記錄已停用的不合規檢查，以及針對 AWS 服務的重大、高和中嚴重程度進行的 13 項合規檢查。

  4. 在稽核檢查詳細資訊畫面上，如果有您不想看到的調查結果，請選取調查結果旁邊的選項按鈕。接下來，選擇 Actions (動作)，然後選擇您想要稽核調查結果抑制持續存在的時間量。

    注意

    在主控台，您可以選取 1 週、1 個月、3 個月、6 個月或無限期，做為稽核調查結果抑制的過期日。如果您想要設定特定的過期日期，您只能在 CLI 或 API 中執行此操作。您也可以隨時取消稽核調查結果抑制，不論過期日期為何。

    AWS IoT Device Defender 稽核問題清單，當中顯示記錄已停用和 1 個不合規的帳戶，且包含詳細資訊和緩解措施。

  5. 確認抑制詳細資訊，然後選擇 Enable suppression (啟用抑制)。

    確認抑制對話方塊，當中包含記錄已停用檢查名稱、帳戶設定號碼、3 個月到期期限，以及 2020-10-28 到期日。

  6. 在建立了稽核調查結果抑制之後，會出現一個橫幅，確認已建立稽核調查結果抑制。

    AWS IoT Device Defender 稽核問題清單頁面，當中顯示一個記錄已停用的不合規帳戶，且包含啟用 CloudWatch Logs 的緩解步驟。
在稽核報告中檢視您的抑制調查結果

  1. 在 AWS IoT 主控台的導覽窗格中，展開 Defend (防禦)，然後選擇 Audit (稽核)、Results (結果)。

  2. 選取您要檢閱的稽核報告。

  3. 在 Suppressed findings (抑制的調查結果) 區段中，檢視已針對您所選稽核報告抑制哪些稽核調查結果。

    AWS IoT Device Defender 稽核報告，當中顯示包含嚴重程度和問題清單摘要的合規檢查。
列出您的稽核調查結果抑制

  • 在 AWS IoT 主控台的導覽窗格中，展開 Defend (防禦)，然後選擇 Audit (稽核)、Finding suppressions (調查結果抑制)。

    AWS IoT Device Defender 稽核問題清單抑制表，當中包含於 2020 年 10 月 28 日到期的「記錄已停用」檢查單一抑制項目。
編輯您的稽核調查結果抑制

  1. 在 AWS IoT 主控台的導覽窗格中，展開 Defend (防禦)，然後選擇 Audit (稽核)、Finding suppressions (調查結果抑制)。

  2. 選取您要編輯之稽核調查結果抑制旁邊的選項按鈕。接下來，選擇 Actions (動作)、Edit (編輯)。

  3. 在 Edit audit finding suppression (編輯稽核調查結果抑制) 視窗上，您可以變更 Suppression duration (抑制持續時間) 或 Description (optional) (描述 (選用))。

    編輯稽核問題清單抑制對話方塊，當中包含抑制指定資源的「記錄已停用」檢查為期 6 個月以及說明欄位的選項。

  4. 完成變更後，請選擇 Save (儲存)。Finding suppressions (調查結果抑制) 視窗隨即開啟。

刪除稽核調查結果抑制

  1. 在 AWS IoT 主控台的導覽窗格中，展開 Defend (防禦)，然後選擇 Audit (稽核)、Finding suppressions (調查結果抑制)。

  2. 選取您想要刪除之稽核調查結果抑制旁邊的選項按鈕，然後選擇 Actions (動作)、Delete (刪除)。

  3. 在 Delete audit finding suppression (刪除稽核調查結果抑制) 視窗中，於文字方塊中輸入 delete 以確認您的刪除，然後選擇 Delete (刪除)。Finding suppressions (調查結果抑制) 視窗隨即開啟。

    此對話方塊用於刪除具有可輸入「刪除」的輸入欄位和「刪除」按鈕的稽核問題清單抑制。

如何在 CLI 中使用稽核調查結果抑制

您可以使用以下 CLI 命令來建立和管理稽核調查結果抑制。

您輸入的 resource-identifier 取決於您正在抑制其調查結果的 check-name。下表詳細詳述哪些檢查需要哪個 resource-identifier 用於建立和編輯抑制。

注意

抑制命令不會指示關閉稽核。稽核仍會在您的 AWS IoT 裝置上執行。抑制僅適用於稽核調查結果。

check-name resource-identifier
AUTHENTICATE_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK cognitoIdentityPoolId
CA_CERT_APPROACHING_EXPIRATION_CHECK caCertificateId
CA_CERTIFICATE_KEY_QUALITY_CHECK caCertificateId
CONFLICTING_CLIENT_IDS_CHECK clientId
DEVICE_CERT_APPROACHING_EXPIRATION_CHECK deviceCertificateId
DEVICE_CERTIFICATE_KEY_QUALITY_CHECK deviceCertificateId
DEVICE_CERTIFICATE_SHARED_CHECK deviceCertificateId
IOT_POLICY_OVERLY_PERMISSIVE_CHECK policyVersionIdentifier
IOT_ROLE_ALIAS_ALLOWS_ACCESS_TO_UNUSED_SERVICES_CHECK roleAliasArn
IOT_ROLE_ALIAS_OVERLY_PERMISSIVE_CHECK roleAliasArn
LOGGING_DISABLED_CHECK account
REVOKED_CA_CERT_CHECK caCertificateId
REVOKED_DEVICE_CERT_CHECK deviceCertificateId
UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK cognitoIdentityPoolId
建立並套用稽核調查結果抑制

下列程序顯示如何在 AWS CLI 中建立稽核調查結果抑制。

  • 使用 create-audit-suppression 命令來建立稽核調查結果抑制。下列範例會根據檢查 Logging disabled (記錄已停用) 為 AWS 帳戶 123456789012 建立稽核調查結果抑制。

    aws iot create-audit-suppression \
    --check-name LOGGING_DISABLED_CHECK \
    --resource-identifier account=123456789012 \
    --client-request-token 28ac32c3-384c-487a-a368-c7bbd481f554 \
    --suppress-indefinitely \
    --description "Suppresses logging disabled check because I don't want to enable logging for now."

    此命令沒有輸出。

稽核調查結果抑制 API

以下 CLI 命令可以用來建立和管理稽核調查結果抑制。

若要篩選特定的稽核調查結果，您可以使用 ListAuditFindings API。