Mengintegrasikan Akeyless dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Akeyless dengan Google Security Operations.

Kasus penggunaan

Integrasi Akeyless menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

  • Menyinkronkan kredensial integrasi: Perbarui kredensial dan parameter sensitif secara otomatis di seluruh instance, konektor, dan tugas integrasi Google SecOps menggunakan secret yang disimpan di Akeyless.

  • Mengambil secret di playbook: Ambil secret statis atau versi secret tertentu dari Akeyless sesuai permintaan selama eksekusi playbook untuk melakukan autentikasi dengan layanan eksternal.

  • Otomatiskan rotasi kredensial: Sebarkan kunci API, token, dan sandi yang dirotasi dari Akeyless ke integrasi, konektor, dan tugas Google SecOps dengan memetakan parameter ke versi rahasia latest, sehingga mencegah gangguan yang disebabkan oleh kredensial yang sudah tidak berlaku.

  • Mengontrol pembaruan kredensial dengan penyematan versi: Sematkan parameter integrasi, konektor, atau tugas ke versi rahasia tertentu di Akeyless untuk memvalidasi perubahan kredensial atau melakukan roll back ke versi sebelumnya jika diperlukan.

  • Menghilangkan rahasia yang di-hardcode dalam alur kerja: Memusatkan kredensial sensitif di Akeyless, bukan menyematkannya langsung dalam input playbook atau skrip kustom, sehingga mengurangi eksposur kredensial di seluruh alur kerja SOC.

Sebelum memulai

Sebelum mengonfigurasi integrasi di platform Google SecOps, pastikan Anda memiliki hal berikut:

  • Kredensial kunci API: ID Akses dan Kunci Akses Akeyless untuk autentikasi.

    Untuk mengetahui informasi selengkapnya, lihat Autentikasi Kunci API Tanpa Kunci.

  • Izin akses: Izin baca yang diberikan ke metode autentikasi Anda untuk rahasia yang diambil oleh Google SecOps.

    Untuk mengetahui informasi selengkapnya, lihat Role-Based Access Control (RBAC) Akeyless.

  • Konektivitas jaringan: Akses jaringan dari instance Google SecOps atau agen jarak jauh ke URL Gateway API Akeyless Anda.

Parameter integrasi

Integrasi Akeyless memerlukan parameter berikut:

Parameter Deskripsi
API Gateway URL

Opsional.

URL Gateway API Akeyless Anda.

Nilai defaultnya adalah https://api.akeyless.io.
Access ID

Wajib.

ID akses untuk metode autentikasi kunci API Akeyless Anda.
Access Key

Wajib.

Kunci akses yang terkait dengan ID akses Akeyless Anda.
Verify SSL

Wajib.

Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Akeyless.

Diaktifkan secara default.

Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan pada tahap berikutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan tertunda dari Ruang Kerja Anda dan Melakukan tindakan manual.

Mendapatkan Nilai Secret

Gunakan tindakan Get Secret Value untuk mengambil nilai rahasia dari Akeyless untuk digunakan dalam playbook.

Tindakan ini tidak dijalankan pada entity Google SecOps.

Input tindakan

Tindakan Get Secret Value memerlukan parameter berikut:

Parameter Deskripsi
Secret Name

Wajib.

Nama atau jalur secret yang akan diambil dari Akeyless.

Untuk mengambil versi terbaru, masukkan SECRET_NAME atau SECRET_NAME:latest.

Untuk mengambil versi tertentu, masukkan SECRET_NAME:VERSION_NUMBER, dengan VERSION_NUMBER adalah bilangan bulat positif (misalnya, /prod/api-key:2).

Output tindakan

Tindakan Get Secret Value memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Get Secret Value:

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Pesan output

Di Case Wall, tindakan Get Secret Value memberikan pesan output berikut:

Pesan output Deskripsi pesan
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Tindakan berhasil.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

Tindakan gagal.

Pastikan jalur dan versi secret ada di Akeyless dan kredensial autentikasi Anda memiliki akses baca ke secret tersebut.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

Tindakan gagal.

Verifikasi format parameter Secret Name.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Get Secret Value:

Nama hasil skrip Nilai
is_success true atau false

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke server Akeyless.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Di Case Wall, tindakan Ping memberikan pesan output berikut:

Pesan output Deskripsi pesan
Successfully connected to the Akeyless server with the provided connection parameters! Tindakan berhasil.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

Tindakan gagal.

Verifikasi setelan API Gateway URL, Access ID, Access Key, dan SSL Anda.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:

Nama hasil skrip Nilai
is_success true atau false

Pekerjaan

Untuk mengetahui informasi selengkapnya tentang tugas, lihat Mengonfigurasi tugas baru dan Penjadwalan lanjutan.

Tugas Sinkronisasi Kredensial Integrasi

Gunakan Sync Integration Credentials Job untuk menyinkronkan secret yang disimpan di Akeyless secara otomatis dengan instance, konektor, dan tugas integrasi Google SecOps yang Anda konfigurasi.

Parameter tugas

Tugas Kredensial Integrasi Sinkronisasi memerlukan parameter berikut:

Parameter Deskripsi
API Gateway URL

Opsional.

URL Gateway API Akeyless Anda.

Nilai defaultnya adalah https://api.akeyless.io.
Access ID

Wajib.

ID akses untuk metode autentikasi kunci API Akeyless Anda.
Access Key

Wajib.

Kunci akses yang terkait dengan ID akses Akeyless Anda.
Verify SSL

Wajib.

Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Akeyless.

Diaktifkan secara default.
Environment Name

Wajib.

Lingkungan Google SecOps tempat instance integrasi, konektor, dan tugas target dikonfigurasi.

Nilai defaultnya adalah Default Environment.
Credential Mapping

Wajib.

Kamus JSON atau YAML yang memetakan instance integrasi, konektor, dan tugas target ke secret Akeyless yang berisi nilai parameternya.

Sertakan setidaknya satu parameter yang dipetakan di bagian kunci integration_instances, connectors, atau jobs.

Untuk melihat contoh, lihat Contoh Credential Mapping.

Nilai defaultnya adalah {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Contoh Credential Mapping

Contoh berikut menunjukkan cara memetakan parameter untuk instance integrasi, konektor, dan tugas dalam parameter Credential Mapping:

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.