翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Macie の検出結果へのフィルターの作成と適用

特定の特性を持つ検出結果を特定して焦点を合わせるには、Amazon Macie コンソールと Amazon Macie を使用してプログラムで送信するクエリで検出結果をフィルタリングできますAPI。フィルターを作成するときは、調査結果の特定の属性を使用して、ビューまたはクエリ結果から結果を含めるか除外するための基準を定義できます。検出結果属性は、重要度、タイプ、検出結果が適用されるリソースの名前など、検出結果の特定のデータを保存するフィールドです。

Macie では、フィルターは 1 つ以上の条件で設定されます。各条件は、基準とも呼ばれ、3 つの部分で設定されています。

フィルター条件を定義して適用する方法は、Amazon Macie コンソールを使用するかAmazon Macie を使用するかによって異なりますAPI。

Amazon Macie コンソールを使用した検出結果のフィルタリング

Amazon Macie コンソールを使用して調査結果をフィルタリングする場合、Macie は個別の条件のフィールド、演算子、値を選択するのに役立つオプションを提供します。これらのオプションにアクセスするには、次の画像に示すように、調査結果ページのフィルターバーを使用します。

[検出結果のステータス]メニューを使用して、抑制ルールによって抑制 (自動的にアーカイブ) された結果を含めるかどうかを指定できます。[フィルター条件]ボックスを使用すると、フィルター条件を入力できます。

フィルター条件ボックスにカーソルを置くと、Macie はフィルター条件で使用できるフィールドのリストを表示します。フィールドは論理カテゴリ別に整理されています。たとえば、一般的なフィールドカテゴリには、任意のタイプの調査結果に適用されるフィールドが含まれ、分類フィールドカテゴリには、機密データの調査結果にのみ適用されるフィールドが含まれます。フィールドは、各カテゴリ内でアルファベット順に並べ替えられます。

条件を追加するには、まずリストからフィールドを選択します。フィールドを見つけるには、完全なリストを参照するか、フィールド名の一部を入力してフィールドのリストを絞り込みます。

選択したフィールドに応じて、Macie は異なるオプションを表示します。オプションには、選択したフィールドのタイプと性質が反映されます。たとえば、重要度フィールドを選択した場合、Macie は選択する値のリストを表示します (低、中、および高)。S3 バケット名フィールドを選択した場合、Macie は、バケット名を入力できるテキストボックスを表示します。どのフィールドを選択しても、Macie はフィールドに必要な設定を含む条件を追加するステップを順を追ってガイドします。

条件を追加すると、次の図に示すように、Macie はその条件の基準を適用し、フィルター条件ボックスのフィルタートークンに条件を追加します。

この例では、中程度の重要度および高い重要度の調査結果をすべて含め、低い重要度の調査結果をすべて除外するように条件が設定されています。これは、重要度フィールドの値 と等しい 中 または 高の場合に調査結果を返します。

条件を追加すると、Macie はその基準を適用し、それらをフィルター条件ボックスのトークンに追加します。フィルターボックスをいつでも参照して、適用した基準を確認できます。条件を削除するには、条件のトークンで 条件の削除アイコン を選択します。

Amazon Macie によるプログラムによる検出結果のフィルタリング API

プログラムで結果をフィルタリングするには、Amazon Macie の ListFindingsまたは GetFindingStatisticsオペレーションを使用して送信するクエリでフィルター条件を指定しますAPI。ListFindings オペレーションは、検出結果 の配列を返します。これはIDs、フィルター条件に一致する検出結果ごとに 1 つの ID です。GetFindingStatistics オペレーションは、リクエストで指定したフィールド別にグループ化された、フィルター基準を満たすすべての調査結果に関する集計統計データを返します。

以下の点に注意してください。ListFindings および GetFindingStatistics オペレーションは、結果を抑制するために使用するオペレーションとは異なることに注意してください フィルター基準も指定する抑制オペレーションとは異なり、ListFindings および GetFindingStatistics オペレーションは、調査結果データのみをクエリします。それらは、フィルター基準と一致する検出結果に対するアクションは実行しません。検出結果を抑制するには、Amazon Macie の CreateFindingsFilterオペレーションを使用しますAPI。

クエリでフィルター基準を指定するには、リクエストにフィルター基準のマップを含めます。条件ごとに、フィールド、演算子、およびフィールドの 1 つ以上の値を指定します。値のタイプと数は、選択するフィールドと演算子によって異なります。条件で使用できるフィールド、演算子、および値のタイプについては、Macie の検出結果をフィルタリングするためのフィールド、条件での演算子の使用、およびフィールドの値を指定するを参照してください。

次の例は、AWS Command Line InterfaceAWS CLI を使用して送信するクエリでフィルター基準を指定する方法を示しています。これを行うには、別の AWS コマンドラインツールまたは AWS の最新バージョンを使用するかSDK、Macie に直接HTTPSリクエストを送信します。 AWS ツールと の詳細についてはSDKs、「 で構築するツール AWS」を参照してください。

