Correggere gli errori di Security Command Center

Questa pagina fornisce un elenco di guide di riferimento e tecniche per la correzione degli errori SCC.

Prima di iniziare

Per visualizzare o modificare i risultati e per accedere o modificare le risorse Google Cloud, devi disporre di ruoli IAM adeguati. Se riscontri errori di autorizzazione quando accedi a Security Command Center nella console Google Cloud, rivolgiti all'amministratore per ricevere assistenza. Per informazioni sui ruoli, consulta Controllo dell'accesso. Per risolvere gli errori relativi alle risorse, leggi la documentazione dei prodotti interessati.

Esamina i risultati nella console Google Cloud

Gli errori SCC sono errori di configurazione che impediscono il corretto funzionamento di Security Command Center. L'origineSecurity Command Center genera questi risultati.

Se Security Command Center è configurato per la tua organizzazione o per il tuo progetto, genera risultati di errore man mano che li rileva. Puoi visualizzare gli errori SCC nella console Google Cloud.

Per esaminare i risultati nella console Google Cloud, segui questa procedura:

Console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Risultati di Security Command Center.

    Vai a Risultati

  2. Seleziona il tuo progetto o la tua organizzazione Google Cloud.
  3. Nella sezione Filtri rapidi, nella sottosezione Nome visualizzato dell'origine, seleziona Security Command Center. I risultati della query sui risultati vengono aggiornati in modo da mostrare solo i risultati di questa origine.
  4. Per visualizzare i dettagli di un determinato rilevamento, fai clic sul nome del rilevamento nella colonna Categoria. Viene visualizzato il riquadro dei dettagli del risultato e la scheda Riepilogo.
  5. Nella scheda Riepilogo, esamina i dettagli del risultato, incluse informazioni su ciò che è stato rilevato, la risorsa interessata e, se disponibili, i passaggi che puoi svolgere per risolvere il problema.
  6. (Facoltativo) Per visualizzare la definizione JSON completa del rilevamento, fai clic sulla scheda JSON.

Console Security Operations

  1. Nella console Security Operations, vai alla pagina Risultati.
    https://CUSTOMER_SUBDOMAIN.backstory.chronicle.security/posture/findings
    

    Sostituisci CUSTOMER_SUBDOMAIN con l'identificatore specifico del cliente.

  2. Nella sezione Aggregazioni, fai clic per espandere la sottosezione Nome visualizzato della sorgente.
  3. Seleziona Security Command Center. I risultati della query sui risultati vengono aggiornati in modo da mostrare solo i risultati di questa origine.
  4. Per visualizzare i dettagli di un determinato rilevamento, fai clic sul nome del rilevamento nella colonna Categoria. Viene visualizzato il riquadro dei dettagli del risultato e la scheda Riepilogo.
  5. Nella scheda Riepilogo, esamina i dettagli del risultato, incluse informazioni su ciò che è stato rilevato, la risorsa interessata e, se disponibili, i passaggi che puoi svolgere per risolvere il problema.
  6. (Facoltativo) Per visualizzare la definizione JSON completa del rilevamento, fai clic sulla scheda JSON.

Disattivazione degli errori SCC dopo la correzione

Dopo aver corretto un risultato SCC error, Security Command Center imposta automaticamente lo stato del risultato su INACTIVE durante la scansione successiva. Il tempo necessario per impostare lo stato di un risultato corretto su INACTIVE in Security Command Center dipende da quando correggi il risultato e dalla pianificazione della scansione che rileva l'errore.

Per informazioni sulla frequenza di scansione di un risultato SCC error, consulta il riepilogo del risultato in Rilevatori di errori.

Correggere gli errori SCC

Questa sezione include istruzioni per la correzione di tutti gli errori SCC.

API disabled

Nome della categoria nell'API: API_DISABLED

Uno dei seguenti servizi è disattivato per il progetto:

Il servizio disattivato non può generare risultati.

Per risolvere il problema, segui questi passaggi:

  1. Esamina il rilevamento per determinare quale API è disattivata.
  2. Abilita l'API:

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

