Menjadwalkan dan menjalankan audit

Audit memungkinkan Anda mengumpulkan bukti yang diperlukan untuk menilai Google Cloud organisasi Anda terhadap framework yang didukung. Anda dapat menjadwalkan audit untuk dijalankan secara berkala atau menjalankan audit on-demand.

Audit adalah operasi yang berjalan lama dan mungkin memerlukan waktu beberapa jam. Durasinya bergantung pada jumlah resource dalam cakupan audit, yaitu organisasi, project, atau folder yang telah Anda daftarkan sebelumnya.

Jika menjadwalkan audit, Anda hanya dapat membuat jadwal untuk framework dan resource tertentu jika jadwal aktif atau dijeda belum ada untuk kombinasi framework dan resource.

Sebelum memulai

  • Pastikan Anda memiliki salah satu peran IAM berikut:

    • Audit Manager Admin (roles/auditmanager.admin)
    • Audit Manager Auditor (roles/auditmanager.auditor)
  • Pastikan organisasi, project, atau folder Anda telah didaftarkan untuk audit.

Menjadwalkan dan menjalankan audit

Anda dapat membuat jadwal untuk menjalankan audit secara berulang, atau menjalankan audit sesuai permintaan.

Konsol

  1. Di konsol Google Cloud , buka halaman Run assessment di Audit Manager.

    Buka Audit Manager

  2. Di bagian Choose resource and region, lakukan hal berikut:

    1. Pilih organisasi, folder, atau project Anda yang perlu diaudit.

    2. Pilih lokasi tempat penilaian audit harus diproses. Untuk daftar lokasi yang didukung, lihat Lokasi Audit Manager.

    3. Klik Berikutnya.

  3. Di bagian Choose regulation, pilih framework yang ingin Anda gunakan untuk mengaudit resource, lalu klik Next. Untuk mengetahui informasi tentang framework yang didukung, lihat Framework yang didukung.

  4. Opsional: Jika bagian Configure Parameters muncul, selesaikan langkah-langkah berikut:

    1. Klik Ubah Konfigurasi.

    2. Di jendela Configure parameters, tambahkan parameter yang diperlukan untuk kontrol cloud. Untuk mengetahui informasi selengkapnya tentang parameter, lihat Referensi kontrol cloud Compliance Manager dan Kontrol cloud Assured Workloads.

    3. Klik Simpan.

  5. Opsional: Di bagian View Assessment Plan, Anda dapat mendownload file ODS yang berisi informasi tentang cakupan audit berdasarkan framework yang Anda pilih. Untuk mendownload file, klik link, lalu klik Berikutnya.

  6. Di bagian Choose storage bucket, pilih bucket penyimpanan tempat laporan audit dan bukti harus disimpan, lalu klik Done. Jika bucket Anda tidak tercantum, minta administrator untuk mendaftarkan resource Anda dengan bucket penyimpanan Anda.

  7. Opsional: Di bagian Schedule, tetapkan salah satu hal berikut:

    • Seberapa sering audit diulang (harian, bulanan, kuartalan, atau tahunan).

    • Jangka waktu yang akan disertakan dalam audit. Jika Anda memilih Never ending, audit akan terus berjalan dari tanggal mulai yang Anda tentukan, hingga Anda menghentikannya secara manual.

  8. Untuk memulai audit, klik Jalankan Audit atau Jalankan Audit Terjadwal.

    Anda dapat melihat status audit di halaman Lihat penilaian.

gcloud

Opsional: Membuat penilaian audit

Sebelum menjalankan audit yang sebenarnya, Anda dapat membuat penilaian audit (atau cakupan) yang mencakup perincian tugas mendetail untuk audit berdasarkan framework kepatuhan yang Anda pilih.

Perintah gcloud audit-manager audit-scopes generate menghasilkan cakupan audit.

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

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di Audit Manager.
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.
  • OUTPUT_DIRECTORY: direktori tempat output harus disimpan. Contoh: reports.
  • OUTPUT_FILENAME: nama file output. Jangan sertakan ekstensi file dalam nama file. Misalnya:scopeReport.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

Windows (PowerShell)

gcloud audit-manager audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

Windows (cmd.exe)

gcloud audit-manager audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

Menjalankan audit sesuai permintaan

Perintah gcloud audit-manager audit-reports generate menjalankan audit.

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

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organization, folder, dan project.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di Audit Manager.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud audit-manager audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

Windows (PowerShell)

gcloud audit-manager audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

Windows (cmd.exe)

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

Anda akan melihat respons seperti berikut:

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

REST

Opsional: Membuat penilaian audit

Sebelum menjalankan audit yang sebenarnya, Anda dapat membuat penilaian audit (atau cakupan) yang mencakup perincian tugas mendetail untuk audit berdasarkan framework kepatuhan yang Anda pilih.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di Audit Manager.
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Metode HTTP dan URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

Meminta isi JSON:


