Daftarkan referensi untuk audit

Halaman ini menjelaskan cara mendaftarkan organisasi, folder, atau project sebagai resource untuk audit di Audit Manager.

Pendaftaran menyelesaikan tugas berikut:

  • Agen layanan yang dikelola Google yang terkait dengan Audit Manager dibuat, yang memantau resource yang ditentukan atas nama Anda. Alamat email agen layanan menggunakan format berikut, dengan RESOURCE_ID adalah ID organisasi, ID folder, atau ID project.

    RESOURCE_ID@gcp-sa-audit-manager.iam.gserviceaccount.com

    Mencabut peran agen layanan ini dapat menyebabkan Audit Manager berhenti mengaudit resource.

  • Bucket Cloud Storage yang ditentukan dikonfigurasi sebagai tujuan untuk menyimpan data audit.

Saat Anda mendaftarkan resource, resource turunannya juga akan didaftarkan. Misalnya, jika Anda mendaftarkan organisasi, semua project dalam organisasi tersebut juga akan didaftarkan. Jika resource induk sudah didaftarkan dan Anda mencoba mendaftarkan salah satu resource turunannya, resource turunan akan didaftarkan secara terpisah.

Sebelum memulai

  • Pastikan Anda memiliki peran dan izin IAM berikut:

  • Untuk mendaftarkan organisasi atau folder, Anda harus memiliki izin tambahan berikut:

    • Organisasi: resourcemanager.organizations.setIamPolicy
    • Folder: resourcemanager.folders.setIamPolicy

  • Identifikasi atau buat bucket Cloud Storage tempat data audit perlu diekspor.

    Untuk mempelajari cara membuat bucket Cloud Storage, lihat Membuat bucket.

Mendaftarkan resource untuk audit

Anda dapat mendaftarkan organisasi, folder, atau project untuk audit di Audit Manager.

Cara termudah untuk mendaftarkan resource adalah melalui Google Cloud konsol. Atau, Anda dapat menggunakan Audit Manager API atau Google Cloud CLI.

Konsol

  1. Di Google Cloud konsol, buka halaman Audit Manager.

    Buka Audit Manager

  2. Klik Setelan.

    Bergantung pada resource yang Anda pilih di pemilih project, daftar folder atau project akan ditampilkan di halaman Setelan.

  3. Di halaman Setelan, pilih resource yang ingin Anda daftarkan untuk Audit Manager, klik Daftarkan di kolom Status.

  4. Dalam dialog Pilih detail bucket penyimpanan, pilih satu atau beberapa bucket Cloud Storage tempat Anda ingin menyimpan laporan dan bukti, lalu klik Daftarkan.

    Resource Anda kini terdaftar untuk audit.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource. Nilai yang mungkin adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, folder, atau project. Contoh: 8767234.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager enrollments add \
    --RESOURCE_TYPE=RESOURCE_ID \
    --eligible-gcs-buckets=BUCKET_URI

Windows (PowerShell)

gcloud audit-manager enrollments add `
    --RESOURCE_TYPE=RESOURCE_ID `
    --eligible-gcs-buckets=BUCKET_URI

Windows (cmd.exe)

gcloud audit-manager enrollments add ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --eligible-gcs-buckets=BUCKET_URI

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource. Nilai yang mungkin adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, folder, atau project. Contoh: 8767234.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager.

Metode HTTP dan URL: 

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global:enrollResource

Meminta isi JSON: 

{
  "destinations": [
    {
      "eligibleGcsBucket": "BUCKET_URI"
    }
  ]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global:enrollResource"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global:enrollResource" | Select-Object -Expand Content

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Jika ingin mengubah lokasi penyimpanan data audit setelah pendaftaran, Anda harus memperbarui pendaftaran resource dan menentukan lokasi penyimpanan baru. Pendaftaran dan lokasi penyimpanan sebelumnya akan ditimpa oleh permintaan baru.

Langkah berikutnya