APS no resource value configs match any resources

Nome della categoria nell'API: APS_NO_RESOURCE_VALUE_CONFIGS_MATCH_ANY_RESOURCES

Le configurazioni dei valori delle risorse sono definite per le simulazioni del percorso di attacco, ma non corrispondono a nessuna istanza di risorsa nel tuo ambiente. Le simulazioni utilizzano invece il set di risorse di valore elevato predefinito.

Le configurazioni dei valori delle risorse potrebbero non corrispondere a nessuna risorsa per i seguenti motivi, identificati nella descrizione del rilevamento nella console Google Cloud:

  • Nessuna delle configurazioni dei valori delle risorse corrisponde a nessuna istanza di risorsa.
  • Una o più configurazioni dei valori delle risorse che specificano NONE sostituiscono ogni altra configurazione valida.
  • Tutte le configurazioni dei valori delle risorse definite specificano un valore NONE.

Per risolvere il problema, segui questi passaggi:

  1. Vai alla pagina Simulazione del percorso di attacco in Impostazioni di Security Command Center:

    Vai alle impostazioni

  2. Seleziona la tua organizzazione. Si apre la pagina Simulazione del percorso di attacco con le configurazioni esistenti visualizzate.

  3. Nella colonna Valore della risorsa dell'elenco Configurazioni di valori delle risorse, controlla la presenza di valori di None.

  4. Per qualsiasi configurazione che ha specificato None:

    1. Fai clic sul nome di qualsiasi configurazione del valore della risorsa per visualizzare le specifiche di configurazione.
    2. Se necessario, modifica le specifiche degli attributi della risorsa per ridurre il numero di istanze di risorse corrispondenti alla configurazione.
  5. Se il problema non è causato da una specifica None eccessivamente ampia, svolgi i seguenti passaggi:

    1. Fai clic sui nomi di ogni configurazione che specifica un valore HIGH, MEDIUM o LOW per visualizzare le specifiche degli attributi della risorsa.
    2. Esamina e, se necessario, modifica la configurazione per correggere l'ambito, il tipo di risorsa, il tag o la specifica dell'etichetta in modo che corrispondano alle risorse previste.
  6. Se necessario, crea una nuova configurazione dei valori delle risorse.

Le modifiche vengono applicate alla simulazione del percorso di attacco successiva.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

APS resource value assignment limit exceeded

Nome della categoria nell'API: APS_RESOURCE_VALUE_ASSIGNMENT_LIMIT_EXCEEDED

Nell'ultima simulazione del percorso di attacco, il numero di istanze di risorse di alto valore, come identificato dalle configurazioni dei valori delle risorse, ha superato il limite di 1000 istanze di risorse in un set di risorse di alto valore. Di conseguenza, Security Command Center ha escluso il numero eccessivo di istanze dal set di risorse di valore elevato.

Per risolvere il problema, puoi provare le seguenti azioni:

  • Utilizza i tag o le etichette per ridurre il numero di corrispondenze per un determinato tipo di risorsa o in un ambito specificato. I tag o le etichette devono essere applicati alle istanze delle risorse prima di poter essere abbinati da una configurazione del valore della risorsa.
  • Crea una configurazione del valore della risorsa che assegna un valore della risorsa di NONE a un sottoinsieme delle risorse specificate in un'altra configurazione.

    La specifica di un valore NONE ha la precedenza su qualsiasi altra configurazione ed esclude le istanze di risorse dal set di risorse di alto valore.

  • Riduci la specifica dell'attributo della risorsa di ambito nella configurazione del valore della risorsa.

  • Elimina le configurazioni dei valori delle risorse che assegnano un valore di LOW.

Per istruzioni su come creare, modificare o eliminare una configurazione del valore della risorsa, consulta Definire e gestire il set di risorse di alto valore.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

CIEM service account missing permissions

Nome della categoria nell'API: CIEM_SERVICE_ACCOUNT_MISSING_PERMISSIONS

Nell'account di servizio utilizzato dal servizio CIEM mancano le autorizzazioni. CIEM non può generare una o più categorie di risultati.