{
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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/LOCATION/auditScopesReport:generate"

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/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{

  "scope_report_contents" : "980u43nrf090834uhbkfehf......"
  "name" : "folders/8767234/locations/us-west"
}

Respons memiliki informasi berikut:

    Kolom scope_reports_contents adalah format byte konten, yang harus dikonversi ke format ODF sebelum ditinjau.

  • name: ID string unik dari resource yang berlaku.

Menjalankan audit sesuai permintaan

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di Audit Manager.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.

Metode HTTP dan URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

Meminta isi JSON:


{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

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/LOCATION/auditReport:generate"

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/LOCATION/auditReport:generate" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

Respons memiliki informasi berikut:

  • name: ID string unik dari permintaan operasi penilaian audit. ID ini digunakan untuk melacak progres proses penilaian audit. Contoh: operation/098234.
  • done: Flag boolean yang ditetapkan ke false yang menunjukkan bahwa proses telah dipicu. Nilai ini ditetapkan ke true saat penilaian audit selesai.

Menjalankan audit terjadwal

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • FRAMEWORK: ID framework yang akan diaudit. Contoh: builtin-cis-v8. Untuk menemukan ID framework, lihat halaman Melihat penilaian di Audit Manager.
  • BUCKET_URI: URI bucket Cloud Storage. Contoh: gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT: format laporan audit output. Hanya format ODF yang didukung: AUDIT_REPORT_FORMAT_ODF.
  • DISPLAY_NAME: nama untuk jadwal audit. Contoh: NIST 800-53 Daily Audit.
  • SCHEDULE_START_TIME: stempel waktu saat jadwal audit menjadi aktif. Contoh: 2026-02-25T10:00:00Z.
  • SCHEDULE_END_TIME: stempel waktu saat jadwal audit berhenti. Contoh: 2027-02-25T10:00:00Z.
  • FREQUENCY: frekuensi proses audit terjadwal. Dapat berupa salah satu dari: DAILY, WEEKLY, MONTHLY, QUARTERLY, atau ANNUALLY. Misalnya: DAILY.
  • TIME_ZONE: zona waktu untuk jadwal audit dalam format IANA. Variabel ini digunakan untuk menafsirkan start_time dan end_time. Jika tidak ditentukan, defaultnya adalah UTC. Misalnya: America/New_York.
  • SCHEDULE_STATE: status jadwal audit. Dapat berupa salah satu dari: SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED, atau SCHEDULE_STATE_DELETED. Contoh: SCHEDULE_STATE_ACTIVE.
  • AUDIT_SCHEDULE_ID: ID unik untuk jadwal audit.

Metode HTTP dan URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID

Meminta isi JSON:

{
  "display_name": "DISPLAY_NAME",
  "gcs_uri": "BUCKET_URI",
  "compliance_framework": "FRAMEWORK",
  "report_format": "AUDIT_REPORT_FORMAT",
  "schedule_config": {
    "start_time": "SCHEDULE_START_TIME",
    "end_time": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "time_zone": "TIME_ZONE"
  },
  "state": "SCHEDULE_STATE"
}

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/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID"

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/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-02-25T13:27:00Z"
}

Memperbarui audit terjadwal

Anda dapat menjeda, melanjutkan, dan menghentikan audit berulang. Jika ingin mengubah jadwal, Anda harus menghapus audit terjadwal yang ada, lalu membuat audit terjadwal baru.

Konsol

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

    Buka Audit Manager

  2. Di tab Jadwal, temukan audit terjadwal yang ingin Anda perbarui.

  3. Lakukan salah satu hal berikut:

    • Untuk menjeda jadwal audit, klik Jeda jadwal.

    • Untuk memulai ulang audit yang Anda jeda, klik Lanjutkan jadwal.

    • Untuk menghapus audit terjadwal, klik Hentikan jadwal.

REST

Untuk menjeda, melanjutkan, atau menghapus jadwal audit, kirim permintaan PATCH untuk memperbarui state jadwal audit.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: jenis resource. Nilai yang valid adalah organizations, folders, dan projects.
  • RESOURCE_ID: ID resource organisasi, project, atau folder. Contoh: 8767234.
  • LOCATION: lokasi endpoint Audit Manager API. Untuk mengetahui daftar endpoint yang tersedia, lihat Lokasi Audit Manager. Misalnya: us-central1
  • AUDIT_SCHEDULE_ID: ID jadwal audit yang akan diperbarui. Contoh: my-schedule-id.
  • SCHEDULE_STATE: status target untuk jadwal audit. Tetapkan ke salah satu opsi berikut:
    • SCHEDULE_STATE_PAUSED: untuk menjeda jadwal aktif.
    • SCHEDULE_STATE_ACTIVE: untuk melanjutkan jadwal yang dijeda.
    • SCHEDULE_STATE_DELETED: untuk menghentikan dan menghapus jadwal.

Metode HTTP dan URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

Meminta isi JSON:

{
  "state": "SCHEDULE_STATE"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

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

curl -X PATCH \
-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/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

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 PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-09-11T18:15:00Z"
}

Langkah berikutnya