Mencatat panggilan API AWS CodeStar Connections dengan AWS CloudTrail - Konsol Alat Developer

Mencatat panggilan API AWS CodeStar Connections dengan AWS CloudTrail

AWS CodeStar Connections terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau layanan AWS. CloudTrail merekam semua panggilan API untuk notifikasi sebagai peristiwa. Panggilan yang direkam mencakup panggilan dari konsol Alat Developer dan panggilan kode ke operasi API AWS CodeStar Connections.

Jika membuat jejak, Anda dapat mengaktifkan pengiriman kejadian CloudTrail berkelanjutan ke bucket Amazon Simple Storage Service (Amazon S3), termasuk peristiwa untuk notifikasi. Jika Anda tidak dapat mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru dalam konsol CloudTrail di Riwayat peristiwa. Menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat untuk AWS CodeStar Connections, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan rincian lainnya.

Untuk informasi selengkapnya, lihat Panduan Pengguna AWS CloudTrail.

Informasi AWS CodeStar Connections di CloudTrail

CloudTrail diaktifkan pada akun AWS Anda saat Anda membuat akun tersebut. Ketika aktivitas terjadi di AWS CodeStar Connections, aktivitas tersebut dicatat dalam peristiwa CloudTrail bersama peristiwa layanan AWS lainnya di Riwayat peristiwa. Anda dapat melihat, mencari, dan mengunduh peristiwa terbaru di akun AWS Anda. Untuk informasi selengkapnya, lihat Menampilkan peristiwa dengan riwayat peristiwa CloudTrail di Panduan Pengguna AWS CloudTrail.

Untuk catatan berkelanjutan tentang peristiwa di akun AWS Anda, termasuk peristiwa untuk AWS CodeStar Connections, buat jejak. Jejak memungkinkan CloudTrail untuk mengirim berkas log ke bucket Amazon S3. Secara default, ketika Anda membuat jejak di konsol, jejak diterapkan ke semua Wilayah AWS. Jejak mencatat kejadian dari semua Wilayah di partisi AWS dan mengirimkan berkas log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi layanan AWS lainnya untuk menganalisis lebih lanjut dan bertindak berdasarkan data peristiwa yang dikumpulkan di log CloudTrail.

Untuk informasi selengkapnya, lihat topik berikut di Panduan Pengguna AWS CloudTrail:

Semua tindakan AWS CodeStar Connections dicatat oleh CloudTrail dan didokumentasikan dalam Referensi API AWS CodeStar Connections. Misalnya, panggilan untuk tindakan CreateConnection, DeleteConnection dan GetConnection menghasilkan entri di berkas log CloudTrail.

Setiap entri kejadian atau log berisi informasi tentang siapa yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut:

  • Jika permintaan tersebut dibuat dengan kredensial pengguna root atau AWS Identity and Access Management (IAM).

  • Jika permintaan tersebut dibuat dengan kredensial keamanan sementara untuk peran atau pengguna gabungan.

  • Apakah permintaan dibuat oleh layanan AWS lain.

Untuk informasi selengkapnya, lihat elemen userIdentity CloudTrail.

Memahami entri berkas log

Jejak adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai berkas log ke bucket Amazon S3 yang telah Anda tentukan. Berkas log CloudTrail berisi satu atau beberapa entri log. Sebuah peristiwa mewakili permintaan tunggal dari sumber apa pun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. File log CloudTrail bukan jejak tumpukan terurut dari panggilan API publik, sehingga berkas tersebut tidak muncul dalam urutan tertentu.

Contoh berikut menunjukkan entri log CloudTrail yang menunjukkan tindakan CreateConnection.

{ "eventVersion": "1.05", "userIdentity": { "type":"IAMUser", "principalId":"AIDACKCEVSQ6C2EXAMPLE", "arn":"arn:aws:iam::123456789012:user/Mary_Major", "accountId":"123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName":"Mary_Major" }, "eventTime": "2020-04-21T01:09:48Z", "eventSource": "codestar-connections.amazonaws.com", "eventName": "CreateConnection", "awsRegion": "us-west-2", "sourceIPAddress": "IP", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.163 Safari/537.36", "requestParameters": { "providerType": "Bitbucket", "connectionName": "my-connection" }, "responseElements": { "connectionArn": "arn:aws:codestar-connections:us-west-2:123456789012:connection/7EXAMPLE-5da1-4867-960c-4918175ea3ce" }, "requestID": "ac1fbc15-a84f-4568-9f90-f05f1a57749c", "eventID": "7548f5b0-7ecf-430f-84bf-72e364644359", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "123456789012" }