Esegui la migrazione dell'infrastruttura di autenticazione dell'agente remoto

Supportata in:

Google SecOps SOAR

Questo documento descrive come eseguire la migrazione dell'infrastruttura degli agenti remoti utilizzando i service account Google Cloud . Questa migrazione riguarda solo l'infrastruttura di autenticazione. Non è necessario eseguire la migrazione o sostituire le istanze o gli host dell'agente remoto.

Autenticazione senza chiave: per configurare l'autenticazione senza chiave per gli agenti remoti senza archiviare i file delle chiavi JSON dei account di servizio sulle macchine host, consulta Autentica l'agente remoto con la federazione delle identità per i workload.

Prima di iniziare

Assicurati di disporre di quanto segue:

• Autorizzazioni necessarie per creare service account in Google Cloud.
• Ruoli richiesti per creare le chiavi dei account di servizio.
• Versione minima richiesta dell'agente remoto: 2.6.2 e successive.

Requisiti di rete e di Private Service Connect

Dopo aver eseguito la migrazione dell'infrastruttura di autenticazione, l'agente remoto comunica con l'API Chronicle tramite le API di Google standard anziché gli endpoint *.siemplify-soar.com legacy.

Lista consentita di endpoint in uscita

Verifica che il firewall consenta il traffico HTTPS in uscita sulla porta TCP 443 dall'host dell'agente remoto ai seguenti endpoint:

