Memigrasikan infrastruktur autentikasi agen jarak jauh

Didukung di:

Dokumen ini menjelaskan cara memigrasikan Infrastruktur Agen Jarak Jauh menggunakan Akun Layanan Google Cloud . Migrasi ini hanya untuk infrastruktur autentikasi. Anda tidak perlu memigrasikan atau mengganti instance atau host Agen Jarak Jauh.

Sebelum memulai

Pastikan Anda memiliki:

  • Izin yang diperlukan untuk membuat akun layanan di Google Cloud.
  • Peran yang diperlukan untuk membuat kunci akun layanan.
  • Versi minimum Remote Agent yang diperlukan adalah 2.6.2 dan yang lebih baru.

Membuat akun layanan

Akun layanan adalah jenis Akun Google khusus yang digunakan oleh aplikasi untuk melakukan panggilan API yang diotorisasi.

Untuk membuat akun layanan, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Service Accounts.
    2. Buka Akun Layanan
  2. Klik Create Service Account.
  3. Di bagian Service account details, lakukan hal berikut:
    1. Masukkan nama untuk akun layanan.
    2. Masukkan deskripsi untuk akun layanan.
    3. Klik Create and Continue.
  4. Di bagian Permissions, lakukan tindakan berikut:
    1. Di daftar Select a role, pilih peran Chronicle SOAR Remote Agent.
    2. Klik Lanjutkan.
  5. Di bagian Beri pengguna akses ke akun layanan ini, klik Selesai.

Membuat kunci akun layanan

Kunci akun layanan diperlukan untuk mengautentikasi agen jarak jauh. Untuk membuat kunci ini, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Service Accounts.
    2. Buka Akun Layanan
  2. Klik nama akun layanan yang Anda buat.
  3. Klik tab Kunci.
  4. Klik Add Key > Create new key.
  5. Pilih JSON sebagai jenis kunci dan klik Create.

    A JSON file containing the key is downloaded to your computer.

  6. Klik Close.

Menyimpan file kunci dengan aman

Setelah mendownload kunci akun layanan, Anda harus memindahkannya ke mesin host tempat agen jarak jauh akan berjalan.

Podman

  1. Temukan file JSON yang didownload di komputer Anda.
  2. Simpan file di lokasi yang aman di komputer host tempat proses agen dapat mengaksesnya.
  3. Masukkan jalur lengkap kunci akun layanan agen Anda di mesin host. 
    AGENT_SERVICE_ACCOUNT_PATH

Docker

  1. Temukan file JSON yang didownload di komputer Anda.
  2. Simpan file di lokasi yang aman di komputer host tempat proses agen dapat mengaksesnya.
  3. Masukkan jalur lengkap kunci akun layanan agen Anda di mesin host. 
    AGENT_SERVICE_ACCOUNT_PATH

Penginstal

  1. Temukan file JSON yang didownload di komputer Anda.
  2. Simpan file di lokasi berikut: 
    AGENT_SERVICE_ACCOUNT_PATH
  3. Catat jalur lengkap ke file ini, karena akan diperlukan saat Anda mengonfigurasi agen jarak jauh.

Memetakan akun layanan agen jarak jauh

Setelah membuat akun layanan untuk agen jarak jauh, Anda harus memberikan otorisasi di dalam platform untuk memastikan akun tersebut dapat berkomunikasi dengan Google SecOps.

Untuk memberikan akses akun layanan atau akses workload identity federation ke Google SecOps, Anda harus memetakan identitas ke parameter kontrol akses platform. Pemetaan ini adalah langkah wajib untuk memberikan akses yang diperlukan kepada identitas ke Peran SOC, dan Lingkungan yang diperlukan untuk melakukan tugas otomatis atau operasi API.

  1. Buka Setelan SOAR > Lanjutan > Pemetaan Grup.
  2. Klik tambahkan Tambahkan.

  3. Lengkapi kolom dalam dialog Add Mapping untuk memetakan identitas ke parameter kontrol akses platform.

    1. Di kolom IdP / grup pengguna, masukkan salah satu opsi berikut:
      • Alamat email lengkap akun layanan Anda, jika identitas disiapkan menggunakan Cloud Identity.
      • String utama Workload Identity, jika identitas disiapkan menggunakan Workforce Identity Federation.

    2. Konfigurasikan kolom kontrol akses berikut:

      Kolom Deskripsi
      Grup izin Pilih grup izin untuk menentukan modul dan submodul yang dapat diakses identitas.
      Peran SOC Pilih peran SOC untuk menentukan peran identitas (seperti Tingkat 1).
      Lingkungan Pilih lingkungan atau grup lingkungan yang dapat diakses identitas (seperti Semua Lingkungan).
      Anggota grup Masukkan email pengguna yang diperlukan jika ada. Tekan Enter setelah menambahkan setiap email.
      Tindakan yang dibatasi Pilih tindakan yang dibatasi untuk membatasi operasi tertentu dalam modul.

  4. Klik Tambahkan.

