Menggunakan AWS CloudTrail untuk mencatat WorkDocs API panggilan Amazon

Anda dapat menggunakan AWS CloudTrail; untuk mencatat WorkDocs API panggilan Amazon. CloudTrail menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di Amazon WorkDocs. CloudTrail menangkap semua API panggilan untuk Amazon WorkDocs sebagai acara, termasuk panggilan dari WorkDocs konsol Amazon dan dari panggilan kode ke Amazon WorkDocs APIs.

Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket Amazon S3, termasuk acara untuk Amazon. WorkDocs Jika Anda tidak membuat jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam Riwayat acara.

Informasi yang dikumpulkan CloudTrail termasuk permintaan, alamat IP dari mana permintaan dibuat, pengguna yang membuat permintaan, dan tanggal permintaan.

Untuk informasi selengkapnya CloudTrail, lihat Panduan AWS CloudTrail Pengguna.

WorkDocs Informasi Amazon di CloudTrail

CloudTrail diaktifkan di AWS akun Anda saat Anda membuat akun. Ketika aktivitas terjadi di Amazon WorkDocs, aktivitas tersebut direkam dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya dalam riwayat Acara. Anda dapat melihat, mencari, dan mengunduh acara terbaru di AWS akun Anda. Untuk informasi selengkapnya, lihat Melihat peristiwa dengan riwayat CloudTrail acara.

Untuk catatan peristiwa yang sedang berlangsung di AWS akun Anda, termasuk acara untuk Amazon WorkDocs, buat jejak. Jejak memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, ketika Anda membuat jejak di konsol, jejak ini diterapkan ke semua Wilayah. Trail mencatat peristiwa dari semua wilayah di AWS partisi dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat:

• Ikhtisar untuk membuat jejak

• CloudTrail layanan dan integrasi yang didukung

• Mengonfigurasi SNS notifikasi Amazon untuk CloudTrail

• Menerima file CloudTrail log dari beberapa Wilayah dan Menerima file CloudTrail log dari beberapa akun

Semua WorkDocs tindakan Amazon dicatat oleh CloudTrail dan didokumentasikan dalam WorkDocs APIReferensi Amazon. Misalnya, panggilan keCreateFolder, DeactivateUser dan UpdateDocument bagian menghasilkan entri dalam file CloudTrail log.

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

• Apakah permintaan dibuat dengan root atau kredensi IAM pengguna.

• Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna terfederasi.

• Apakah permintaan itu dibuat oleh AWS layanan lain.

Untuk informasi lebih lanjut, lihat CloudTrail userIdentityelemen.

Memahami entri file WorkDocs log Amazon

Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang dipesan dari API panggilan publik, sehingga tidak muncul dalam urutan tertentu.

Amazon WorkDocs menghasilkan berbagai jenis CloudTrail entri, yang berasal dari bidang kontrol dan entri dari bidang data. Perbedaan penting antara keduanya adalah bahwa identitas pengguna untuk entri bidang kontrol adalah IAM pengguna. Identitas pengguna untuk entri pesawat data adalah pengguna WorkDocs direktori Amazon.

catatan

Untuk keamanan yang lebih besar, buat pengguna federasi alih-alih IAM pengguna bila memungkinkan.

Informasi sensitif, seperti kata sandi, token autentikasi, komentar file, dan konten file disunting dalam entri log. Ini muncul sebagai HIDDEN _ DUE _TO_ SECURITY _ REASONS di log. CloudTrail Ini muncul sebagai HIDDEN _ DUE _TO_ SECURITY _ REASONS di log. CloudTrail

Contoh berikut menunjukkan dua entri CloudTrail log untuk Amazon WorkDocs: catatan pertama adalah untuk tindakan bidang kontrol dan yang kedua untuk tindakan bidang data.

{
  Records : [
    {
      "eventVersion" : "1.01",
      "userIdentity" :
      {
        "type" : "IAMUser",
        "principalId" : "user_id",
        "arn" : "user_arn",
        "accountId" : "account_id",
        "accessKeyId" : "access_key_id",
        "userName" : "user_name"
      },
      "eventTime" : "event_time",
      "eventSource" : "workdocs.amazonaws.com",
      "eventName" : "RemoveUserFromGroup",
      "awsRegion" : "region",
      "sourceIPAddress" : "ip_address",
      "userAgent" : "user_agent",
      "requestParameters" :
      {
        "directoryId" : "directory_id",
        "userSid" : "user_sid",
        "group" : "group"
      },
      "responseElements" : null,
      "requestID" : "request_id",
      "eventID" : "event_id"
    },
    {
      "eventVersion" : "1.01",
      "userIdentity" :
      {
        "type" : "Unknown",
        "principalId" : "user_id",
        "accountId" : "account_id",
        "userName" : "user_name"
      },
      "eventTime" : "event_time",
      "eventSource" : "workdocs.amazonaws.com",      
      "awsRegion" : "region",
      "sourceIPAddress" : "ip_address",
      "userAgent" : "user_agent",
      "requestParameters" :
      {
        "AuthenticationToken" : "**-redacted-**"
      },
      "responseElements" : null,
      "requestID" : "request_id",
      "eventID" : "event_id"
    }
  ]
}