この例では list-findings コマンドを使用します。例が正常に実行されると、Macie は findingIds 配列を返します。配列には、次の例に示すように、フィルター基準を満たす各調査結果の一意の識別子がリスト化されます。

{
    "findingIds": [
        "1f1c2d74db5d8caa76859ec52example",
        "6cfa9ac820dd6d55cad30d851example",
        "702a6fd8750e567d1a3a63138example",
        "826e94e2a820312f9f964cf60example",
        "274511c3fdcd87010a19a3a42example"
    ]
}

フィルター基準を満たす調査結果がない場合、Macie は空の findingIds 配列を返します。

{
    "findingIds": []
}

例 1: 重要度に基づいて調査結果をフィルタリングする

この例では、list-findings コマンドを使用して、現在の の重要度の高い検出結果と中程度の検出結果IDsをすべて取得します AWS リージョン。

Linux、macOS、Unix の場合:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"severity.description":{"eq":["High","Medium"]}}}'

Microsoft Windows の場合:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"severity.description\":{\"eq\":[\"High\",\"Medium\"]}}}

コードの説明は以下のとおりです。

例 2: 機密データのカテゴリに基づいて調査結果をフィルタリングする

この例では、list-findings コマンドを使用して、現在のリージョンにあるIDsすべての機密データの検出結果を取得し、S3 オブジェクト内の財務情報 (および他のカテゴリの機密データなし) の発生を報告します。

Linux、macOS、または Unix の場合、読みやすさを向上させるためにバックスラッシュ (\) の行連結文字を使用します。

$ aws macie2 list-findings \
--finding-criteria '{"criterion":{"classificationDetails.result.sensitiveData.category":{"eqExactMatch":["FINANCIAL_INFORMATION"]}}}'

Microsoft Windows の場合、読みやすさを向上させるためにキャレット (^) の行連結文字を使用します。

C:\> aws macie2 list-findings ^
--finding-criteria={\"criterion\":{\"classificationDetails.result.sensitiveData.category\":{\"eqExactMatch\":[\"FINANCIAL_INFORMATION\"]}}}

ここで、

例 3: 固定時間範囲に基づいて結果をフィルタリングする

この例では、list-findings コマンドを使用して、現在のリージョンにあり、2020 年 10 UTC月 5 日 07:00 から 2020 年 UTC11 月 5 日 07:00 の間に作成されたIDsすべての検出結果 ( を含む) の結果を取得します。

Linux、macOS、Unix の場合:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"createdAt":{"gte":1601881200000,"lte":1604559600000}}}'

Microsoft Windows の場合:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"createdAt\":{\"gte\":1601881200000,\"lte\":1604559600000}}}

コードの説明は以下のとおりです。

例 4: 抑制ステータスに基づいて調査結果をフィルタリングする

この例では、list-findings コマンドを使用して、現在のリージョンにあり、抑制ルールによって抑制 (自動アーカイブ) されたIDsすべての検出結果の結果を取得します。

Linux、macOS、Unix の場合:

$ aws macie2 list-findings --finding-criteria '{"criterion":{"archived":{"eq":["true"]}}}'

Microsoft Windows の場合:

C:\> aws macie2 list-findings --finding-criteria={\"criterion\":{\"archived\":{\"eq\":[\"true\"]}}}

コードの説明は以下のとおりです。

例 5: 複数のフィールドと値のタイプに基づいて調査結果をフィルタリングする

この例では、list-findings コマンドを使用して、現在のリージョンにあり、次の基準に一致するIDsすべての機密データの検出結果を取得します。2020 年 10 UTC月 5 日 07:00 から 2020 年 11 月 5 UTC日 07:00 の間に作成された (排他的）、S3 オブジェクトに財務データの発生と他のカテゴリの機密データは報告されなかった、抑制ルールによって抑制 (自動アーカイブ) されませんでした。

Linux、macOS、または Unix の場合、読みやすさを向上させるためにバックスラッシュ (\) の行連結文字を使用します。

$ aws macie2 list-findings \
--finding-criteria '{"criterion":{"createdAt":{"gt":1601881200000,"lt":1604559600000},"classificationDetails.result.sensitiveData.category":{"eqExactMatch":["FINANCIAL_INFORMATION"]},"archived":{"eq":["false"]}}}'

Microsoft Windows の場合、読みやすさを向上させるためにキャレット (^) の行連結文字を使用します。

C:\> aws macie2 list-findings ^
--finding-criteria={\"criterion\":{\"createdAt\":{\"gt\":1601881200000,\"lt\":1604559600000},\"classificationDetails.result.sensitiveData.category\":{\"eqExactMatch\":[\"FINANCIAL_INFORMATION\"]},\"archived\":{\"eq\":[\"false\"]}}}

ここで、