Überwachen von S3 on Outposts mit Protokollen in AWS CloudTrail

Amazon S3 on Outposts ist in AWS CloudTrail integriert. Dieser Service stellt eine Aufzeichnung der von einem Benutzer, einer Rolle oder einem AWS-Service-Service in S3 durchgeführten Aktionen bereit. Sie können mit AWS CloudTrail Informationen über Anforderungen auf Bucket- und Objektebene in S3 on Outposts abrufen, um Ihre S3-on-Outposts-Ereignisaktivitäten zu überprüfen und zu protokollieren.

Um CloudTrail-Datenereignisse für alle Outposts-Buckets oder für eine Liste spezifischer Outposts-Buckets zu aktivieren, müssen Sie manuell einen Trail in CloudTrail erstellen. Weitere Informationen zu CloudTrail-Protokolldateieinträgen finden Sie unter S3-in-Outposts-Protokolldateieinträge.

Eine vollständige Liste der CloudTrail-Datenereignisse für S3 on Outposts finden Sie unter Amazon-S3-Datenereignisse in CloudTrail im Amazon-S3-Benutzerhandbuch.

CloudTrail-Protokollierung für Objekte in einem S3-in-Outposts-Bucket aktivieren

Sie können die Amazon-S3-Konsole verwenden, um einen AWS CloudTrail-Trail zum Protokollieren von Datenereignissen für Objekte in einem Amazon-S3-in-Outposts-Bucket zu konfigurieren. CloudTrail unterstützt die Protokollierung von API-Anforderungen auf Objektebene in S3 on Outposts wie beispielsweise GetObject, DeleteObject und PutObject. Diese Ereignisse werden als Datenereignisse bezeichnet.

Standardmäßig werden Datenereignisse nicht von den CloudTrail-Trails protokolliert. Sie können Trails jedoch so konfigurieren, dass sie Datenereignisse für von Ihnen festgelegte S3-in-Outposts-Buckets protokollieren oder dass sie Datenereignisse für alle S3-in-Outposts-Buckets in Ihrem AWS-Konto protokollieren.

CloudTrail gibt keine Datenereignisse in die CloudTrail-Ereignishistorie ein. Darüber hinaus werden nicht alle API-Operationen auf Bucket-Ebene in S3 on Outposts im CloudTrail-Ereignisverlauf aufgeführt. Weitere Informationen zum Abfragen von CloudTrail-Protokollen finden Sie unter Verwendung von Amazon-CloudWatch-Logs-Filtermustern und Amazon Athena zum Abfragen von CloudTrail-Protokollen im AWS-Wissenszentrum.

Um einen Trail zum Protokollieren von Datenereignissen für einen S3-in-Outposts-Bucket zu konfigurieren, können Sie entweder die AWS CloudTrail-Konsole oder die Amazon-S3-Konsole verwenden. Wenn Sie einen Trail zum Protokollieren von Datenereignissen für alle S3-in-Outposts-Buckets in Ihrem AWS-Konto konfigurieren möchten, ist es einfacher, die CloudTrail-Konsole zu verwenden. Informationen zur Verwendung der CloudTrail-Konsole zum Konfigurieren eines Trails zur Protokollierung von S3-in-Outposts-Datenereignissen finden Sie unter Daten-Ereignisse im Benutzerhandbuch zu AWS CloudTrail.

Das folgende Verfahren zeigt, wie mit der Amazon-S3-Konsole ein CloudTrail-Trail so konfiguriert wird, dass er Datenereignisse für einen S3-in-Outposts-Bucket protokolliert.

AWS CloudTrail-Protokolldateieinträge von Amazon S3 on Outposts

Amazon-S3-in-Outposts-Management-Ereignisse sind über AWS CloudTrail verfügbar. Darüber hinaus können Sie optional die Protokollierung für Datenereignisse aktivieren in AWS CloudTrail.

