Mengautentikasi Agen Jarak Jauh dengan Workload Identity Federation

Didukung di:

Dokumen ini menjelaskan cara mengonfigurasi autentikasi tanpa kunci untuk Agen Jarak Jauh Google SecOps menggunakan Workload Identity Federation (WIF). Workload Identity Federation menghilangkan kebutuhan untuk mendownload, mengelola, dan menyimpan file kunci JSON akun layanan yang berumur panjang di lingkungan host agen jarak jauh.

Dengan Workload Identity Federation, Agen Jarak Jauh yang berjalan di penyedia cloud eksternal, infrastruktur lokal, cluster Kubernetes, atau pipeline CI/CD menggunakan token akses Google Cloud gabungan berumur pendek yang berasal dari penyedia identitas eksternal mereka.

Sebelum memulai

Sebelum mengonfigurasi Workload Identity Federation, verifikasi prasyarat berikut:

  • Versi Agen Jarak Jauh minimum 2.6.2 atau yang lebih baru.
  • Pengguna yang mengonfigurasi Workload Identity Federation harus memiliki izin IAM yang diperlukan di Google Cloud untuk membuat dan mengelola Workload Identity Pool (roles/iam.workloadIdentityPoolAdmin) dan Akun Layanan (roles/iam.serviceAccountAdmin).
  • Akun Layanan khusus yang dibuat di Google Cloud dengan peran Chronicle SOAR Remote Agent (roles/chronicle.soarRemoteAgent). Untuk mengetahui langkah-langkah membuat akun layanan, lihat Membuat akun layanan.
  • Akses ke Penyedia Identitas eksternal Anda (AWS, Azure, Active Directory/ADFS, Kubernetes, pipeline CI/CD, CA X.509, atau penyedia OIDC/SAML kustom).
  • Firewall Anda harus mengizinkan traffic HTTPS keluar (port TCP 443) dari host Agen Jarak Jauh ke sts.googleapis.com, iamcredentials.googleapis.com, dan endpoint lokasi Chronicle API Anda (REGION-chronicle.googleapis.com, yang dikonfigurasi di ONE_PLATFORM_URL_DOMAIN). Untuk mengetahui detail lengkap daftar yang diizinkan dan Private Service Connect, lihat Persyaratan Jaringan dan Private Service Connect serta Persyaratan jaringan dan firewall.

Langkah 1: Buat Workload Identity Pool dan Penyedia Workload Identity

Di Google Cloud, Workload Identity Pool mengelola identitas eksternal, sedangkan Workload Identity Provider menentukan parameter koneksi antara IdP eksternal Anda dan Google Cloud.

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools. Buka Workload Identity Pool
  2. Klik Create Pool.
  3. Masukkan Name dan Description untuk pool (misalnya, soar-remote-agent-pool).
  4. Klik Lanjutkan.
  5. Di bagian Add a provider to pool, pilih jenis penyedia Anda dan masukkan detail koneksi penyedia (seperti ID Akun AWS atau Penerbit dan Audiens OIDC) dari panduan penyedia Anda.
  6. Di bagian Configure attribute mappings, petakan klaim dari token eksternal Anda (seperti google.subject=assertion.sub) ke atribut IAM Google Cloud seperti yang ditentukan dalam panduan penyedia Anda.
  7. Klik Simpan.

Langkah 2: Memberikan Izin Peniruan Akun Layanan

Izinkan identitas eksternal di Workload Identity Pool Anda untuk meniru identitas Akun Layanan Agen Jarak Jauh Anda.

  1. Di konsol Google Cloud , buka halaman Service Accounts.
  2. Pilih Akun Layanan Agen Jarak Jauh Anda.
  3. Klik tab Principals with access.
  4. Klik Grant access.
  5. Di kolom New principals, masukkan ID akun utama yang sesuai dengan Workload Identity Pool Anda:
    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
  6. Di daftar Select a role, pilih Workload Identity User (roles/iam.workloadIdentityUser).
  7. Klik Simpan.

Langkah 3: Download atau buat Kredensial Akun Eksternal (agent-key.json)

Di mesin host Agen Jarak Jauh, dapatkan file konfigurasi kredensial akun eksternal bernama agent-key.json menggunakan salah satu opsi berikut.

