Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pencatatan log AWS KMS Panggilan API dengan AWS CloudTrail
AWS KMS terintegrasi dengan AWS CloudTrail, layanan yang merekam semua panggilan ke AWS KMS oleh pengguna, peran, dan lainnya AWS layanan. CloudTrail menangkap semua panggilan API ke AWS KMS sebagai acara, termasuk panggilan dari AWS KMS konsol, AWS KMS API, CloudFormation templat, AWS Command Line Interface (AWS CLI), dan Alat AWS untuk PowerShell.
CloudTrail mencatat semua AWS KMS operasi, termasuk operasi read-only, seperti ListAliases dan GetKeyRotationStatus, operasi yang mengelola kunci KMS, seperti CreateKey dan PutKeyPolicy, dan operasi kriptografi, seperti GenerateDataKey dan Mendekripsi. Ini juga mencatat operasi internal yang AWS KMS Panggilan untuk Anda, seperti DeleteExpiredKeyMaterial, DeleteKey, SynchronizeMultiRegionKey, dan RotateKey.
CloudTrail mencatat semua operasi yang berhasil dan, dalam beberapa skenario, percobaan panggilan yang gagal, seperti ketika pemanggil ditolak akses ke sumber daya. Cross-account operasi pada kunci KMS masuk ke akun penelepon dan akun pemilik kunci KMS. Namun, lintas akun AWS KMS permintaan yang ditolak karena akses ditolak hanya dicatat di akun penelepon.
Untuk alasan keamanan, beberapa bidang dihilangkan dari AWS KMS entri log, seperti Plaintext parameter dari sebuah Enkripsi Permintaan, dan tanggapan terhadap GetKeyPolicy atau operasi kriptografi apa pun. Untuk membuatnya lebih mudah untuk mencari CloudTrail entri log untuk kunci KMS tertentu, AWS KMS menambahkan kunci ARN dari kunci KMS yang terpengaruh ke responseElements bidang dalam entri log untuk beberapa AWS KMS operasi manajemen kunci, bahkan ketika operasi API tidak mengembalikan kunci ARN.
Meskipun secara default, semua AWS KMS tindakan dicatat sebagai CloudTrail acara, Anda dapat mengecualikan AWS KMS tindakan dari a CloudTrail jejak. Lihat perinciannya di Tidak termasuk AWS KMS peristiwa dari sebuah jejak.
Pelajari lebih lanjut:
-
Untuk CloudTrail contoh log dari AWS KMS operasi untuk platform yang dibuktikan, lihat Memantau permintaan yang dibuktikan.
Topik
Temuan AWS KMS entri log masuk CloudTrail
Untuk mencari CloudTrail entri log, gunakan CloudTrail konsol atau CloudTrail LookupEvents operasi. CloudTrail mendukung banyak nilai atribut untuk memfilter pencarian Anda, termasuk nama acara, nama pengguna, dan sumber acara.
Untuk membantu Anda mencari AWS KMS entri log masuk CloudTrail, AWS KMS mengisi berikut ini CloudTrail bidang entri log.
Mulai Desember 2022, AWS KMS mengisi Jenis sumber daya dan Nama sumber daya atribut dalam semua operasi manajemen yang mengubah kunci KMS tertentu. Nilai atribut ini mungkin nol di yang lebih lama CloudTrail entri untuk operasi berikut: CreateAlias, CreateGrant, DeleteAlias, DeleteImportedKeyMaterial, ImportKeyMaterial, ReplicateKey, RetireGrant, RevokeGrant, UpdateAlias, dan UpdatePrimaryRegion.
| Atribut | Nilai | Entri log |
|---|---|---|
Sumber acara (EventSource) |
kms.amazonaws.com |
Semua operasi. |
Jenis sumber daya (ResourceType) |
AWS::KMS::Key |
Operasi manajemen yang mengubah kunci KMS tertentu, seperti CreateKey dan EnableKey, tapi tidak ListKeys. |
Nama sumber daya (ResourceName) |
Kunci ARN (atau ID kunci dan kunci ARN) | Operasi manajemen yang mengubah kunci KMS tertentu, seperti CreateKey dan EnableKey, tapi tidak ListKeys. |
Untuk membantu Anda menemukan entri log untuk operasi manajemen pada kunci KMS tertentu, AWS KMS
mencatat kunci ARN dari kunci KMS yang terpengaruh di responseElements.keyId elemen entri log, bahkan ketika AWS KMS Operasi API tidak mengembalikan kunci ARN.
Misalnya, panggilan yang berhasil ke DisableKey operasi tidak mengembalikan nilai apa pun dalam respons, tetapi alih-alih nilai nol, responseElements.keyId nilai dalam DisableKey entri log termasuk kunci ARN dari kunci KMS yang dinonaktifkan.
Fitur ini ditambahkan pada Desember 2022 dan memengaruhi yang berikut CloudTrail entri log: CreateAlias, CreateGrant, DeleteAlias, DeleteKey, DisableKey, EnableKey, EnableKeyRotation, ImportKeyMaterial, RotateKey, SynchronizeMultiRegionKey, TagResource, UntagResource, UpdateAlias, dan UpdatePrimaryRegion.
Tidak termasuk AWS KMS peristiwa dari sebuah jejak
Untuk memberikan catatan penggunaan dan pengelolaannya AWS KMS sumber daya, sebagian besar AWS KMS pengguna bergantung pada peristiwa di CloudTrail jejak. Jejak dapat menjadi sumber data yang berharga untuk mengaudit peristiwa penting, seperti membuat, menonaktifkan, dan menghapus AWS KMS keys, mengubah kebijakan kunci, dan penggunaan kunci KMS Anda dengan AWS layanan atas nama Anda. Dalam beberapa kasus, metadata dalam CloudTrail entri log, seperti konteks enkripsi dalam operasi enkripsi, dapat membantu Anda menghindari atau menyelesaikan kesalahan.
Namun, karena AWS KMS dapat menghasilkan sejumlah besar peristiwa, AWS CloudTrail memungkinkan Anda mengecualikan AWS KMS peristiwa dari sebuah jejak. Pengaturan per jejak ini mengecualikan semua AWS KMS peristiwa; Anda tidak dapat mengecualikan tertentu AWS KMS peristiwa.
Tidak termasuk AWS KMS peristiwa dari a CloudTrail Log dapat mengaburkan tindakan yang menggunakan kunci KMS Anda. Berhati-hatilah saat memberikan cloudtrail:PutEventSelectors kepada pengguna utama yang diperlukan untuk melakukan operasi ini.
Untuk mengecualikan AWS KMS peristiwa dari sebuah jejak:
-
Di CloudTrail konsol, gunakan Peristiwa Layanan Manajemen Kunci Log pengaturan saat Anda buat jejak atau perbarui jejak. Untuk instruksi, lihat Pencatatan Acara Manajemen dengan Konsol Manajemen AWS di AWS CloudTrail Panduan Pengguna.
-
Di CloudTrail API, gunakan PutEventSelectors operasi. Tambahkan atribut
ExcludeManagementEventSourcespada pemilih peristiwa Anda dengan nilaikms.amazonaws.com. Sebagai contoh, lihat Contoh: Jejak yang tidak mencatat AWS Key Management Service acara di AWS CloudTrail Panduan Pengguna.
Anda dapat menonaktifkan pengecualian ini kapan saja dengan mengubah pengaturan konsol atau pemilih peristiwa untuk jejak. Jejak kemudian akan mulai merekam AWS KMS peristiwa. Namun, itu tidak dapat pulih AWS KMS peristiwa yang terjadi saat pengecualian efektif.
Ketika Anda mengecualikan AWS KMS peristiwa dengan menggunakan konsol atau API, yang dihasilkan CloudTrail PutEventSelectors Operasi API juga masuk ke Anda CloudTrail Log. Jika AWS KMS
acara tidak muncul di CloudTrail Log, cari a PutEventSelectors acara dengan ExcludeManagementEventSources atribut disetel ke kms.amazonaws.com.