Per risolvere il problema, ripristina i ruoli IAM richiesti nell'account di servizio CIEM:

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Seleziona l'account di servizio CIEM della tua organizzazione. L'identificatore dell'account di servizio è un indirizzo email con il seguente formato:

    service-org-ORGANIZATION_ID@gcp-sa-ciem.iam.gserviceaccount.com
    

    Sostituisci ORGANIZATION_ID con l'ID numerico della tua organizzazione.

    Se non vedi l'account di servizio nell'elenco, fai clic su CONCEDI ACCESSO nella parte superiore della pagina e inserisci l'account di servizio come nuova entità.

  3. Concedi il ruolo Agente di servizio CIEM (roles/ciem.serviceAgent) all'account di servizio. Se utilizzi ruoli personalizzati, assicurati che includano le seguenti autorizzazioni:

    • cloudasset.assets.exportResource
    • cloudasset.assets.exportIamPolicy
  4. Fai clic su Salva.

CIEM AWS CloudTrail configuration error

Nome della categoria nell'API: AWS_CLOUDTRAIL_CONFIGURATION_ERROR

Tutti o alcuni risultati di CIEM AWS non vengono inviati a Security Command Center. Il feed AWS CloudTrail non è riuscito e non è in grado di recuperare i dati a causa di un errore di configurazione.

Esistono tre possibili cause per questo risultato:

  • Feed AWS CloudTrail mancante

    Per risolvere il problema, crea e configura un feed nella console Security Operations per eseguire l'importazione dei log AWS CloudTrail. Imposta la coppia chiave-valore Etichetta importazione su CIEM e TRUE.

    Per istruzioni su come creare un feed, consulta Creare il feed nella documentazione di Google SecOps.

  • Errori nella configurazione del feed

    Assicurati di aver configurato correttamente il feed.

    Per configurare un feed, consulta Configurare il feed in Google Security Operations per importare i log AWS nella documentazione di Google SecOps.

  • Configurazione incompleta di AWS CloudTrail

    Per risolvere il problema, configura il bucket S3 nella configurazione di AWS CloudTrail per registrare sia gli eventi di dati sia gli eventi di gestione di tutti gli account AWS in cui intendi utilizzare CIEM.

    Per configurare CloudTrail, consulta Configurare AWS CloudTrail (o un altro servizio) nella documentazione di Google SecOps.

GKE service account missing permissions

Nome della categoria nell'API: GKE_SERVICE_ACCOUNT_MISSING_PERMISSIONS

Container Threat Detection non può generare risultati per un cluster Google Kubernetes Engine perché al account di servizio predefinito GKE del cluster mancano le autorizzazioni. In questo modo, Container Threat Detection non può essere attivato correttamente sul cluster.

Per risolvere il problema, ripristina l'account di servizio predefinito GKE e conferma che l'account di servizio disponga del ruolo Agente di servizio Kubernetes Engine (roles/container.serviceAgent).

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

KTD blocked by admission controller

Nome della categoria nell'API: KTD_BLOCKED_BY_ADMISSION_CONTROLLER

Container Threat Detection non può essere attivato su un cluster perché un controllore di ammissione di terze parti impedisce il deployment dell'oggetto DaemonSet Kubernetes richiesto.

Per risolvere il problema, assicurati che i controller di ammissione in esecuzione sul cluster consentano a Container Threat Detection di creare gli oggetti Kubernetes richiesti.

Controlla il controller di ammissione

Controlla se il controller di ammissione nel tuo cluster sta rifiutando il deployment dell'oggetto DaemonSet di Container Threat Detection.

  1. Nella descrizione del rilevamento nei dettagli del rilevamento nella console Google Cloud, esamina il messaggio di errore incluso di Kubernetes. Il messaggio di errore Kubernetes dovrebbe essere simile al seguente:

    generic::failed_precondition: incompatible admission webhook:
    admission webhook "example.webhook.sh" denied the request:
    [example-constraint] you must provide labels: {"example-required-label"}.
    
  2. Nei log di controllo della Console di amministrazione di Cloud per il progetto che contiene il tuo cluster, cerca il messaggio di errore visualizzato nel campo Descrizione dei dettagli del rilevamento.

  3. Se il controller di ammissione funziona, ma nega il deployment dell'oggetto DaemonSet di Container Threat Detection, configuralo in modo da consentire all'agente di servizio per Container Threat Detection di gestire gli oggetti nello spazio dei nomi kube-system.

    L'agente di servizio per Container Threat Detection deve essere in grado di gestire oggetti Kubernetes specifici.

