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

Supportato in:

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.

Prima di iniziare

Assicurati di disporre di quanto segue:

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

Crea un account di servizio

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

Per creare un service account:

  1. Nella console Google Cloud , vai alla pagina Service account.
    2. 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 del service account

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

  1. Nella console Google Cloud , vai alla pagina Service account.
    2. 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.

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 dell'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, perché ti servirà quando configurerai 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à per i 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 a ruoli SOC e ambienti richiesti per eseguire attività automatizzate o operazioni API.

  1. Vai a Impostazioni SOAR > Avanzate > Mappatura gruppi.
  2. Fai clic su Aggiungi 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 / 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 SOC Seleziona i ruoli SOC per definire il ruolo dell'identità (ad esempio Livello 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 su 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, leggi Eseguire l'upgrade di un agente con Podman.

Docker

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

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

Programma di installazione

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 Eseguire l'upgrade di un agente con CentOS o Eseguire l'upgrade di un agente con RHEL

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

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

Copia i seguenti valori dal campo Comando Docker 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:

  1. Elenca i container Podman in esecuzione. 
    podman ps
  2. Inserisci l'ID contenitore del tuo agente: 
    CONTAINER_ID

  3. Incolla le seguenti variabili di ambiente dalle 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 del tuo agente: 
    CONTAINER_ID

  3. Incolla le seguenti variabili di ambiente dalle 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'

Programma di installazione

Per eseguire la migrazione delle variabili di ambiente dell'agente remoto:

Incolla le seguenti variabili di ambiente dalle 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:

  1. Elenca i container Podman in esecuzione. 
    podman ps
  2. Inserisci l'ID contenitore dell'agente: 
    CONTAINER_ID

  3. Utilizza il seguente comando 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:

  1. Elenca i container Docker in esecuzione. 
    docker ps
  2. Inserisci l'ID contenitore del tuo agente: 
    CONTAINER_ID

  3. Utilizza il seguente comando 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

Programma di installazione

Per eseguire la migrazione dell'infrastruttura di autenticazione dell'agente remoto:

  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.