Gestire ed esportare gli approfondimenti

Questa pagina descrive come elencare, descrivere, ignorare, ripristinare ed esportare gli approfondimenti.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per gestire ed esportare gli approfondimenti, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire ed esportare gli approfondimenti. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per gestire ed esportare gli approfondimenti sono necessarie le seguenti autorizzazioni:

  • recommender.computeFirewallInsights.list
  • recommender.computeFirewallInsights.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Elencare gli approfondimenti per un progetto

Per elencare gli approfondimenti di un progetto:

gcloud

Utilizza il comando gcloud recommender insights list:

gcloud recommender insights list \
    --project=PROJECT_ID \
    --location=global \
    --insight-type=google.compute.firewall.Insight \
    --filter=EXPRESSION \
    --limit=LIMIT \
    --page-size=PAGE_SIZE \
    --sort-by=SORT_BY \
    --format=json

Sostituisci PROJECT_ID con l'ID del progetto per il quale vuoi elencare gli approfondimenti.

Il flag location utilizza sempre la posizione denominata global. Il insight-type flag utilizza sempre il tipo di insight denominato google.compute.firewall.Insight. A meno che non formatti l'output in JSON, l'output comando è tabulare.

I seguenti campi sono facoltativi:

  • EXPRESSION: applica questo filtro booleano a ogni risorsa che vuoi elencare

    Se l'espressione restituisce True, l'elemento è elencato. Per maggiori dettagli ed esempi di espressioni di filtro, esegui $ gcloud topic filters o consulta la documentazione di gcloud topic filters.

  • LIMIT: il numero massimo di risorse da elencare. Il numero predefinito di risorse elencate è illimitato

  • PAGE_SIZE: il numero massimo di risorse da elencare per pagina

    Le dimensioni della pagina predefinite sono determinate dal servizio. In caso contrario, non viene utilizzata la paginazione. La paginazione potrebbe essere applicata prima o dopo FILTER e LIMIT.

  • SORT_BY: un elenco di nomi di chiavi di campo separati da virgole in base ai quali ordinare una risorsa

    L'ordine predefinito è crescente. Per specificare un ordine decrescente, anteponi un campo con ~ (una tilde).

API

Invia una richiesta GET al metodo projects.locations.insightTypes.insights:

GET https://recommender.googleapis.com/v1/{parent=projects/*/locations/global/insightTypes/*}/insights

L'esempio seguente mostra una risposta di esempio per questo comando:

insights {
"name": "projects/{project_number}/locations/global/insightTypes/google.compute.firewall.Insight/insights/{insight-id}"
"description": "Firewall projects/{project_id}/global/firewalls/{shadowed_firewall_name} is shadowed by projects/{project_id}/global/firewalls/{shadowing_firewall_name}."
"content": {
  "shadowingFirewalls": [
    "//compute.googleapis.com/projects/{project_id}/global/firewalls/{shadowing_firewall_name1}"
  ]
},
"lastRefreshTime": "2020-04-01T19:16:43Z",
"observationPeriod": "0s",
"stateInfo" {
 "state": "ACTIVE"
}
"category": "SECURITY"
"targetResources":[
 "//compute.googleapis.com/projects/{project_id}/global/firewalls/{shadowed_firewall_name}"
 ],
"insightSubtype": "SHADOWED_RULE"
}

Descrivi gli approfondimenti

Per descrivere i dettagli di una determinata regola firewall in un progetto:

gcloud

Utilizza il comando gcloud recommender insights describe:

gcloud recommender insights describe INSIGHT_ID \
    --project=PROJECT_NAME \
    --location=global \
    --insight-type=google.compute.firewall.Insight

Sostituisci quanto segue:

  • INSIGHT_ID: l'ID dell'approfondimento da descrivere
  • PROJECT_NAME: il nome del progetto per cui vuoi elencare gli approfondimenti

Il flag location utilizza sempre la posizione denominata global. Il insight-type flag utilizza sempre il tipo di insight denominato google.compute.firewall.Insight.

API

Invia una richiesta GET al metodo projects.locations.insightTypes.insights:

GET
https://recommender.googleapis.com/v1/{name=projects/*/locations/global/insightTypes/*/insights/*}
{
 "name": projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights/INSIGHT_ID,
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • LOCATION: utilizza sempre la posizione denominata global
  • INSIGHT_TYPE_ID: utilizza sempre il valore google.compute.firewall.Insight
  • INSIGHT_ID: l'ID dell'approfondimento

Contrassegnare un insight come ignorato

Se un'informazione non è significativa o se vuoi nasconderla per qualsiasi altro motivo, puoi ignorarla. Dopo aver ignorato un'intuizione, la console Google Cloud non la mostra più a te o ad altri utenti, a meno che non la ripristini.

Per contrassegnare un insight come ignorato:

Console

  1. Nella console Google Cloud, vai alla pagina Approfondimenti sul firewall.

    Vai a Firewall Insights

  2. Trova la scheda appropriata e fai clic su Visualizza elenco completo.

  3. Seleziona le regole che vuoi ignorare e poi fai clic su Ignora.

Ripristinare un insight ignorato

Se hai ignorato un'intuizione che in un secondo momento ritieni pertinente, tu o un altro utente potete ripristinarla e renderla visibile nella console Google Cloud.

Per ripristinare un'intuizione ignorata:

Console

  1. Nella console Google Cloud, vai alla pagina Approfondimenti sul firewall.

    Vai a Firewall Insights

  2. Fai clic su Ignora cronologia. In risposta, la console Google Cloud visualizza la pagina Approfondimenti ignorati.

  3. Seleziona gli approfondimenti che vuoi ripristinare e poi fai clic su Ripristina.

Esportare gli approfondimenti

Se necessario, puoi esportare gli insight sulle regole sfumate ed eccessivamente permissive in formato CSV o JSON. Le informazioni su Deny rules with hits non possono essere esportate perché si basano sulle metriche di Stackdriver per i firewall e non sugli approfondimenti.

Potresti voler esportare gli approfondimenti per uno dei seguenti motivi:

  • Devi importare i dati in un altro sistema.
  • Vuoi accedere ai dati quando sei offline.
  • Hai intenzione di disattivare Firewall Insights, ma vuoi mantenere l'accesso agli insight generati in precedenza.

Per esportare gli approfondimenti:

Console

  1. Nella console Google Cloud, vai alla pagina Approfondimenti sul firewall.

    Vai a Firewall Insights

  2. Fai clic su Salva con nome.

  3. Segui le istruzioni per scegliere un formato per gli approfondimenti e scaricarli.

Puoi anche esportare gli approfondimenti in BigQuery. Quando esporti gli approfondimenti in BigQuery, puoi visualizzare istantanee giornaliere degli approfondimenti per la tua organizzazione. Per ulteriori informazioni, consulta Esportare i suggerimenti in BigQuery.

Passaggi successivi