Per ulteriori informazioni sull'utilizzo dei controller di ammissione con Container Threat Detection, consulta PodSecurityPolicy e controller di ammissione.

Conferma la correzione

Dopo aver corretto l'errore, Security Command Center tenta automaticamente di attivare il rilevamento delle minacce nei contenitori. Dopo aver atteso il completamento dell'attivazione, puoi verificare se il rilevamento delle minacce nei contenitori è attivo seguendo questi passaggi:

  1. Vai alla pagina Carichi di lavoro di Kubernetes Engine nella console.

    Vai ai carichi di lavoro Kubernetes

  2. Se necessario, seleziona Mostra workload del sistema.

  3. Nella pagina Carichi di lavoro, filtra prima i carichi di lavoro in base al nome del cluster.

  4. Cerca il carico di lavoro container-watcher. Se container-watcher è presente e il relativo stato è OK, Container Threat Detection è attivo.

KTD image pull failure

Nome della categoria nell'API: KTD_IMAGE_PULL_FAILURE

Rilevamento minacce dei container non può essere attivato nel cluster perché non è possibile estrarre (scaricare) un'immagine container obbligatoria da gcr.io, l'host dell'immagine di Container Registry.

Il pull o il download di un'immagine container può non riuscire per uno di diversi possibili motivi.

Verifica quanto segue:

  • Assicurati che le impostazioni della rete VPC, del DNS o del firewall non blocchino l'accesso alla rete dal cluster all'host dell'immagine gcr.io.
  • Se il cluster è privato, assicurati che l'accesso privato Google sia abilitato per consentire l'accesso all'host dell'immagine gcr.io.
  • Se le impostazioni di rete e l'accesso privato Google non sono la causa del fallimento, consulta la documentazione per la risoluzione dei problemi di GKE per gli errori ImagePullBackOff e ErrImagePull.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

KTD service account missing permissions

Nome della categoria nell'API: KTD_SERVICE_ACCOUNT_MISSING_PERMISSIONS

All'account di servizio Container Threat Detection identificato nei dettagli del rilevamento nella console Google Cloud mancano le autorizzazioni richieste. Tutti o alcuni risultati di Container Threat Detection non vengono inviati a Security Command Center.

Per risolvere il problema, segui questi passaggi:

  1. Concedi il ruolo Agente di servizio Container Threat Detection (roles/containerthreatdetection.serviceAgent) all'account di servizio. Per ulteriori informazioni, consulta Concedere un singolo ruolo.

    In alternativa, se vuoi utilizzare un ruolo personalizzato, assicurati che disponga delle autorizzazioni nel ruolo Agente di servizio Container Threat Detection.

  2. Assicurati che non siano presenti criteri di rifiuto IAM che impediscano all'account di servizio di utilizzare le autorizzazioni nel ruolo Agente di servizio di rilevamento delle minacce dei contenitori. Se esiste un criterio di rifiuto che blocca l'accesso, aggiungi l'account di servizio come entità di eccezione nel criterio di rifiuto.

Per ulteriori informazioni sull'account di servizio Container Threat Detection, sul ruolo e sulle autorizzazioni richieste, consulta Autorizzazioni IAM richieste.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

Misconfigured Cloud Logging Export

Nome della categoria nell'API: MISCONFIGURED_CLOUD_LOGGING_EXPORT

Il progetto configurato per l'esportazione continua in Cloud Logging non è disponibile. Di conseguenza, Security Command Center non può inviare i risultati a Logging.

Per risolvere il problema, esegui una delle seguenti operazioni:

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

