Perkaya CloudTrail peristiwa dengan menambahkan kunci tag sumber daya dan kunci kondisi global IAM

Anda dapat memperkaya peristiwa CloudTrail manajemen dan peristiwa data dengan menambahkan kunci tag sumber daya, kunci tag utama, dan kunci kondisi global IAM saat membuat atau memperbarui penyimpanan data peristiwa. Ini memungkinkan Anda untuk mengkategorikan, mencari, dan menganalisis CloudTrail peristiwa berdasarkan konteks bisnis, seperti alokasi biaya dan manajemen keuangan, operasi, dan persyaratan keamanan data. Anda dapat menganalisis peristiwa dengan menjalankan kueri di CloudTrail Lake. Anda juga dapat memilih untuk menggabungkan penyimpanan data acara Anda dan menjalankan kueri di Amazon Athena. Anda dapat menambahkan kunci tag sumber daya dan kunci kondisi global IAM ke penyimpanan data peristiwa menggunakan CloudTrail konsol, AWS CLI, dan SDK.

Saat Anda menambahkan kunci tag sumber daya ke acara yang diperkaya, CloudTrail sertakan kunci tag yang dipilih terkait dengan sumber daya yang terlibat dalam panggilan API.

Saat Anda menambahkan kunci kondisi global IAM ke penyimpanan data peristiwa, ser CloudTrail takan informasi tentang kunci kondisi yang dipilih yang dievaluasi selama proses otorisasi, termasuk detail tambahan tentang prinsipal, sesi, dan permintaan itu sendiri.

Setelah Anda menambahkan kunci tag sumber daya atau kunci kondisi IAM, CloudTrail sertakan eventContext bidang dalam CloudTrail acara yang menyediakan informasi kontekstual yang dipilih untuk tindakan API.

Ada beberapa pengecualian ketika acara tidak akan menyertakan eventContext bidang, termasuk yang berikut:

Layanan AWS tag sumber daya pendukung

Semua tag sumber daya Layanan AWS mendukung. Untuk informasi selengkapnya, lihat Layanan yang mendukung AWS Resource Groups Tagging API.

Pembaruan tag sumber daya CloudTrail untuk acara yang diperkaya

Ketika dikonfigurasi untuk melakukannya, CloudTrail menangkap informasi tentang tag sumber daya dan menggunakannya untuk memberikan informasi dalam acara yang diperkaya. Saat bekerja dengan tag sumber daya, ada kondisi tertentu di mana tag sumber daya mungkin tidak tercermin secara akurat pada saat permintaan sistem untuk peristiwa. Selama operasi standar, tag yang diterapkan pada waktu pembuatan sumber daya selalu ada dan akan mengalami penundaan minimal atau tidak ada. Namun, layanan berikut diharapkan mengalami penundaan perubahan tag sumber daya yang muncul di CloudTrail acara:

Pemadaman layanan juga dapat menyebabkan keterlambatan pembaruan informasi tag sumber daya. Jika terjadi penundaan pemadaman layanan, CloudTrail peristiwa berikutnya akan menyertakan addendum bidang yang menyertakan informasi tentang perubahan tag sumber daya. Informasi tambahan ini akan digunakan sebagaimana ditentukan untuk memberikan yang diperkayaCloudTrailevents.

Layanan AWS mendukung kunci kondisi global IAM

Berikut ini Layanan AWS mendukung kunci kondisi global IAM untuk acara yang diperkaya:

Kunci kondisi global IAM yang didukung untuk acara yang diperkaya

Tabel berikut mencantumkan kunci kondisi global IAM yang didukung untuk peristiwa yang CloudTrail diperkaya, dengan nilai contoh:

Contoh acara

Dalam contoh berikut, eventContext bidang menyertakan kunci kondisi global IAM aws:ViaAWSService dengan nilaifalse, yang menunjukkan panggilan API tidak dilakukan oleh. Layanan AWS

{
    "eventVersion": "1.11",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "ASIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:sts::123456789012:assumed-role/admin",
        "accountId": "123456789012",
        "accessKeyId": "ASIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "ASIAIOSFODNN7EXAMPLE",
                "arn": "arn:aws:iam::123456789012:role/admin",
                "accountId": "123456789012",
                "userName": "admin"
            },
            "attributes": {
                "creationDate": "2025-01-22T22:05:56Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2025-01-22T22:06:16Z",
    "eventSource": "cloudtrail.amazonaws.com",
    "eventName": "GetTrailStatus",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.168.0.0",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:133.0) Gecko/20100101 Firefox/133.0",
    "requestParameters": {
        "name": "arn:aws:cloudtrail:us-east-1:123456789012:trail/myTrail"
    },
    "responseElements": null,
    "requestID": "d09c4dd2-5698-412b-be7a-example1a23",
    "eventID": "9cb5f426-7806-46e5-9729-exampled135d",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "123456789012",
    "eventCategory": "Management",
    "tlsDetails": {
        "tlsVersion": "TLSv1.3",
        "cipherSuite": "TLS_AES_128_GCM_SHA256",
        "clientProvidedHostHeader": "cloudtrail.us-east-1.amazonaws.com"
    },
    "sessionCredentialFromConsole": "true",
    "eventContext": {
        "requestContext": {
            "aws:ViaAWSService": "false"
        },
        "tagContext": {}
    }
}