Logging audit IAM

Dokumen ini menjelaskan log audit yang dibuat oleh Identity And Access Management sebagai bagian dari Cloud Audit Logs.

Ringkasan

Layanan Google Cloud menulis log audit untuk membantu Anda menjawab pertanyaan, "Siapa yang melakukan apa, di mana, dan kapan?" dalam resource Google Cloud.

Project Google Cloud Anda hanya berisi log audit untuk resource yang berada langsung dalam project Google Cloud. Resource Google Cloud lainnya, seperti folder, organisasi, dan akun penagihan, berisi log audit untuk entity itu sendiri.

Untuk membaca ringkasan umum tentang Cloud Audit Logs, lihat Ringkasan Cloud Audit Logs. Untuk mendapatkan pemahaman yang lebih mendalam tentang format log audit, lihat Memahami log audit.

Log audit yang tersedia

Jenis log audit berikut tersedia untuk IAM:

Log audit Aktivitas Admin

Mencakup operasi "penulisan admin" yang menulis metadata atau informasi konfigurasi.

Anda tidak dapat menonaktifkan log audit Aktivitas Admin.
Log audit Akses Data

Mencakup operasi "pembacaan admin" yang membaca metadata atau informasi konfigurasi. Juga mencakup operasi "pembacaan data" dan "penulisan data" yang membaca atau menulis data yang disediakan pengguna.

Untuk menerima log audit Akses Data, Anda harus mengaktifkannya secara eksplisit.

Untuk deskripsi yang lebih lengkap tentang jenis log audit, lihat Jenis log audit.

Operasi yang diaudit

Tabel berikut merangkum operasi API yang sesuai untuk setiap jenis log audit di IAM:

Kategori log audit Operasi IAM

Kategori log audit	Operasi IAM
Log Aktivitas Admin (`ADMIN_WRITE`)	Peran khusus: `CreateRole`¹ `DeleteRole`¹ `UndeleteRole`¹ `UpdateRole`¹ Kebijakan penolakan: `google.iam.v2.Policies.CreatePolicy` `google.iam.v2.Policies.DeletePolicy` `google.iam.v2.Policies.UpdatePolicy` `google.iam.v2beta.Policies.CreatePolicy` `google.iam.v2beta.Policies.DeletePolicy` `google.iam.v2beta.Policies.UpdatePolicy` Akun layanan: `CreateServiceAccount` `DeleteServiceAccount`¹ `DisableServiceAccount` `EnableServiceAccount` `GetServiceAccount` `PatchServiceAccount` `SetIAMPolicy`¹ `UndeleteServiceAccount` `UpdateServiceAccount` Kunci akun layanan: `CreateServiceAccountKey`¹ `DeleteServiceAccountKey` `UploadServiceAccountKey` Workload identity pools: `CreateWorkloadIdentityPool` `DeleteWorkloadIdentityPool` `UndeleteWorkloadIdentityPool` `UpdateWorkloadIdentityPool` Penyedia workload identity pool: `CreateWorkloadIdentityPoolProvider` `DeleteWorkloadIdentityPoolProvider` `UndeleteWorkloadIdentityPoolProvider` `UpdateWorkloadIdentityPoolProvider` Workforce pools: `CreateWorkforcePool` `DeleteWorkforcePool` `UndeleteWorkforcePool` `UpdateWorkforcePool` Penyedia workforce pool: `CreateWorkforcePoolProvider` `DeleteWorkforcePoolProvider` `UndeleteWorkforcePoolProvider` `UpdateWorkforcePoolProvider`
Log Akses Data (`ADMIN_READ`)	Kebijakan izin `GetEffectivePolicy`^{2, 3} `google.iam.admin.v1.GetIAMPolicy` `google.iam.admin.v1.GetPolicyDetails`^{2, 4} Kredensial: `ExchangeToken` `google.identity.sts.SecurityTokenService.WebSignIn` Peran khusus: `GetRole` `ListRoles` Kebijakan penolakan: `google.iam.v2.Policies.GetPolicy` `google.iam.v2.Policies.ListPolicies` `google.iam.v2beta.Policies.GetPolicy` `google.iam.v2beta.Policies.ListPolicies` Peran yang dapat diberikan: `QueryGrantableRoles`² Akun layanan: `GenerateAccessToken` `GenerateIdToken` `ListServiceAccounts` `SignBlob` `SignJwt` Kunci akun layanan: `GetServiceAccountKey` `ListServiceAccountKeys` Workload identity pools: `GetWorkloadIdentityPool` `ListWorkloadIdentityPools` Penyedia workload identity pool: `GetWorkloadIdentityPoolProvider` `ListWorkloadIdentityPoolProviders` Workforce pools: `GetWorkforcePool` `ListWorkforcePools` Penyedia workforce pool: `GetWorkforcePoolProvider` `ListWorkforcePoolProviders`
¹ Jika Anda mengaktifkan log audit `ADMIN_READ`, maka beberapa entri log untuk metode ini mungkin ditulis sebagai log Akses Data. Anda dapat menggunakan filter pengecualian untuk mencegah Cloud Logging menyerap entri log Akses Data. ² Metode ini dapat menyebabkan metode `getIamPolicy` dipanggil di API layanan lain. Misalnya, jika metode ini perlu memeriksa kebijakan izin untuk instance Compute Engine, maka metode `instances.getIamPolicy` di Compute Engine API dipanggil. Agar dapat menerima log audit untuk layanan tambahan ini, Anda harus mengaktifkan log audit `ADMIN_READ` untuk API layanan lain. ³ `GetEffectivePolicy` adalah metode pribadi di IAM API. Saat Anda menggunakan Pemecah Masalah Kebijakan API, hal ini mungkin akan memanggil metode secara internal. ⁴ `google.iam.admin.v1.GetPolicyDetails` adalah metode pribadi di IAM API. Saat Anda menggunakan Konsol Google Cloud, hal ini mungkin akan memanggil metode ini secara internal.

