Filtern Ihres S3-Bucket-Inventars in Macie

Um Buckets mit bestimmten Merkmalen zu identifizieren und sich darauf zu konzentrieren, können Sie Ihr S3-Bucket-Inventar in der Amazon Macie-Konsole und in Abfragen filtern, die Sie programmgesteuert mit Amazon Macie einreichen. API Wenn Sie einen Filter erstellen, verwenden Sie bestimmte Bucket-Attribute, um Kriterien für das Ein- oder Ausschließen von Buckets in eine Ansicht oder aus Abfrageergebnissen zu definieren. Ein Bucket-Attribut ist ein Feld, das spezifische Metadaten für einen Bucket speichert.

In Macie besteht ein Filter aus einer oder mehreren Bedingungen. Jede Bedingung, auch als Kriterium bezeichnet, besteht aus drei Teilen:

Wie Sie Filterbedingungen definieren und anwenden, hängt davon ab, ob Sie die Amazon Macie-Konsole oder Amazon API Macie verwenden.

Ihr Inventar auf der Amazon Macie Macie-Konsole filtern

Wenn Sie die Amazon Macie Macie-Konsole verwenden, um Ihr S3-Bucket-Inventar zu filtern, bietet Macie Optionen, mit denen Sie Felder, Operatoren und Werte für einzelne Bedingungen auswählen können. Sie greifen auf diese Optionen zu, indem Sie das Filterfeld auf der S3-Buckets-Seite verwenden, wie in der folgenden Abbildung gezeigt.

Wenn Sie den Cursor in das Filterfeld setzen, zeigt Macie eine Liste von Feldern an, die Sie für Filterbedingungen verwenden können. Die Felder sind nach logischen Kategorien geordnet. Die Kategorie Allgemeine Felder umfasst beispielsweise Felder, in denen allgemeine Informationen zu einem S3-Bucket gespeichert werden. Zu den Kategorien für den öffentlichen Zugriff gehören Felder, in denen Daten über die verschiedenen Arten von Einstellungen für den öffentlichen Zugriff gespeichert werden, die für einen Bucket gelten können. Die Felder sind innerhalb jeder Kategorie alphabetisch sortiert.

Um eine Bedingung hinzuzufügen, wählen Sie zunächst ein Feld aus der Liste aus. Um ein Feld zu finden, durchsuchen Sie die gesamte Liste oder geben Sie einen Teil des Feldnamens ein, um die Liste der Felder einzugrenzen.

Je nachdem, welches Feld Sie auswählen, zeigt Macie verschiedene Optionen an. Die Optionen spiegeln den Typ und die Art des von Ihnen ausgewählten Feldes wider. Wenn Sie beispielsweise das Feld Gemeinsamer Zugriff auswählen, zeigt Macie eine Liste mit Werten an, aus denen Sie wählen können. Wenn Sie das Feld Bucket-Name auswählen, zeigt Macie ein Textfeld an, in das Sie den Namen eines S3-Buckets eingeben können. Welches Feld Sie auch wählen, Macie führt Sie durch die Schritte zum Hinzufügen einer Bedingung, die die erforderlichen Einstellungen für das Feld enthält.

Nachdem Sie eine Bedingung hinzugefügt haben, wendet Macie die Kriterien für die Bedingung an und zeigt die Bedingung in einem Filtertoken unter dem Filterfeld an, wie in der folgenden Abbildung dargestellt.

In diesem Beispiel ist die Bedingung so konfiguriert, dass sie alle öffentlich zugänglichen Buckets einschließt und alle anderen Buckets ausschließt. Sie gibt Buckets zurück, bei denen der Wert für das Feld Effektive Berechtigung gleich Öffentlich ist.

Wenn Sie weitere Bedingungen hinzufügen, wendet Macie deren Kriterien an und zeigt sie unter dem Filterfeld an. Wenn Sie mehrere Bedingungen hinzufügen, verwendet Macie AND Logik, um die Bedingungen zu verknüpfen und die Filterkriterien auszuwerten. Das bedeutet, dass ein S3-Bucket die Filterkriterien nur erfüllt, wenn er alle Bedingungen im Filter erfüllt. Sie können jederzeit im Bereich unter dem Filterfeld nachsehen, welche Kriterien Sie angewendet haben.