• Consenti il traffico HTTPS in uscita verso l'endpoint di posizione dell'API Google Security Operations Chronicle (<var>REGION</var>-chronicle.googleapis.com, configurato in ONE_PLATFORM_URL_DOMAIN, ad esempio asia-southeast1-chronicle.googleapis.com) e il nome host del publisher del tenant (SERVER_API_ROOT).
• Consenti il traffico HTTPS in uscita verso gli endpoint di autenticazione Google Cloud : oauth2.googleapis.com (per lo scambio di token dei account di servizio), sts.googleapis.com e iamcredentials.googleapis.com (per l'autenticazione senza chiave con federazione delle identità per i workload).
• Consenti il traffico HTTPS in uscita verso i container registry utilizzati per i deployment Podman o Docker, ad esempio *.pkg.dev (incluso us-docker.pkg.dev) e gcr.io per Artifact Registry o docker.io.

Nota: il formato dell'endpoint regionale (chronicle.<var>REGION</var>.rep.googleapis.com) non è supportato per la connettività del control plane dell'agente remoto.

Per saperne di più, consulta Requisiti di rete e firewall.

Configurazione di Private Service Connect

Se l'agente remoto si connette privatamente alle API di Google (ad esempio da una rete on-premise, Amazon Web Services (AWS) o Microsoft Azure tramite Cloud Interconnect o Cloud VPN), completa la seguente configurazione:

1. Crea un endpoint Private Service Connect per le API di Google (utilizzando il bundle all-apis o vpc-sc) nel tuo Virtual Private Cloud. Per istruzioni, consulta Configura Private Service Connect per le API di Google.
2. Configura il DNS privato in modo che gli endpoint richiesti vengano risolti nell'indirizzo IP dell'endpoint Private Service Connect. In Google Cloud, configura una zona Cloud DNS privata per googleapis.com. Al di fuori diGoogle Cloud, utilizza il forwarding DNS condizionale o una zona ospitata privata (come AWS Route 53).
3. Mantieni attiva qualsiasi connessione Private Service Connect SOAR legacy (un collegamento al servizio producer per <var>TENANT</var>.siemplify-soar.com) fino al completamento della migrazione di tutti gli agenti remoti.

Crea un account di servizio

Un account di servizio è un tipo speciale di Account Google utilizzato da un'applicazione per effettuare chiamate API autorizzate.

Importante: assegna un account di servizio univoco a ogni agente remoto. Poiché i service account sono soggetti a limiti di frequenza e quote API individuali, la condivisione di un account di servizio tra più agenti può esaurire le quote e causare errori di comunicazione.

Per creare un account di servizio, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Service account.
Vai a Service account
2. Fai clic su Crea account di servizio.
3. Nella sezione Dettagli service account, segui questi passaggi:
   1. Inserisci un nome per il account di servizio.
   2. Inserisci una descrizione per il account di servizio.
   3. Fai clic su Crea e continua.
4. Nella sezione Autorizzazioni, segui questi passaggi:
   1. Nell'elenco Seleziona un ruolo, seleziona il ruolo Chronicle SOAR Remote Agent.
   2. Fai clic su Continua.
5. Nella sezione Concedi agli utenti l'accesso a questo service account, fai clic su Fine.

Crea una chiave dell'account di servizio

La chiave del account di servizio è necessaria per autenticare l'agente remoto. Per creare questa chiave, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Service account.
Vai a Service account
2. Fai clic sul nome del account di servizio che hai creato.
3. Fai clic sulla scheda Chiavi.
4. Fai clic su Aggiungi chiave > Crea nuova chiave.
5. Seleziona JSON come tipo di chiave e fai clic su Crea.

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

6. Fai clic su Chiudi.

Archivia in modo sicuro il file di chiave

Dopo aver scaricato la chiave del account di servizio, devi spostarla sulla macchina host in cui verrà eseguito l'agente remoto.

Avviso: non eseguire il commit di questo file della chiave nel repository del codice sorgente. Trattala come una password riservata.

Podman

1. Individua il file JSON scaricato sul computer.
2. Archivia il file in una posizione sicura sulla macchina host in cui il processo dell'agente può accedervi.
3. Inserisci il percorso completo della chiave del account di servizio dell'agente sulla macchina host.

   AGENT_SERVICE_ACCOUNT_PATH

Docker

1. Individua il file JSON scaricato sul computer.
2. Archivia il file in una posizione sicura sulla macchina host in cui il processo dell'agente può accedervi.
3. Inserisci il percorso completo della chiave dell'account di servizio dell'agente sulla macchina host.

   AGENT_SERVICE_ACCOUNT_PATH

Installer

1. Individua il file JSON scaricato sul computer.
2. Archivia il file nella seguente posizione:

   AGENT_SERVICE_ACCOUNT_PATH

3. Prendi nota del percorso completo di questo file, poiché sarà necessario quando configuri l'agente remoto.

Mappa il account di servizio dell'agente remoto

Dopo aver creato l'account di servizio per l'agente remoto, devi autorizzarlo all'interno della piattaforma per assicurarti che possa comunicare correttamente con Google SecOps.

Per concedere l'accesso a un service account o l'accesso alla federazione delle identità dei workload a Google SecOps, devi mappare l'identità ai parametri di controllo dell'accesso della piattaforma. Questa mappatura è un passaggio obbligatorio per fornire all'identità l'accesso necessario ai ruoli SOC e agli ambienti richiesti per eseguire attività automatizzate o operazioni API.

1. Vai a Impostazioni SOAR > Avanzate > Mappatura dei gruppi.
2. Fai clic su add Aggiungi.

3. Completa i campi nella finestra di dialogo Aggiungi mappatura per mappare l'identità ai parametri di controllo dell'accesso della piattaforma.

   1. Nel campo IdP / User group (IdP/Gruppo di utenti), inserisci uno dei seguenti valori:
      • L'indirizzo email completo del tuo account di servizio, se l'identità è stata configurata utilizzando Cloud Identity.
      • La stringa dell'entità Workload Identity, se l'identità è stata configurata utilizzando la federazione delle identità per la forza lavoro.

   2. Configura i seguenti campi di controllo dell'accesso:

      Campo	Descrizione
      Gruppi di autorizzazioni	Seleziona i gruppi di autorizzazioni per definire i moduli e i sottomoduli a cui l'identità può accedere.
      Ruoli del SOC	Seleziona i ruoli SOC per definire il ruolo dell'identità (ad esempio Tier 1).
      Ambienti	Seleziona gli ambienti o i gruppi di ambienti a cui l'identità può accedere (ad esempio Tutti gli ambienti).
      Membri del gruppo	Inserisci le email degli utenti richieste, se applicabile. Premi Invio dopo aver aggiunto ogni email.
      Azioni limitate	Seleziona le azioni limitate per limitare operazioni specifiche all'interno dei moduli.

4. Fai clic su Aggiungi.

Configura l'autenticazione dell'agente remoto per Google Cloud

Podman

Se stai eseguendo il deployment di un nuovo agente, leggi Esegui il deployment di un agente con Podman.

Se stai eseguendo l'upgrade di un agente, consulta Esegui l'upgrade di un agente con Podman.

Docker

Se stai eseguendo il deployment di un nuovo agente, leggi Esegui il deployment di un agente con Docker.

Se stai eseguendo l'upgrade di un agente, leggi Esegui l'upgrade di un agente con Docker.

Installer

Se stai eseguendo il deployment di un nuovo agente, leggi Esegui il deployment di un agente con CentOS o Esegui il deployment di un agente con RHEL.

Se stai eseguendo l'upgrade di un agente, leggi Esegui l'upgrade di un agente con CentOS o Esegui l'upgrade di un agente con RHEL

Esegui la migrazione delle variabili di ambiente per l'agente esistente

Nota: questo passaggio può essere saltato per gli agenti remoti installati dopo il 10 maggio 2026 perché le variabili di ambiente sono presenti nel comando container/file .env.

Vai a Impostazioni SOAR > Avanzate > Agenti remoti e fai clic su Visualizza altro sull'agente remoto richiesto.

Copia i seguenti valori dal campo Docker Command e incollali nei seguenti comandi.
Li utilizzerai nella procedura di migrazione:

• 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

Per eseguire la migrazione delle variabili di ambiente dell'agente remoto, segui questi passaggi:

1. Elenca i container Podman in esecuzione.

   podman ps

2. Inserisci l'ID contenitore dell'agente:

   CONTAINER_ID

3. Incolla le seguenti variabili di ambiente delle procedure precedenti ed esegui questo comando:

   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

Per eseguire la migrazione delle variabili di ambiente dell'agente remoto, segui questi passaggi:

1. Elenca i container Docker in esecuzione.

   docker ps

2. Inserisci l'ID contenitore dell'agente:

   CONTAINER_ID

3. Incolla le seguenti variabili di ambiente delle procedure precedenti ed esegui questo comando:

   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'

Installer

Per eseguire la migrazione delle variabili di ambiente dell'agente remoto, segui questi passaggi:

Incolla le seguenti variabili di ambiente delle procedure precedenti ed esegui questo comando:

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

Esegui la migrazione del account di servizio nell'agente remoto

Una volta completato questo passaggio e quando tutte le variabili di ambiente sono presenti nell'agente remoto, la migrazione è completata e l'agente remoto comunicherà tramite Google Cloud

Podman

Per eseguire la migrazione dell'infrastruttura di autenticazione dell'agente remoto, segui questi passaggi:

1. Elenca i container Podman in esecuzione.

   podman ps

2. Inserisci l'ID contenitore dell'agente:

   CONTAINER_ID

3. Utilizza il comando seguente per copiare la chiave del account di servizio in un percorso dedicato nel container.

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

4. Utilizza il seguente comando per modificare il proprietario della chiave del account di servizio nel container:

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

5. Esegui il comando seguente per applicare le modifiche:

   podman restart CONTAINER_ID

Docker

Per eseguire la migrazione dell'infrastruttura di autenticazione dell'agente remoto, segui questi passaggi:

1. Elenca i container Docker in esecuzione.

   docker ps

2. Inserisci l'ID contenitore dell'agente:

   CONTAINER_ID

3. Utilizza il comando seguente per copiare la chiave del account di servizio in un percorso dedicato nel container.

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

4. Utilizza il seguente comando per modificare il proprietario della chiave del account di servizio nel container:

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

5. Esegui il comando seguente per applicare le modifiche:

   docker restart CONTAINER_ID

Installer

Per eseguire la migrazione dell'infrastruttura di autenticazione dell'agente remoto, segui questi passaggi:

1. Sposta il service account nel percorso previsto

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

2. Utilizza il seguente comando per modificare il proprietario della chiave del account di servizio nel container:

   chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

3. Esegui questo comando per riavviare il servizio dell'agente:

   supervisorctl restart siemplify_agent

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.