Mengonfigurasi Autentikasi Agen Jarak Jauh ke Google Cloud

Podman

Jika Anda men-deploy agen baru, baca Men-deploy agen dengan Podman.

Jika Anda mengupgrade agen, baca Mengupgrade agen dengan Podman.

Docker

Jika Anda men-deploy agen baru, baca Men-deploy agen dengan Docker.

Jika Anda mengupgrade agen, baca Mengupgrade agen dengan Docker.

Penginstal

Jika Anda men-deploy agen baru, baca Men-deploy agen dengan CentOS atau Men-deploy agen dengan RHEL.

Jika Anda mengupgrade agen, baca Mengupgrade agen dengan CentOS atau Mengupgrade agen dengan RHEL

Memigrasikan variabel lingkungan untuk agen yang ada

Buka Setelan SOAR > Lanjutan > Agen Jarak Jauh lalu klik Lihat Lainnya pada agen jarak jauh yang diperlukan.

Salin nilai berikut dari kolom Docker Command dan tempelkan di perintah berikut.
Anda akan menggunakannya dalam prosedur migrasi:

  • ONE PLATFORM URL DOMAIN. 
    ONE_PLATFORM_URL_DOMAIN
  • ONE PLATFORM URL PROJECT. 
    ONE_PLATFORM_URL_PROJECT
  • ONE PLATFORM URL LOCATION. 
    ONE_PLATFORM_URL_LOCATION
  • ONE PLATFORM URL INSTANCE. 
    ONE_PLATFORM_URL_INSTANCE

Podman

Untuk memigrasikan variabel lingkungan agen jarak jauh, ikuti langkah-langkah berikut:

  1. Mencantumkan container Podman yang sedang berjalan. 
    podman ps
  2. Masukkan ID penampung agen Anda: 
    CONTAINER_ID

  3. Tempel variabel lingkungan berikut dari prosedur sebelumnya dan jalankan perintah ini:

    podman exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Docker

Untuk memigrasikan variabel lingkungan agen jarak jauh, ikuti langkah-langkah berikut:

  1. Mencantumkan container Docker yang sedang berjalan. 
    docker ps
  2. Masukkan ID penampung agen Anda: 
    CONTAINER_ID

  3. Tempel variabel lingkungan berikut dari prosedur sebelumnya dan jalankan perintah ini:

    docker exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Penginstal

Untuk memigrasikan variabel lingkungan agen jarak jauh, ikuti langkah-langkah berikut:

Tempel variabel lingkungan berikut dari prosedur sebelumnya dan jalankan perintah ini:

cat << EOF >> /home/siemplify_agent/.bash_profile
export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN
export ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT
export ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION
export ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE
export GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json
EOF

Memigrasikan akun layanan ke Agen Jarak Jauh

Setelah langkah ini selesai, dan semua variabel lingkungan ada di agen jarak jauh, migrasi selesai dan agen jarak jauh akan berkomunikasi melalui Google Cloud

Podman

Untuk memigrasikan infrastruktur autentikasi agen jarak jauh, ikuti langkah-langkah berikut:

  1. Mencantumkan container Podman yang sedang berjalan. 
    podman ps
  2. Masukkan ID penampung agen Anda: 
    CONTAINER_ID

  3. Gunakan perintah berikut untuk menyalin kunci akun layanan ke jalur khusus di container.

    podman cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

  4. Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan di 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 memigrasikan infrastruktur autentikasi agen jarak jauh, 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 kunci akun layanan ke jalur khusus di container.

    docker cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

  4. Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan di 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 memigrasikan infrastruktur autentikasi agen jarak jauh, ikuti langkah-langkah berikut:

  1. Memindahkan Akun Layanan ke jalur yang diharapkan

    mv AGENT_SERVICE_ACCOUNT_PATH /opt/SiemplifyAgent/agent-key.json

  2. Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan di container:

    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.