Programmgesteuertes Filtern Ihres Inventars mit dem Amazon Macie API

Um Ihr S3-Bucket-Inventar programmgesteuert zu filtern, geben Sie Filterkriterien in Abfragen an, die Sie mithilfe des DescribeBucketsAmazon Macie einreichen. API Dieser Vorgang gibt ein Array von Objekten zurück. Jedes Objekt enthält statistische Daten und andere Informationen über einen Bucket, der den Filterkriterien entspricht.

Um Filterkriterien in einer Abfrage anzugeben, fügen Sie Ihrer Anfrage eine Übersicht mit Filterbedingungen hinzu. Geben Sie für jede Bedingung ein Feld, einen Operator und einen oder mehrere Werte für das Feld an. Der Typ und die Anzahl der Werte hängen vom ausgewählten Feld und Operator ab. Informationen zu den Feldern, Operatoren und Wertetypen, die Sie in einer Bedingung verwenden können, finden Sie unter Amazon S3 S3-Datenquellen in der Amazon Macie API Macie-Referenz.

Die folgenden Beispiele zeigen Ihnen, wie Sie Filterkriterien in Abfragen angeben, die Sie mit AWS Command Line Interface (AWS CLI) einreichen. Sie können dies auch tun, indem Sie eine aktuelle Version eines anderen AWS Befehlszeilentools oder eines AWS SDK verwenden oder indem Sie HTTPS Anfragen direkt an Macie senden. Weitere Informationen zu AWS Tools und finden Sie unter ToolsSDKs, auf AWS denen Sie aufbauen können.

In den Beispielen wird der Befehl describe-buckets verwendet. Wenn ein Beispiel erfolgreich ausgeführt wird, gibt Macie ein Array zurück. buckets Das Array enthält ein Objekt für jeden Bucket, der sich im aktuellen Bucket befindet AWS-Region und den Filterkriterien entspricht. Ein Beispiel für diese Ausgabe finden Sie im folgenden Abschnitt.