VPC Service Controls Restriction

Nome della categoria nell'API: VPC_SC_RESTRICTION

Security Health Analytics non può produrre determinati risultati per un progetto perché è protetto da un perimetro di servizio. Devi concedere all'account di servizio Security Command Center l'accesso in entrata al perimetro di servizio.

L'identificatore dell'account di servizio è un indirizzo email con il seguente formato:

service-RESOURCE_KEYWORD-RESOURCE_ID@security-center-api.iam.gserviceaccount.com

Sostituisci quanto segue:

  • RESOURCE_KEYWORD: la parola chiave org o project, a seconda della risorsa proprietaria dell'account di servizio
  • RESOURCE_ID: uno dei seguenti valori:

    • L'ID organizzazione se l'account di servizio è di proprietà dell'organizzazione
    • Il numero del progetto se l'account di servizio è di proprietà di un progetto

Se hai account di servizio sia a livello di organizzazione che a livello di progetto, applica la correzione a entrambi.

Per risolvere il problema, segui questi passaggi.

Passaggio 1: determina quale perimetro di servizio blocca Security Health Analytics

  1. Recupera l'ID univoco di Controlli di servizio VPC e l'ID progetto associato al risultato:

    1. Per visualizzare i dettagli del rilevamento, fai clic sul nome della categoria.
    2. Nel campo Descrizione, copia l'ID univoco di Controlli di servizio VPC, ad esempio5e4GI409D6BTWfOp_6C-uSwmTpOQWcmW82sfZW9VIdRhGO5pXyCJPQ.
    3. Nel campo Percorso risorsa, copia l'ID del progetto.
  2. Ottieni l'ID della policy di accesso e il nome del perimetro di servizio:

    1. Nella console Google Cloud, vai alla pagina Esplora log.

      Vai a Esplora log

    2. Nella barra degli strumenti, seleziona il progetto associato al rilevamento.

      Selettore di progetti

    3. Nella casella di ricerca, inserisci l'ID univoco dell'errore.

      Cercare per UID errore

      Se l'errore non viene visualizzato nei risultati della query, espandi la sequenza temporale nell'istogramma e poi esegui di nuovo la query.

    4. Fai clic sull'errore visualizzato.

    5. Fai clic su Espandi campi nidificati.

    6. Copia il valore del campo servicePerimeterName. Il valore ha il seguente formato:

      accessPolicies/ACCESS_POLICY/servicePerimeters/SERVICE_PERIMETER
      

      In questo esempio, il nome completo della risorsa perimetro di servizio è accessPolicies/540107806624/servicePerimeters/vpc_sc_misconfigured.

      • ACCESS_POLICY è l'ID criterio di accesso, ad esempio 540107806624.
      • SERVICE_PERIMETER è il nome del perimetro di servizio, ad esempio vpc_sc_misconfigured.

        Nome completo della risorsa del perimetro di servizio

    7. Per ottenere il nome visualizzato che corrisponde all'ID criterio di accesso, utilizza gcloud CLI.

      Se non puoi eseguire query a livello di organizzazione, chiedi all'amministratore di eseguire questo passaggio.

      gcloud access-context-manager policies list \
          --organization ORGANIZATION_ID
      

      Sostituisci ORGANIZATION_ID con l'ID numerico della tua organizzazione.

      Viene visualizzato un output simile al seguente:

      NAME          ORGANIZATION  SCOPES                 TITLE           ETAG
      540107806624  549441802605                         default policy  2a9a7e30cbc14371
      352948212018  549441802605  projects/393598488212  another_policy  d7b47a9ecebd4659
      

      Il nome visualizzato è il titolo corrispondente all'ID criterio di accesso. Prendi nota del nome visualizzato del criterio di accesso e del nome del perimetro del servizio. Ne avrai bisogno nella sezione successiva.

Passaggio 2: crea una regola di ingresso che concede l'accesso al progetto

Per questa sezione devi disporre dell'accesso a livello di organizzazione ai Controlli di servizio VPC. Se non disponi dell'accesso a livello di organizzazione, chiedi all'amministratore di eseguire questi passaggi.

