Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Memigrasikan infrastruktur autentikasi agen jarak jauh

Didukung di:

Google SecOps SOAR

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 Agen Jarak Jauh minimum yang diperlukan adalah 2.6.2 dan yang lebih baru.

Persyaratan jaringan dan Private Service Connect

Setelah Anda memigrasikan infrastruktur autentikasi, Agen Jarak Jauh akan berkomunikasi dengan Chronicle API melalui Google API standar, bukan endpoint *.siemplify-soar.com lama.

Daftar yang diizinkan untuk endpoint keluar

Pastikan firewall Anda mengizinkan traffic HTTPS keluar di port TCP 443 dari host Agen Jarak Jauh ke endpoint berikut:

Izinkan traffic HTTPS keluar ke endpoint lokasi Google Security Operations Chronicle API Anda (<var>REGION</var>-chronicle.googleapis.com, yang dikonfigurasi di ONE_PLATFORM_URL_DOMAIN, seperti asia-southeast1-chronicle.googleapis.com) dan nama host Publisher tenant Anda (SERVER_API_ROOT).
Izinkan traffic HTTPS keluar ke endpoint autentikasi Google Cloud : oauth2.googleapis.com (untuk pertukaran token akun layanan), sts.googleapis.com, dan iamcredentials.googleapis.com (untuk autentikasi tanpa kunci dengan Workload Identity Federation).
Izinkan traffic HTTPS keluar ke container registry yang digunakan untuk deployment Podman atau Docker, seperti *.pkg.dev (termasuk us-docker.pkg.dev) dan gcr.io untuk Artifact Registry, atau docker.io.

Untuk mengetahui informasi selengkapnya, lihat Persyaratan jaringan dan firewall.

Konfigurasi Private Service Connect

Jika Agen Jarak Jauh Anda terhubung ke Google API secara pribadi (misalnya, dari jaringan lokal, Amazon Web Services (AWS), atau Microsoft Azure melalui Cloud Interconnect atau Cloud VPN), selesaikan konfigurasi berikut:

Buat endpoint Private Service Connect untuk Google API (menggunakan paket all-apis atau vpc-sc) di Virtual Private Cloud Anda. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Private Service Connect untuk Google API.
Konfigurasi DNS pribadi agar endpoint yang diperlukan di-resolve ke alamat IP endpoint Private Service Connect Anda. Di Google Cloud, konfigurasikan zona pribadi Cloud DNS untuk googleapis.com. Di luar Google Cloud, gunakan penerusan DNS bersyarat atau zona yang dihosting pribadi (seperti AWS Route 53).
Tetap aktifkan koneksi Private Service Connect SOAR lama (lampiran layanan produsen untuk <var>TENANT</var>.siemplify-soar.com) hingga Anda selesai memigrasikan semua Agen Jarak Jauh.

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:

Di konsol Google Cloud , buka halaman Service Accounts.

Buka Akun Layanan

Klik Create Service Account.
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.
Di bagian Permissions, lakukan tindakan berikut:
1. Di daftar Select a role, pilih peran Chronicle SOAR Remote Agent.
2. Klik Lanjutkan.
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:

Di konsol Google Cloud , buka halaman Service Accounts.

Buka Akun Layanan

Klik nama akun layanan yang Anda buat.
Klik tab Kunci.
Klik Add Key > Create new key.

Pilih JSON sebagai jenis kunci dan klik Create.

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

Klik Close.

Simpan file kunci dengan aman

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

Podman

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

Docker

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

Penginstal

Temukan file JSON yang didownload di komputer Anda.
Simpan file di lokasi berikut:
```
AGENT_SERVICE_ACCOUNT_PATH
```
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 mengizinkannya dalam platform untuk memastikan agen 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.

Buka Settings > Access Management > Group Mapping.
Klik add Add.

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

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

Konfigurasikan kolom kontrol akses berikut:

Kolom	Deskripsi
Grup izin	Pilih grup izin untuk menentukan modul dan submodul yang dapat diakses oleh identitas.
Peran SOC	Pilih peran SOC untuk menentukan peran identitas (seperti Tingkat 1).
Lingkungan	Pilih lingkungan atau grup lingkungan yang dapat diakses oleh 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.

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 SOAR Settings > Advanced > Remote Agents dan klik View More pada agen jarak jauh yang diperlukan.

Salin nilai berikut dari kolom Docker Command dan tempelkan dalam 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:

Mencantumkan container Podman yang berjalan.
```
podman ps
```
Masukkan ID penampung agen Anda:
```
CONTAINER_ID
```

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:

Mencantumkan container Docker yang berjalan.
```
docker ps
```
Masukkan ID penampung agen Anda:
```
CONTAINER_ID
```

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:

Mencantumkan container Podman yang berjalan.
```
podman ps
```
Masukkan ID penampung agen Anda:
```
CONTAINER_ID
```
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
```

Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan dalam container:

podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

Jalankan perintah berikut untuk menerapkan perubahan:
```
podman restart CONTAINER_ID
```

Docker

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

Mencantumkan container Docker yang berjalan.
```
docker ps
```
Masukkan ID penampung agen Anda:
```
CONTAINER_ID
```
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
```

Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan dalam container:

docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

Jalankan perintah berikut untuk menerapkan perubahan:
```
docker restart CONTAINER_ID
```

Penginstal

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

Memindahkan Akun Layanan ke jalur yang diharapkan

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

Gunakan perintah berikut untuk mengubah pemilik kunci akun layanan dalam container:
```
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
```
Jalankan perintah berikut untuk memulai ulang layanan agen:
```
supervisorctl restart siemplify_agent
```

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