{
    "buckets": [
        {
            "accountId": "123456789012",
            "allowsUnencryptedObjectUploads": "FALSE",
            "automatedDiscoveryMonitoringStatus": "MONITORED", 
            "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket1",
            "bucketCreatedAt": "2020-05-18T19:54:00+00:00",
            "bucketName": "amzn-s3-demo-bucket1",
            "classifiableObjectCount": 13,
            "classifiableSizeInBytes": 1592088,
            "jobDetails": {
                "isDefinedInJob": "TRUE",
                "isMonitoredByJob": "TRUE",
                "lastJobId": "08c81dc4a2f3377fae45c9ddaexample",
                "lastJobRunTime": "2024-05-26T14:55:30.270000+00:00"
            },
            "lastAutomatedDiscoveryTime": "2024-06-07T19:11:25.364000+00:00",
            "lastUpdated": "2024-06-12T07:33:06.337000+00:00",
            "objectCount": 13,
            "objectCountByEncryptionType": {
                "customerManaged": 0,
                "kmsManaged": 2,
                "s3Managed": 7,
                "unencrypted": 4,
                "unknown": 0
            },
            "publicAccess": {
                "effectivePermission": "NOT_PUBLIC",
                "permissionConfiguration": {
                    "accountLevelPermissions": {
                        "blockPublicAccess": {
                            "blockPublicAcls": true,
                            "blockPublicPolicy": true,
                            "ignorePublicAcls": true,
                            "restrictPublicBuckets": true
                        }
                    },
                    "bucketLevelPermissions": {
                        "accessControlList": {
                            "allowsPublicReadAccess": false,
                            "allowsPublicWriteAccess": false
                        },
                        "blockPublicAccess": {
                            "blockPublicAcls": true,
                            "blockPublicPolicy": true,
                            "ignorePublicAcls": true,
                            "restrictPublicBuckets": true
                        },
                        "bucketPolicy": {
                            "allowsPublicReadAccess": false,
                            "allowsPublicWriteAccess": false
                        }
                    }
                }
            },
            "region": "us-east-1",
            "replicationDetails": {
                "replicated": false,
                "replicatedExternally": false,
                "replicationAccounts": []
            },
            "sensitivityScore": 78,
            "serverSideEncryption": {
                "kmsMasterKeyId": null,
                "type": "NONE"
            },
            "sharedAccess": "NOT_SHARED",
            "sizeInBytes": 4549746,
            "sizeInBytesCompressed": 0,
            "tags": [
                {
                    "key": "Division",
                    "value": "HR"
                },
                {
                    "key": "Team",
                    "value": "Recruiting"
                }
            ],
            "unclassifiableObjectCount": {
                "fileType": 0,
                "storageClass": 0,
                "total": 0
            },
            "unclassifiableObjectSizeInBytes": {
                "fileType": 0,
                "storageClass": 0,
                "total": 0
            },
            "versioning": true
        },
        {
            "accountId": "123456789012",
            "allowsUnencryptedObjectUploads": "TRUE",
            "automatedDiscoveryMonitoringStatus": "MONITORED",
            "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket2",
            "bucketCreatedAt": "2020-11-25T18:24:38+00:00",
            "bucketName": "amzn-s3-demo-bucket2",
            "classifiableObjectCount": 8,
            "classifiableSizeInBytes": 133810,
            "jobDetails": {
                "isDefinedInJob": "TRUE",
                "isMonitoredByJob": "FALSE",
                "lastJobId": "188d4f6044d621771ef7d65f2example",
                "lastJobRunTime": "2024-04-09T19:37:11.511000+00:00"
            },
            "lastAutomatedDiscoveryTime": "2024-06-07T19:11:25.364000+00:00",
            "lastUpdated": "2024-06-12T07:33:06.337000+00:00",
            "objectCount": 8,
            "objectCountByEncryptionType": {
                "customerManaged": 0,
                "kmsManaged": 0,
                "s3Managed": 8,
                "unencrypted": 0,
                "unknown": 0
            },
            "publicAccess": {
                "effectivePermission": "NOT_PUBLIC",
                "permissionConfiguration": {
                    "accountLevelPermissions": {
                        "blockPublicAccess": {
                            "blockPublicAcls": true,
                            "blockPublicPolicy": true,
                            "ignorePublicAcls": true,
                            "restrictPublicBuckets": true
                        }
                    },
                    "bucketLevelPermissions": {
                        "accessControlList": {
                            "allowsPublicReadAccess": false,
                            "allowsPublicWriteAccess": false
                        },
                        "blockPublicAccess": {
                            "blockPublicAcls": true,
                            "blockPublicPolicy": true,
                            "ignorePublicAcls": true,
                            "restrictPublicBuckets": true
                        },
                        "bucketPolicy": {
                            "allowsPublicReadAccess": false,
                            "allowsPublicWriteAccess": false
                        }
                    }
                }
            },
            "region": "us-east-1",
            "replicationDetails": {
                "replicated": false,
                "replicatedExternally": false,
                "replicationAccounts": []
            },
            "sensitivityScore": 95,
            "serverSideEncryption": {
                "kmsMasterKeyId": null,
                "type": "AES256"
            },
            "sharedAccess": "EXTERNAL",
            "sizeInBytes": 175978,
            "sizeInBytesCompressed": 0,
            "tags": [
                {
                    "key": "Division",
                    "value": "HR"
                },
                {
                    "key": "Team",
                    "value": "Recruiting"
                }
            ],
            "unclassifiableObjectCount": {
                "fileType": 3,
                "storageClass": 0,
                "total": 3
            },
            "unclassifiableObjectSizeInBytes": {
                "fileType": 2999826,
                "storageClass": 0,
                "total": 2999826
            },
            "versioning": true
        }
    ]
}

Wenn keine Buckets den Filterkriterien entsprechen, gibt Macie ein leeres Array zurück. buckets

{
    "buckets": []
}

Beispiel 1: Suchen Sie Buckets anhand des Bucket-Namens

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten für alle Buckets abzufragen, deren Namen mit my-S3 beginnen und sich in der aktuellen Liste befinden. AWS-Region

Für Linux, macOS oder Unix:

$ aws macie2 describe-buckets --criteria '{"bucketName":{"prefix":"my-S3"}}'