Nei passaggi che seguono, crei una regola di ingresso per il perimetro di servizio che hai identificato nel passaggio 1.

Per concedere a un account di servizio l'accesso in entrata a un perimetro di servizio, segui questi passaggi.

  1. Vai a Controlli di servizio VPC.

    Vai a Controlli di servizio VPC

  2. Nella barra degli strumenti, seleziona la tua organizzazione Google Cloud.

    Selettore di progetti

  3. Nell'elenco a discesa, seleziona il criterio di accesso che contiene il perimetro del servizio a cui vuoi concedere l'accesso.

    Elenco dei criteri di accesso

    I perimetri di servizio associati al criterio di accesso vengono visualizzati nell'elenco.

  4. Fai clic sul nome del perimetro di servizio.

  5. Fai clic su Modifica perimetro.

  6. Nel menu di navigazione, fai clic su Criterio in entrata.

  7. Fai clic su Aggiungi regola.

  8. Configura la regola nel seguente modo:

    Attributi FROM del client API

    1. In Origine, seleziona Tutte le origini.
    2. Per Identità, seleziona Identità selezionate.
    3. Nel campo Aggiungi utente/account di servizio, fai clic su Seleziona.
    4. Inserisci l'indirizzo email dell'account di servizio. Se hai account di servizio sia a livello di organizzazione sia a livello di progetto, aggiungili entrambi.
    5. Fai clic su Salva.

    Attributi TO di servizi/risorse Google Cloud

    1. In Progetto, seleziona Tutti i progetti o il progetto specificato nel rilevamento.

    2. In Servizi, seleziona Tutti i servizi o seleziona ciascuno dei seguenti singoli servizi richiesti da Security Health Analytics:

      • API BigQuery
      • API Binary Authorization
      • API Cloud Logging
      • API Cloud Monitoring
      • API Compute Engine
      • API Kubernetes Engine

    Se un perimetro di servizio limita l'accesso a un servizio richiesto, Security Health Analytics non può produrre risultati per quel servizio.

  9. Nel menu di navigazione, fai clic su Salva.

Per ulteriori informazioni, consulta Configurare i criteri di ingresso e di uscita.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

Security Command Center service account missing permissions

Nome della categoria nell'API: SCC_SERVICE_ACCOUNT_MISSING_PERMISSIONS

All'agente di servizio di Security Command Center mancano le autorizzazioni necessarie per il funzionamento corretto.

L'identificatore dell'account di servizio è un indirizzo email con il seguente formato:

service-RESOURCE_KEYWORD-RESOURCE_ID@security-center-api.iam.gserviceaccount.com

Sostituisci quanto segue:

  • RESOURCE_KEYWORD: la parola chiave org o project, a seconda della risorsa proprietaria dell'account di servizio
  • RESOURCE_ID: uno dei seguenti valori:

    • L'ID organizzazione se l'account di servizio è di proprietà dell'organizzazione
    • Il numero del progetto se l'account di servizio è di proprietà di un progetto

Se hai account di servizio sia a livello di organizzazione che a livello di progetto, applica la correzione a entrambi.

Per risolvere il problema, segui questi passaggi:

  1. Concedi all'account di servizio il ruolo Agente di servizio Security Center (roles/securitycenter.serviceAgent).

    Per ulteriori informazioni, consulta Concedere un singolo ruolo.

    In alternativa, se vuoi utilizzare un ruolo personalizzato, assicurati che disponga delle autorizzazioni nel ruolo Agente di servizio Security Center.

  2. Assicurati che non siano presenti criteri di rifiuto IAM che impediscano all'account di servizio di utilizzare le autorizzazioni nei ruoli richiesti. Se esiste un criterio di rifiuto che blocca l'accesso, aggiungi l'account di servizio come entità di eccezione nel criterio di rifiuto.

Scopri le risorse e le impostazioni di scansione supportate di questo tipo di segnalazione.

Passaggi successivi

Scopri di più sugli errori di Security Command Center.