Autentica l'agente remoto con la federazione delle identità per i workload

Supportata in:

Questo documento descrive come configurare l'autenticazione senza chiave per gli agenti remoti di Google SecOps utilizzando la federazione delle identità per i workload (WIF). La federazione delle identità per i workload elimina la necessità di scaricare, gestire e archiviare file di chiavi JSON degli account di servizio di lunga durata negli ambienti host degli agenti remoti.

Con la federazione delle identità per i workload, gli agenti remoti in esecuzione su provider cloud esterni, infrastrutture on-premise, cluster Kubernetes o pipeline CI/CD utilizzano token di accesso Google Cloud federati di breve durata derivati dal provider di identità esterno.

Prima di iniziare

Prima di configurare la federazione delle identità per i workload, verifica i seguenti prerequisiti:

  • Versione minima dell'agente remoto 2.6.2 o successive.
  • L'utente che configura la federazione delle identità dei workload deve disporre delle autorizzazioni IAM richieste in Google Cloud per creare e gestire i pool di identità dei workload (roles/iam.workloadIdentityPoolAdmin) e i service account (roles/iam.serviceAccountAdmin).
  • Un service account dedicato creato in Google Cloud con il ruolo Chronicle SOAR Remote Agent (roles/chronicle.soarRemoteAgent). Per i passaggi per creare un account di servizio, consulta Crea un service account.
  • Accesso al tuo provider di identità esterno (AWS, Azure, Active Directory/ADFS, Kubernetes, pipeline CI/CD, CA X.509 o provider OIDC/SAML personalizzato).
  • Il firewall deve consentire il traffico HTTPS in uscita (porta TCP 443) dall'host dell'agente remoto a sts.googleapis.com, iamcredentials.googleapis.com e all'endpoint di posizione dell'API Chronicle (REGION-chronicle.googleapis.com, configurato in ONE_PLATFORM_URL_DOMAIN). Per i dettagli completi sulla lista consentita e su Private Service Connect, consulta Requisiti di rete e di Private Service Connect e Requisiti di rete e firewall.

Passaggio 1: crea un pool di identità del workload e un provider

In Google Cloud, i pool di identità del workload gestiscono le identità esterne, mentre i provider di identità del workload definiscono i parametri di connessione tra il tuo IdP esterno e Google Cloud.

  1. Nella console Google Cloud , vai alla pagina Pool di identità del workload. Vai a Pool di identità del workload
  2. Fai clic su Crea pool.
  3. Inserisci un nome e una descrizione per il pool (ad esempio, soar-remote-agent-pool).
  4. Fai clic su Continua.
  5. Nella sezione Aggiungi un provider al pool, seleziona il tipo di provider e inserisci i dettagli di connessione del provider (ad esempio l'ID account AWS o l'emittente e il pubblico OIDC) dalla guida del provider.
  6. Nella sezione Configura mappature degli attributi, mappa le rivendicazioni del token esterno (ad esempio google.subject=assertion.sub) agli attributi IAM Google Cloud come specificato nella guida del provider.
  7. Fai clic su Salva.

Passaggio 2: concedi le autorizzazioni di simulazione dell'identità dei service account

Consenti alle identità esterne nel tuo pool di identità del workload di assumere l'identità del tuo service account dell'agente remoto.

  1. Nella console Google Cloud , vai alla pagina Service account.
  2. Seleziona il service account dell'agente remoto.
  3. Fai clic sulla scheda Entità con accesso.
  4. Fai clic su Concedi l'accesso.
  5. Nel campo Nuove entità, inserisci l'identificatore dell'entità corrispondente al tuo pool di identità del workload:
    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
  6. Nell'elenco Seleziona un ruolo, seleziona Utente Workload Identity (roles/iam.workloadIdentityUser).
  7. Fai clic su Salva.

Passaggio 3: scarica o genera le credenziali dell'account esterno (agent-key.json)

Sulla macchina host dell'agente remoto, ottieni un file di configurazione delle credenziali dell'account esterno denominato agent-key.json utilizzando una delle seguenti opzioni.

Opzione A: scarica dalla console Google Cloud (consigliata)

  1. Nella console Google Cloud , vai alla pagina Pool di identità del workload.
  2. Seleziona il pool di identità del workload e fai clic su Concedi l'accesso.
  3. Nel riquadro Concedi l'accesso, seleziona Concedi l'accesso utilizzando account di servizio account.
  4. Nell'elenco Seleziona service account, seleziona il service account dell'agente remoto.
  5. Nella sezione Seleziona entità (identità che possono accedere al account di servizio), specifica quali identità possono accedere al account di servizio (ad esempio selezionando un nome e un valore dell'attributo).
  6. Fai clic su Salva.
  7. Nella finestra Configura la tua applicazione:
    • Seleziona il tuo provider di identità del workload.
    • Nel campo Percorso token ID OIDC, inserisci il percorso esatto in cui è montato o archiviato il token esterno (per i token proiettati di Kubernetes, deve corrispondere a mountPath + path definito nel manifest del pod, ad esempio /var/run/secrets/tokens/gcp-kms-token).
    • Imposta Tipo di formato su Testo (stringa JWT non elaborata). Non selezionare JSON per i file di token standard.
    • Fai clic su Scarica configurazione e salva il file come agent-key.json (o rinomina il file scaricato in agent-key.json).
  8. Trasferisci il file agent-key.json sulla macchina host dell'agente remoto.

Opzione B: genera utilizzando gcloud CLI

Esegui il comando gcloud iam workload-identity-pools create-cred-config per generare il file di configurazione delle credenziali:

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

Riferimento al file di configurazione di esempio

Per riferimento, il file agent-key.json generato contiene una struttura simile alla seguente:

{
  "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"
}

Passaggio 4: mappa il service account in Google SecOps

Prima di eseguire il deployment dell'agente remoto, autorizza l'indirizzo email del service account all'interno di Google SecOps:

  1. Vai a Impostazioni > Gestione accessi > Mappatura dei gruppi.
  2. Fai clic su add Aggiungi.
  3. Nella finestra di dialogo Aggiungi ruolo, inserisci l'indirizzo email completo del account di servizio account nel campo Ruolo IAM/Gruppo IdP.
  4. Seleziona gli ambienti appropriati che l'agente remoto gestirà.
  5. Fai clic su Aggiungi.

Passaggio 5: esegui il deployment o l'aggiornamento dell'autenticazione dell'agente remoto

Podman

Per configurare l'autenticazione dell'agente remoto su Podman, segui questi passaggi:

  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 il file di configurazione delle credenziali nel percorso dedicato nel container:

    podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. Utilizza il seguente comando per modificare il proprietario del file di configurazione delle credenziali 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 configurare l'autenticazione dell'agente remoto su Docker, segui questi passaggi:

  1. Elenca i container Docker in esecuzione:
    docker ps
  2. Inserisci l'ID contenitore dell'agente:
    CONTAINER_ID
  3. Utilizza il seguente comando per copiare il file di configurazione delle credenziali nel percorso dedicato nel container:

    docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. Utilizza il seguente comando per modificare il proprietario del file di configurazione delle credenziali 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 configurare l'autenticazione dell'agente remoto su CentOS/RHEL, segui questi passaggi:

  1. Sposta il file di configurazione delle credenziali nel percorso previsto:

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. Utilizza il seguente comando per modificare il proprietario del file di configurazione delle credenziali:

    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.