Autentica l'agente remoto con la federazione delle identità per i workload
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 asts.googleapis.com,iamcredentials.googleapis.come all'endpoint di posizione dell'API Chronicle (REGION-chronicle.googleapis.com, configurato inONE_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.
- Nella console Google Cloud , vai alla pagina Pool di identità del workload. Vai a Pool di identità del workload
- Fai clic su Crea pool.
- Inserisci un nome e una descrizione per il pool (ad esempio,
soar-remote-agent-pool). - Fai clic su Continua.
- 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.
- 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. - 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.
- Nella console Google Cloud , vai alla pagina Service account.
- Seleziona il service account dell'agente remoto.
- Fai clic sulla scheda Entità con accesso.
- Fai clic su Concedi l'accesso.
- 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/*
- Nell'elenco Seleziona un ruolo, seleziona Utente Workload Identity (
roles/iam.workloadIdentityUser). - 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)
- Nella console Google Cloud , vai alla pagina Pool di identità del workload.
- Seleziona il pool di identità del workload e fai clic su Concedi l'accesso.
- Nel riquadro Concedi l'accesso, seleziona Concedi l'accesso utilizzando account di servizio account.
- Nell'elenco Seleziona service account, seleziona il service account dell'agente remoto.
- 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).
- Fai clic su Salva.
- 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+pathdefinito 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 inagent-key.json).
- Trasferisci il file
agent-key.jsonsulla 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:
- Vai a Impostazioni > Gestione accessi > Mappatura dei gruppi.
- Fai clic su add Aggiungi.
- Nella finestra di dialogo Aggiungi ruolo, inserisci l'indirizzo email completo del account di servizio account nel campo Ruolo IAM/Gruppo IdP.
- Seleziona gli ambienti appropriati che l'agente remoto gestirà.
- 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:
-
Elenca i container Podman in esecuzione:
podman ps -
Inserisci l'ID contenitore dell'agente:
CONTAINER_ID
-
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
-
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
-
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:
-
Elenca i container Docker in esecuzione:
docker ps -
Inserisci l'ID contenitore dell'agente:
CONTAINER_ID
-
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
-
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
-
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:
-
Sposta il file di configurazione delle credenziali nel percorso previsto:
mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
-
Utilizza il seguente comando per modificare il proprietario del file di configurazione delle credenziali:
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Esegui questo comando per riavviare il servizio dell'agente:
supervisorctl restart siemplify_agent
Documentazione correlata
- Esegui la migrazione dell'infrastruttura di autenticazione degli agenti remoti
- Panoramica della sicurezza degli agenti remoti
- Risolvi i problemi relativi agli agenti remoti
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.