Log Aktivitas Admin (ADMIN_WRITE)

Peran khusus:

Kebijakan penolakan:

Akun layanan:

Kunci akun layanan:

Workload identity pools:

Penyedia workload identity pool:

Workforce pools:

Penyedia workforce pool:

Log Akses Data (ADMIN_READ)

Kebijakan izin

GetEffectivePolicy^{2, 3}
google.iam.admin.v1.GetIAMPolicy
google.iam.admin.v1.GetPolicyDetails^{2, 4}

Kredensial:

Peran khusus:

Kebijakan penolakan:

Peran yang dapat diberikan:

QueryGrantableRoles²

Akun layanan:

Kunci akun layanan:

Workload identity pools:

Penyedia workload identity pool:

Workforce pools:

Penyedia workforce pool:

¹ Jika Anda mengaktifkan log audit ADMIN_READ, maka beberapa entri log untuk metode ini mungkin ditulis sebagai log Akses Data. Anda dapat menggunakan filter pengecualian untuk mencegah Cloud Logging menyerap entri log Akses Data.

² Metode ini dapat menyebabkan metode getIamPolicy dipanggil di API layanan lain. Misalnya, jika metode ini perlu memeriksa kebijakan izin untuk instance Compute Engine, maka metode instances.getIamPolicy di Compute Engine API dipanggil. Agar dapat menerima log audit untuk layanan tambahan ini, Anda harus mengaktifkan log audit ADMIN_READ untuk API layanan lain.

³ GetEffectivePolicy adalah metode pribadi di IAM API. Saat Anda menggunakan Pemecah Masalah Kebijakan API, hal ini mungkin akan memanggil metode secara internal.

⁴ google.iam.admin.v1.GetPolicyDetails adalah metode pribadi di IAM API. Saat Anda menggunakan Konsol Google Cloud, hal ini mungkin akan memanggil metode ini secara internal.

Anda juga dapat melihat contoh entri log audit untuk akun layanan.

Format log audit

Entri log audit mencakup objek berikut:

Entri log itu sendiri, yang merupakan objek dengan jenis LogEntry. Kolom berguna yang meliputi hal berikut ini:
- logName berisi ID resource dan jenis log audit.
- resource berisi target operasi yang diaudit.
- timeStamp berisi waktu operasi yang diaudit.
- protoPayload berisi informasi yang diaudit.
Data logging audit, yang merupakan objek AuditLog yang disimpan di kolom protoPayload entri log.
Informasi audit khusus layanan opsional, yang merupakan objek khusus layanan. Untuk integrasi sebelumnya, objek ini disimpan di kolom serviceData dari objek AuditLog; integrasi berikutnya menggunakan kolom metadata.

Untuk kolom lain dalam objek ini, dan cara menafsirkannya, tinjau Memahami log audit.

Nama log

Nama log Cloud Audit Logs mencakup ID resource yang menunjukkan project Google Cloud atau entity Google Cloud lainnya yang memiliki log audit, dan apakah log berisi Aktivitas Admin, Akses Data, Kebijakan Ditolak, atau data logging audit Peristiwa Sistem.