Opsi A: Download dari konsol Google Cloud (Direkomendasikan)

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.
  2. Pilih Workload Identity Pool Anda, lalu klik Grant access.
  3. Di panel Grant access, pilih Grant access using service account impersonation.
  4. Dalam daftar Select service account, pilih Akun Layanan Agen Jarak Jauh Anda.
  5. Di bagian Select principals (identities that can access the service account), tentukan identitas yang dapat mengakses akun layanan (seperti memilih nama dan nilai atribut).
  6. Klik Simpan.
  7. Di jendela Configure your application:
    • Pilih Workload Identity Provider Anda.
    • Di kolom jalur token ID OIDC, masukkan jalur persis tempat token eksternal Anda dipasang atau disimpan (untuk token yang diproyeksikan Kubernetes, jalur ini harus cocok dengan mountPath + path yang ditentukan dalam manifes pod Anda, seperti /var/run/secrets/tokens/gcp-kms-token).
    • Tetapkan Format type ke Text (string JWT mentah). Jangan pilih JSON untuk file token standar.
    • Klik Download config dan simpan file sebagai agent-key.json (atau ganti nama file yang didownload menjadi agent-key.json).
  8. Transfer file agent-key.json ke mesin host Agen Jarak Jauh Anda.

Opsi B: Membuat menggunakan gcloud CLI

Jalankan perintah gcloud iam workload-identity-pools create-cred-config untuk membuat file konfigurasi kredensial:

gcloud iam workload-identity-pools create-cred-config \
    projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \
    --service-account=SERVICE_ACCOUNT_EMAIL \
    --output-file=agent-key.json \
    --credential-source-file=/var/run/secrets/tokens/gcp-kms-token

Referensi Contoh File Konfigurasi

Sebagai referensi, file agent-key.json yang dihasilkan berisi struktur yang mirip dengan berikut ini:

{
  "type": "external_account",
  "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID",
  "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
  "token_url": "https://sts.googleapis.com/v1/token",
  "credential_source": {
    "file": "/var/run/secrets/tokens/gcp-kms-token"
  },
  "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken"
}

Langkah 4: Memetakan Akun Layanan di Google SecOps

Sebelum men-deploy Agen Jarak Jauh, beri otorisasi alamat email Akun Layanan dalam Google SecOps:

  1. Buka Settings > Access Management > Group Mapping.
  2. Klik add Add.
  3. Dalam dialog Add Role, masukkan alamat email akun layanan lengkap di kolom IAM Role / IdP group.
  4. Pilih Environments yang sesuai yang akan dikelola oleh agen jarak jauh.
  5. Klik Tambahkan.

Langkah 5: Deploy atau Update Autentikasi Agen Jarak Jauh

Podman

Untuk mengonfigurasi autentikasi Agen Jarak Jauh di Podman, ikuti langkah-langkah berikut:

  1. Mencantumkan container Podman yang berjalan:
    podman ps
  2. Masukkan ID penampung agen Anda:
    CONTAINER_ID
  3. Gunakan perintah berikut untuk menyalin file konfigurasi kredensial ke jalur khusus di container:

    podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. Gunakan perintah berikut untuk mengubah pemilik file konfigurasi kredensial dalam container:

    podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. Jalankan perintah berikut untuk menerapkan perubahan:
    podman restart CONTAINER_ID

Docker

Untuk mengonfigurasi autentikasi Agen Jarak Jauh di Docker, ikuti langkah-langkah berikut:

  1. Mencantumkan container Docker yang berjalan:
    docker ps
  2. Masukkan ID penampung agen Anda:
    CONTAINER_ID
  3. Gunakan perintah berikut untuk menyalin file konfigurasi kredensial ke jalur khusus di container:

    docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. Gunakan perintah berikut untuk mengubah pemilik file konfigurasi kredensial dalam container:

    docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. Jalankan perintah berikut untuk menerapkan perubahan:
    docker restart CONTAINER_ID

Penginstal

Untuk mengonfigurasi autentikasi Agen Jarak Jauh di CentOS/RHEL, ikuti langkah-langkah berikut:

  1. Pindahkan file konfigurasi kredensial ke jalur yang diharapkan:

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. Gunakan perintah berikut untuk mengubah pemilik file konfigurasi kredensial:

    chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  3. Jalankan perintah berikut untuk memulai ulang layanan agen:
    supervisorctl restart siemplify_agent

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