Für Microsoft Windows:

C:\> aws macie2 describe-buckets --criteria={\"bucketName\":{\"prefix\":\"my-S3\"}}

Wobei gilt:

Beispiel 2: Suchen Sie nach Buckets, auf die öffentlich zugegriffen werden kann

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten für Buckets abzufragen, die sich in der aktuellen Version befinden AWS-Region und, basierend auf einer Kombination von Berechtigungseinstellungen, öffentlich zugänglich sind.

Für Linux, macOS oder Unix:

$ aws macie2 describe-buckets --criteria '{"publicAccess.effectivePermission":{"eq":["PUBLIC"]}}'

Für Microsoft Windows:

C:\> aws macie2 describe-buckets --criteria={\"publicAccess.effectivePermission\":{\"eq\":[\"PUBLIC\"]}}

Wobei gilt:

Beispiel 3: Suchen Sie nach Buckets, in denen unverschlüsselte Objekte gespeichert sind

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten für Buckets abzufragen, die sich in der aktuellen Version befinden, und unverschlüsselte Objekte zu speichern. AWS-Region

Für Linux, macOS oder Unix:

$ aws macie2 describe-buckets --criteria '{"objectCountByEncryptionType.unencrypted":{"gte":1}}'

Für Microsoft Windows:

C:\> aws macie2 describe-buckets --criteria={\"objectCountByEncryptionType.unencrypted\":{\"gte\":1}}

Wobei gilt:

Beispiel 4: Suchen Sie nach Buckets, die nicht von einem Job überwacht werden

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten für Buckets abzufragen, die sich in der aktuellen Version befinden AWS-Region und nicht mit periodischen Discovery-Jobs für sensible Daten verknüpft sind.

Für Linux, macOS oder Unix:

$ aws macie2 describe-buckets --criteria '{"jobDetails.isMonitoredByJob":{"eq":["FALSE"]}}'

Für Microsoft Windows:

C:\> aws macie2 describe-buckets --criteria={\"jobDetails.isMonitoredByJob\":{\"eq\":[\"FALSE\"]}}

Wobei gilt:

Beispiel 5: Suchen Sie nach Buckets, die Daten auf externe Konten replizieren

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten für Buckets abzufragen, die sich in der aktuellen Version befinden AWS-Region und so konfiguriert sind, dass Objekte in einen Bereich repliziert werden AWS-Konto , der nicht Teil Ihrer Organisation ist.

Für Linux, macOS oder Unix:

$ aws macie2 describe-buckets --criteria '{"replicationDetails.replicatedExternally":{"eq":["true"]}}'

Für Microsoft Windows:

C:\> aws macie2 describe-buckets --criteria={\"replicationDetails.replicatedExternally\":{\"eq\":[\"true\"]}}

Wobei gilt:

Beispiel 6: Suchen Sie nach Buckets auf der Grundlage mehrerer Kriterien

In diesem Beispiel wird der Befehl describe-buckets verwendet, um Metadaten nach Buckets abzufragen, die sich in der aktuellen Version befinden AWS-Region und die folgenden Kriterien erfüllen: Sie sind aufgrund einer Kombination von Berechtigungseinstellungen öffentlich zugänglich, speichern unverschlüsselte Objekte und sind nicht mit regelmäßigen Discovery-Aufträgen für sensible Daten verknüpft.

Verwenden Sie für Linux, macOS oder Unix den umgekehrten Schrägstrich (\) zur Verbesserung der Lesbarkeit:

$ aws macie2 describe-buckets \
--criteria '{"publicAccess.effectivePermission":{"eq":["PUBLIC"]},"objectCountByEncryptionType.unencrypted":{"gte":1},"jobDetails.isMonitoredByJob":{"eq":["FALSE"]}}'

Verwenden Sie für Microsoft Windows das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern:

C:\> aws macie2 describe-buckets ^
--criteria={\"publicAccess.effectivePermission\":{\"eq\":[\"PUBLIC\"]},\"objectCountByEncryptionType.unencrypted\":{\"gte\":1},\"jobDetails.isMonitoredByJob\":{\"eq\":[\"FALSE\"]}}

Wobei gilt: