

# 監査の所見の抑制
<a name="audit-finding-suppressions"></a>

監査を実行すると、すべての不適合リソースの所見が報告されます。つまり、監査レポートには、問題の緩和に取り組んでいるリソースの所見と、テストやデバイスの破損など、不適合であることがわかっているリソースの所見が含まれます。監査では、後続の監査実行で不適合のままであるリソースに関する所見が引き続きレポートされるため、レポートに不要な情報が追加される可能性があります。監査所見を抑制すると、指定した期間、リソースが修正されるまでの期間、またはテストもしくは破損したデバイスに関連付けられたリソースに対して、無期限に所見を抑制または除外できます。

**注記**  
抑制された監査所見に対しては、緩和アクションは使用できません。緩和アクションの詳細については、[緩和アクション](dd-mitigation-actions.md) を参照してください。

監査所見の抑制クォータの詳細については、「[AWS IoT Device Defender のエンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/iot_device_defender.html)」を参照してください。

## 監査所見の抑制の仕組み
<a name="how-suppressions-work"></a>

不適合のリソース用に監査所見の抑制を作成すると、監査レポートと通知の動作が異なります。

監査レポートには、レポートに関連する、抑制されたすべての所見を一覧表示する新しいセクションが含まれます。監査チェックが適合であるかどうかを評価する場合、抑制された所見は考慮されません。コマンドラインインターフェイス (CLI) で [describe-audit-task](https://docs.aws.amazon.com/cli/latest/reference/iot/describe-audit-task.html) コマンドを使用すると、各監査チェックの抑制されたリソース数も返されます。

監査通知では、監査チェックが適合であるかどうかを評価する場合、抑制された所見は考慮されません。抑制されたリソース数は、AWS IoT Device Defender が Amazon CloudWatch および Amazon Simple Notification Service (Amazon SNS) に発行する、各監査チェック通知にも含まれます。

## コンソールで監査所見の抑制を使用する方法
<a name="audit-finding-suppressions-console"></a>

**監査レポートからの所見を抑制するには**

次の手順は、AWS IoT コンソールで監査所見の抑制を作成する方法を示しています。

1. [AWS IoT コンソール](https://console.aws.amazon.com/iot)のナビゲーションペインで、[**Defend**] (防御) を展開し、[**Audit**] (監査)、[**Results**] (結果) の順に選択します。

1. 確認する監査レポートを選択します。  
![最近の複数の監査のコンプライアンスステータスを表示している AWS IoT Device Defender 監査結果テーブル。ほとんどの監査は非準拠とマークされている。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/audit-results.png)

1. **[非準拠のチェック]** セクションの **[チェック名]** で、関心のある監査チェックを選択します。  
![AWS サービスのログ記録が無効になっている 1 件の非準拠チェックと、重大度レベルが重大、高、中の 13 件の準拠チェックを示す監査レポート。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/audit-results-details.png)

1. 監査チェックの詳細画面で、表示したくない所見がある場合は、所見の横にあるオプションボタンを選択します。次に、**[アクション]** を選択し、監査結果を継続する期間を選択します。
**注記**  
コンソールでは、監査所見の抑制の有効期限として、*[1 週間]*、*[1 か月]*、*[3 か月]*、*[6 か月]*、または *[無期限]* を選択できます。特定の有効期限を設定する場合は、CLI または API でのみ設定できます。監査所見の抑制は、有効期限にかかわらず、いつでも取り消すこともできます。  
![ログ記録が無効になっており、非準拠アカウントが 1 件あることを示す、詳細と緩和アクションを含む AWS IoT Device Defender 監査所見。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/non-compliant-check.png)

1. 抑制の詳細を確認してから、**[抑制を有効化]** を選択します。  
![ログ記録が無効になっているチェック名、アカウント設定番号、3 か月の有効期限、2020 年 10 月 28 日の有効期限を含む [抑制を確認] ダイアログ。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/confirm-suppression.png)

1. 監査所見の抑制を作成すると、監査所見の抑制が作成されたことを確認するバナーが表示されます。  
![ログ記録が無効になっている 1 つの非準拠アカウントと、CloudWatch Logs を有効にする緩和ステップを示す AWS IoT Device Defender 監査所見ページ。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/suppression-created-successfully.png)

**抑制された所見を監査レポートで表示するには**

1. [AWS IoT コンソール](https://console.aws.amazon.com/iot)のナビゲーションペインで、[**Defend**] (防御) を展開し、[**Audit**] (監査)、[**Results**] (結果) の順に選択します。

1. 確認する監査レポートを選択します。

1. **[抑制された結果]** セクションで、選択した監査レポート用に抑制された監査結果を表示します。  
![コンプライアンスチェックを示す AWS IoT Device Defender 監査レポート。重要度レベルと検出結果の概要を含む。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/audit-report-findings.png)

**監査所見の抑制をリスト化するには**
+ [AWS IoT コンソール](https://console.aws.amazon.com/iot)のナビゲーションペインで、[**Defend**] (防御) を展開し、[**Audit**] (監査)、[**Finding suppressions**] (所見の抑制) の順に選択します。  
![2020 年 10 月 28 日に期限切れになる「ログ記録が無効」チェックの単一の抑制を含む AWS IoT Device Defender 監査所見抑制テーブル。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/list-suppressions.png)

**監査所見の抑制を編集するには**

1. [AWS IoT コンソール](https://console.aws.amazon.com/iot)のナビゲーションペインで、[**Defend**] (防御) を展開し、[**Audit**] (監査)、[**Finding suppressions**] (所見の抑制) の順に選択します。

1. 編集する監査所見の抑制の横にあるオプションボタンを選択します。次に、**[アクション]**、**[編集]** の順に選択します。

1. **[監査結果の抑制を編集する]** ウィンドウで、**[抑制期間]** または **[説明] (オプション)** を変更できます。  
![指定したリソースの「ログ記録が無効」チェックを 6 か月間抑制するオプションと説明フィールドを含む、[監査結果の抑制を編集する] ダイアログ。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/edit-suppression.png)

1. 変更を行ったら、**[保存]** を選択します。**[検索結果の抑制]** ウィンドウが開きます。

**監査所見の抑制を削除するには**

1. [AWS IoT コンソール](https://console.aws.amazon.com/iot)のナビゲーションペインで、[**Defend**] (防御) を展開し、[**Audit**] (監査)、[**Finding suppressions**] (所見の抑制) の順に選択します。

1. 削除する監査所見の抑制の横にあるオプションボタンを選択し、[**Actions**] (アクション)、[**Delete**] (削除) の順に選択します。

1. **[Delete audit finding suppression]** (監査所見の抑制の削除) ウィンドウで、テキストボックスに `delete` と入力して削除を確認し、**[Delete]** (削除) を選択します。**[検索結果の抑制]** ウィンドウが開きます。  
![「削除」と入力するための入力フィールドと [削除] ボタン含む、監査所見の抑制の削除ダイアログボックス。](http://docs.aws.amazon.com/ja_jp/iot-device-defender/latest/devguide/images/delete-suppression.png)

## CLI での監査所見の抑制の使用方法
<a name="audit-finding-suppressions-cli"></a>

次の CLI コマンドを使用して、監査所見の抑制を作成および管理できます。
+ [create-audit-suppression](https://docs.aws.amazon.com/cli/latest/reference/iot/create-audit-suppression.html)
+ [describe-audit-suppression](https://docs.aws.amazon.com/cli/latest/reference/iot/describe-audit-suppression.html)
+ [update-audit-suppression](https://docs.aws.amazon.com/cli/latest/reference/iot/update-audit-suppression.html)
+ [delete-audit-suppression](https://docs.aws.amazon.com/cli/latest/reference/iot/delete-audit-suppression.html)
+ [list-audit-suppressions](https://docs.aws.amazon.com/cli/latest/reference/iot/list-audit-suppressions.html)

入力する `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
<a name="audit-finding-suppressions-apis"></a>

次の API を使用して、監査所見の抑制を作成および管理できます。
+ [CreateAuditSuppression](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateAuditSuppression.html)
+ [DescribeAuditSuppression](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeAuditSuppression.html)
+ [UpdateAuditSuppression](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateAuditSuppression.html)
+ [DeleteAuditSuppression](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteAuditSuppression.html)
+ [ListAuditSuppressions](https://docs.aws.amazon.com/iot/latest/apireference/API_ListAuditSuppressions.html)

特定の監査*の*所見をフィルタリングするには、[ListAuditFindings](https://docs.aws.amazon.com/iot/latest/apireference/API_ListAuditFindings.html) API を使用できます。