Ein Trail ist eine Konfiguration, durch die Ereignisse als Protokolldateien an den von Ihnen angegebenen S3-Bucket in einer Region übermittelt werden. CloudTrail-Protokolle für Ihre Outposts-Buckets enthalten ein neues Feld edgeDeviceDetails, das den Outpost identifiziert, in dem sich der angegebene Bucket befindet.

Weitere Protokollfelder umfassen die angeforderte Aktion, das Datum und die Uhrzeit der Aktion sowie die Anforderungsparameter. CloudTrail-Protokolleinträge sind kein geordnetes Stacktrace der öffentlichen API-Aufrufe und erscheinen daher nicht in einer bestimmten Reihenfolge.

Das folgende Beispiel zeigt den CloudTrail-Protokolleintrag, der die Aktion PutObject auf s3-outposts veranschaulicht.

{
      "eventVersion": "1.08",
      "userIdentity": {
        "type": "IAMUser",
        "principalId": "111122223333",
        "arn": "arn:aws:iam::111122223333:user/yourUserName",
        "accountId": "222222222222",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "yourUserName"
      },
      "eventTime": "2020-11-30T15:44:33Z",
      "eventSource": "s3-outposts.amazonaws.com",
      "eventName": "PutObject",
      "awsRegion": "us-east-1",
      "sourceIPAddress": "26.29.66.20",
      "userAgent": "aws-cli/1.18.39 Python/3.4.10 Darwin/18.7.0 botocore/1.15.39",
      "requestParameters": {
        "expires": "Wed, 21 Oct 2020 07:28:00 GMT",
        "Content-Language": "english",
        "x-amz-server-side-encryption-customer-key-MD5": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
        "ObjectCannedACL": "BucketOwnerFullControl",
        "x-amz-server-side-encryption": "Aes256",
        "Content-Encoding": "gzip",
        "Content-Length": "10",
        "Cache-Control": "no-cache",
        "Content-Type": "text/html; charset=UTF-8",
        "Content-Disposition": "attachment",
        "Content-MD5": "je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY",
        "x-amz-storage-class": "Outposts",
        "x-amz-server-side-encryption-customer-algorithm": "Aes256",
        "bucketName": "amzn-s3-demo-bucket1",
        "Key": "path/upload.sh"
      },
      "responseElements": {
        "x-amz-server-side-encryption-customer-key-MD5": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
        "x-amz-server-side-encryption": "Aes256",
        "x-amz-version-id": "001",
        "x-amz-server-side-encryption-customer-algorithm": "Aes256",
        "ETag": "d41d8cd98f00b204e9800998ecf8427f"
      },
      "additionalEventData": {
        "CipherSuite": "ECDHE-RSA-AES128-SHA",
        "bytesTransferredIn": 10,
        "x-amz-id-2": "29xXQBV2O+xOHKItvzY1suLv1i6A52E0zOX159fpfsItYd58JhXwKxXAXI4IQkp6",
        "SignatureVersion": "SigV4",
        "bytesTransferredOut": 20,
        "AuthenticationMethod": "AuthHeader"
      },
      "requestID": "8E96D972160306FA",
      "eventID": "ee3b4e0c-ab12-459b-9998-0a5a6f2e4015",
      "readOnly": false,
      "resources": [
        {
          "accountId": "222222222222",
          "type": "AWS::S3Outposts::Object",
          "ARN": "arn:aws:s3-outposts:us-east-1:YYY:outpost/op-01ac5d28a6a232904/bucket/path/upload.sh"
        },
        {
          "accountId": "222222222222",
          "type": "AWS::S3Outposts::Bucket",
          "ARN": "arn:aws:s3-outposts:us-east-1:YYY:outpost/op-01ac5d28a6a232904/bucket/"
        }
      ],
      "eventType": "AwsApiCall",
      "managementEvent": false,
      "recipientAccountId": "444455556666",
      "sharedEventID": "02759a4c-c040-4758-b84b-7cbaaf17747a",
      "edgeDeviceDetails": {
        "type": "outposts",
        "deviceId": "op-01ac5d28a6a232904"
      },
      "eventCategory": "Data"
    }