Berikut adalah nama log audit, termasuk variabel untuk ID resource:

   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Factivity
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   folders/FOLDER_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Factivity
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com%2Fpolicy

   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Factivity
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fdata_access
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fsystem_event
   organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com%2Fpolicy

Nama layanan

Log audit IAM menggunakan salah satu nama layanan berikut:

iam.googleapis.com: Digunakan untuk IAM API, dan untuk metode yang dipanggil secara internal oleh Pemecah Masalah Kebijakan API.
iamcredentials.googleapis.com: Digunakan untuk Service Account Credentials API, yang membuat kredensial jangka pendek untuk akun layanan.

Catatan: IAM API juga menyertakan metode untuk menandatangani blob biner dan Token Web JSON (JWT). Metode ini tidak digunakan lagi. Sebagai gantinya gunakan Service Account Credentials API.
sts.googleapis.com: Digunakan untuk Security Token Service API, yang menukar kredensial Google atau pihak ketiga dengan token akses Google jangka pendek.

Untuk mengetahui daftar lengkap semua nama layanan Cloud Logging API dan jenis resource yang dimonitor, lihat Memetakan layanan ke resource.

Jenis resource

Log audit IAM menggunakan salah satu jenis resource berikut:

api: Permintaan untuk mencantumkan informasi tentang beberapa peran atau kebijakan IAM.
audited_resource: Permintaan untuk menukar kredensial dengan token akses Google.
iam_role: Peran khusus IAM.
service_account: Akun layanan IAM, atau kunci layanan akun.

Untuk mengetahui daftar semua jenis resource yang dimonitor dan informasi deskriptif Cloud Logging, lihat Jenis resource yang dimonitor.

Identitas pemanggil

Alamat IP pemanggil disimpan di kolom RequestMetadata.caller_ip pada objek AuditLog. Logging mungkin menyamarkan identitas pemanggil dan alamat IP tertentu.

Untuk mengetahui informasi tentang informasi yang disamarkan dalam log audit, lihat Identitas pemanggil di log audit.

Mengaktifkan logging audit

Log audit Aktivitas Admin selalu diaktifkan; Anda tidak dapat menonaktifkannya.

Log audit Akses Data dinonaktifkan secara default dan tidak ditulis kecuali diaktifkan secara eksplisit (dengan pengecualian log audit Akses Data untuk BigQuery, yang tidak dapat dinonaktifkan).

Untuk informasi tentang cara mengaktifkan sebagian atau semua log audit Akses Data Anda, lihat Mengaktifkan log audit Akses Data.

Izin dan peran

Izin dan peran IAM menentukan kemampuan Anda untuk mengakses data log audit di resource Google Cloud.

Saat memutuskan Izin dan peran khusus logging mana yang berlaku untuk kasus penggunaan Anda, pertimbangkan hal berikut:

Peran Logs Viewer (roles/logging.viewer) memberi Anda akses hanya baca ke log audit Aktivitas Admin, Kebijakan Ditolak, dan Peristiwa Sistem. Jika hanya memiliki peran ini, Anda tidak dapat melihat log audit Akses Data yang ada di bucket _Default.
Peran Private Logs Viewer(roles/logging.privateLogViewer) mencakup izin yang ada di roles/logging.viewer, serta kemampuan untuk membaca log audit Akses Data di bucket _Default.

Perlu diperhatikan bahwa jika log pribadi ini disimpan dalam bucket yang ditentukan pengguna, maka setiap pengguna yang memiliki izin untuk membaca log dalam bucket tersebut dapat membaca log pribadi. Untuk informasi selengkapnya tentang bucket log, lihat Ringkasan perutean dan penyimpanan.

Untuk mengetahui informasi selengkapnya tentang peran dan izin IAM yang berlaku untuk data log audit, lihat Kontrol akses dengan IAM.

Lihat log

Anda dapat membuat kueri untuk semua log audit atau membuat kueri untuk log berdasarkan nama log auditnya. Nama log audit mencakup ID resource project, folder, akun penagihan, atau organisasi Google Cloud yang informasi logging auditnya ingin Anda lihat. Kueri Anda dapat menentukan kolom LogEntry yang diindeks, dan jika menggunakan halaman Log Analytics, yang mendukung Kueri SQL, Anda dapat melihat hasil kueri sebagai diagram.

Untuk mengetahui informasi selengkapnya tentang cara membuat kueri log Anda, lihat halaman berikut:

Anda dapat melihat log audit di Cloud Logging menggunakan Konsol Google Cloud, Google Cloud CLI, atau Logging API.

Konsol

Di Konsol Google Cloud, Anda dapat menggunakan Logs Explorer guna mengambil entri log audit untuk project, folder, atau organisasi Google Cloud Anda:

Di panel navigasi konsol Google Cloud, pilih Logging, lalu pilih Logs Explorer:
Buka Logs Explorer
Pilih project, folder, atau organisasi Google Cloud yang sudah ada.
Untuk menampilkan semua log audit, masukkan salah satu kueri berikut ke kolom editor kueri, lalu klik Jalankan kueri:
```
logName:"cloudaudit.googleapis.com"
```
```
protoPayload."@type"="type.googleapis.com/google.cloud.audit.AuditLog"
```
Agar dapat menampilkan log audit untuk jenis log audit dan resource tertentu, di panel Builder kueri, lakukan langkah berikut ini:
- Di Jenis resource, pilih resource Google Cloud yang log auditnya ingin Anda lihat.
- Di Log name, pilih jenis log audit yang ingin dilihat:
  - Untuk log audit Aktivitas Admin, pilih activity.
  - Untuk log audit Akses Data, pilih data_access.
  - Untuk log audit Peristiwa Sistem, pilih system_event.
  - Untuk log audit Kebijakan Ditolak, pilih policy.
- Klik Jalankan kueri.
Jika Anda tidak melihat opsi ini, maka tidak ada log audit dengan jenis tersebut yang tersedia di project, folder, atau organisasi Google Cloud.

Jika mengalami masalah saat mencoba melihat log di Logs Explorer, lihat informasi pemecahan masalah.

Untuk mengetahui informasi selengkapnya tentang pembuatan kueri menggunakan Logs Explorer, lihat Membangun kueri di Logs Explorer. Untuk mengetahui informasi tentang cara meringkas entri log di Logs Explorer menggunakan Gemini, lihat Meringkas entri log dengan bantuan Gemini.

gcloud

Google Cloud CLI menyediakan antarmuka command line ke Logging API. Berikan ID resource yang valid di setiap nama log. Misalnya, jika kueri Anda menyertakan PROJECT_ID, ID project yang Anda berikan harus merujuk ke project Google Cloud yang saat ini dipilih.

Untuk membaca entri log audit level project Google Cloud Anda, jalankan perintah berikut:

gcloud logging read "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com" \
    --project=PROJECT_ID

Untuk membaca entri log audit level folder, jalankan perintah berikut:

gcloud logging read "logName : folders/FOLDER_ID/logs/cloudaudit.googleapis.com" \
    --folder=FOLDER_ID

Untuk membaca entri log audit level organisasi, jalankan perintah berikut:

gcloud logging read "logName : organizations/ORGANIZATION_ID/logs/cloudaudit.googleapis.com" \
    --organization=ORGANIZATION_ID

Untuk membaca entri log audit level akun Penagihan Cloud Anda, jalankan perintah berikut:

gcloud logging read "logName : billingAccounts/BILLING_ACCOUNT_ID/logs/cloudaudit.googleapis.com" \
    --billing-account=BILLING_ACCOUNT_ID

Tambahkan flag --freshness ke perintah Anda untuk membaca log yang berusia lebih dari 1 hari.

Untuk mengetahui informasi selengkapnya tentang penggunaan gcloud CLI, lihat gcloud logging read.

API

Saat membangun kueri, sediakan ID resource yang valid di setiap nama log. Misalnya, jika kueri Anda menyertakan PROJECT_ID, ID project yang Anda berikan harus merujuk ke project Google Cloud yang saat ini dipilih.

Misalnya, untuk menggunakan Logging API guna melihat entri log audit level project Anda, lakukan tindakan berikut:

Buka bagian Coba API ini dalam dokumentasi untuk metode entries.list.
Masukkan string berikut ke dalam bagian Isi permintaan di formulir Coba API ini. Mengklik formulir yang telah diisi ini akan otomatis mengisi isi permintaan, tetapi Anda harus memberikan PROJECT_ID yang valid di setiap nama log.
```
{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "pageSize": 5,
  "filter": "logName : projects/PROJECT_ID/logs/cloudaudit.googleapis.com"
}
```
Klik Jalankan.

Sampel kueri

Untuk menemukan log audit IAM, gunakan kueri berikut di Logs Explorer:

Sebelum menggunakan sampel kueri, ganti nilai berikut:

SERVICE_ACCOUNT_SHORT_ID: Semua yang mendahului simbol @ di alamat email akun layanan. Misalnya, ID akun layanan dari akun layanan service-account@example.iam.gserviceaccount.com adalah service-account.
SERVICE_ACCOUNT_EMAIL: Alamat email lengkap akun layanan. Misalnya, service-account@example.iam.gserviceaccount.com.
ROLE_NAME: Nama peran lengkap, termasuk setiap awalan organizations/, projects/, atau roles/. Misalnya, organizations/123456789012/roles/myCompanyAdmin.

Nama kueri	Ekspresi
Akun layanan dibuat	resource.type = "service_account" protoPayload.serviceName = "iam.googleapis.com" protoPayload.methodName:"CreateServiceAccount" log_id("cloudaudit.googleapis.com/activity") (protoPayload.request.account_id:"`SERVICE_ACCOUNT_SHORT_ID`" OR protoPayload.response.email:"`SERVICE_ACCOUNT_EMAIL`")
Akun layanan dihapus	resource.type = "service_account" protoPayload.serviceName = "iam.googleapis.com" protoPayload.methodName:"DeleteServiceAccount" log_id("cloudaudit.googleapis.com/activity") resource.labels.email_id:"`SERVICE_ACCOUNT_EMAIL`"
Kunci akun layanan yang dibuat	resource.type = "service_account" protoPayload.serviceName = "iam.googleapis.com" protoPayload.methodName:"CreateServiceAccountKey" log_id("cloudaudit.googleapis.com/activity") resource.labels.email_id:"`SERVICE_ACCOUNT_EMAIL`"
Kunci akun layanan yang dihapus	resource.type = "service_account" protoPayload.serviceName = "iam.googleapis.com" protoPayload.methodName:"DeleteServiceAccountKey" log_id("cloudaudit.googleapis.com/activity") resource.labels.email_id:"`SERVICE_ACCOUNT_EMAIL`"
Setiap resource yang dibuat, diubah, atau dihapus	log_id("cloudaudit.googleapis.com/activity") AND protoPayload.methodName:("create" OR "delete" OR "update")
Peran khusus yang diperbarui	log_id("cloudaudit.googleapis.com/activity") resource.type = "iam_role" protoPayload.serviceName = "iam.googleapis.com" protoPayload.methodName:"UpdateRole" resource.labels.role_name:"`ROLE_NAME`"
Kebijakan izin level project yang diperbarui	resource.type = "project" AND log_id("cloudaudit.googleapis.com/activity") AND protoPayload.methodName:"SetIamPolicy"

Untuk menggunakan sampel kueri, lakukan hal berikut:

Ganti variabel dengan informasi project Anda sendiri, lalu salin ekspresi menggunakan ikon papan klip .
Di panel navigasi konsol Google Cloud, pilih Logging, lalu pilih Logs Explorer:
Buka Logs Explorer
Aktifkan Show query untuk membuka kolom editor kueri, lalu tempel ekspresi ke dalam kolom editor kueri:
Klik Jalankan kueri. Log yang cocok dengan kueri Anda akan tercantum di panel Query results.

Merutekan log audit

Anda dapat merutekan log audit ke tujuan yang didukung dengan cara yang sama seperti saat merutekan jenis log lainnya. Berikut adalah beberapa alasan mengapa Anda mungkin ingin merutekan log audit Anda:

Untuk menyimpan log audit dalam jangka panjang atau untuk menggunakan kemampuan penelusuran yang lebih andal, Anda dapat merutekan salinan log audit Anda ke Cloud Storage, BigQuery, atau Pub/Sub. Dengan Pub/Sub, Anda dapat merutekan log audit ke aplikasi lain, repositori lain, dan ke pihak ketiga.
Untuk mengelola log audit di seluruh organisasi, Anda dapat membuat sink gabungan yang dapat merutekan log dari setiap atau semua project Google Cloud di organisasi.

Jika log audit Akses Data yang diaktifkan membuat project Google Cloud Anda melebihi alokasi log, Anda dapat membuat sink yang mengecualikan log audit Akses Data dari Logging.

Untuk mendapatkan petunjuk tentang cara merutekan log, lihat Merutekan log ke tujuan yang didukung.

Harga

Untuk mengetahui informasi selengkapnya tentang harga, lihat ringkasan harga Cloud Logging.

Langkah selanjutnya

Dapatkan informasi tentang Cloud Audit Logs.
Tinjau contoh entri log audit untuk akun layanan.
Pelajari selengkapnya tentang akun layanan.