Trasmetti i risultati in BigQuery per l'analisi

Standard-legacy, Standard, Premium ed Enterprise (ritirato)

L'esportazione di Security Command Center per BigQuery consente di trasmettere in streaming i risultati nuovi e aggiornati a un set di dati BigQuery quasi in tempo reale. In BigQuery, puoi eseguire query sugli stati dei risultati nel tempo, analizzare le tendenze della security posture e creare report personalizzati. L'esportazione trasmette in streaming i nuovi risultati man mano che si verificano e i risultati esistenti solo quando vengono aggiornati.

Panoramica

Quando attivi questa funzionalità, i nuovi risultati scritti in Security Command Center vengono esportati in una tabella BigQuery quasi in tempo reale. Puoi quindi integrare i dati nei workflow esistenti e creare analisi personalizzate. Puoi attivare questa funzionalità a livello di organizzazione, cartella e progetto per esportare i risultati in base ai tuoi requisiti.

Questa funzionalità è il metodo consigliato per esportare i risultati di Security Command Center in BigQuery, perché è completamente gestita e non richiede l'esecuzione di operazioni manuali o la scrittura di codice personalizzato.

Struttura del set di dati

Questa funzionalità aggiunge ogni nuovo risultato e i relativi aggiornamenti successivi come nuove righe nella tabella findings, raggruppata per source_id, finding_id e event_time. In questo modo vengono creati più record di risultati con gli stessi valori source_id e finding_id, ma con valori event_time diversi. Questa struttura del set di dati ti consente di visualizzare il modo in cui lo stato di ogni risultato cambia nel tempo.

Tieni presente che nel set di dati potrebbero essere presenti voci duplicate. Per analizzarli, puoi utilizzare la clausola DISTINCT, come mostrato nella prima query di esempio.

Ogni set di dati contiene una tabella findings, che include i seguenti campi:

Campo Descrizione
source_id

Un identificatore univoco che Security Command Center assegna all'origine di un risultato. Ad esempio, tutti i risultati della sorgente di rilevamento di anomalie di Cloud hanno lo stesso valore source_id.

Esempio: 1234567890

finding_id Identificatore univoco che rappresenta il risultato. È univoco all'interno di un'origine per un'organizzazione. È alfanumerico e contiene al massimo 32 caratteri.
event_time

L'ora in cui si è verificato l'evento o l'ora in cui è stato eseguito un aggiornamento del risultato. Ad esempio, se il risultato rappresenta un firewall aperto, event_time acquisisce l'ora in cui il rilevatore ritiene che il firewall sia stato aperto. Se il risultato viene risolto in un secondo momento, questa ora riflette il momento in cui è stato risolto.

Esempio: 2019-09-26 12:48:00.985000 UTC

Per ulteriori informazioni sulle modifiche che aggiornano l'ora dell'evento, consulta Panoramica del ciclo di vita dei risultati.

bulk_export_id

Per le esportazioni collettive, si tratta di un UUID.

Per le esportazioni continue, questo campo è vuoto.

finding

Un record di dati di valutazione, come sicurezza, rischio, integrità o privacy, che viene importato in Security Command Center per la presentazione, la notifica, l'analisi, il test delle policy e l'applicazione. Ad esempio, una vulnerabilità di cross-site scripting (XSS) in un'applicazione App Engine è un risultato.

Per ulteriori informazioni sui campi nidificati, consulta il riferimento API per l'oggetto Finding.

resource

Informazioni relative alla risorsa Google Cloud associata a questo risultato.

Per ulteriori informazioni sui campi nidificati, consulta il riferimento API per l'oggetto Resource.

Costo

Sostieni i costi di BigQuery relativi a questa funzionalità. Per saperne di più, consulta la pagina relativa ai prezzi di BigQuery.

Prima di iniziare

Devi completare questi passaggi prima di attivare questa funzionalità.

Configurare le autorizzazioni

Per completare questa guida, devi disporre dei seguenti ruoli Identity and Access Management (IAM):

Crea un set di dati BigQuery

Creare un set di dati BigQuery. Per saperne di più, consulta Creazione dei set di dati.

Pianifica la residenza dei dati

Se la residenza dei dati è abilitata per Security Command Center, le configurazioni che definiscono le esportazioni streaming in BigQuery, ovvero le risorse BigQueryExport, sono soggette al controllo della residenza dei dati e vengono archiviate in una località di Security Command Center selezionata da te.

Per esportare i risultati in una località di Security Command Center in BigQuery, devi configurare l'esportazione BigQuery nella stessa località di Security Command Center dei risultati.

Poiché i filtri utilizzati nelle esportazioni di BigQuery possono contenere dati soggetti a controlli di residenza, assicurati di specificare la località corretta prima di crearli. Security Command Center non limita la località in cui crei le esportazioni.

Le esportazioni di BigQuery vengono archiviate solo nella località in cui vengono create e non possono essere visualizzate o modificate in altre località.

Una volta creato un BigQuery Export, non puoi modificarne la località. Per modificare la località, devi eliminare l'esportazione BigQuery e ricrearla nella nuova località.

Per scoprire come utilizzare Security Command Center quando la residenza dei dati è abilitata, consulta Endpoint regionali di Security Command Center.

In che modo Security Command Center esporta i risultati in BigQuery

Le sezioni seguenti descrivono in che modo Security Command Center esporta i risultati nuovi, aggiornati ed eliminati in BigQuery.

Esportazione di risultati nuovi e aggiornati

Quando un attributo di un risultato viene aggiornato, Security Command Center acquisisce uno snapshot e tenta di inviarlo a BigQuery.

Questo tentativo genera uno dei seguenti risultati:

  • Se gli attributi del risultato nello snapshot corrispondono al filtro di esportazione definito in BigQuery Export, lo snapshot viene inviato a BigQuery, dove diventa il record corrente del risultato in BigQuery.

  • Se gli attributi del risultato non corrispondono al filtro, lo snapshot non viene inviato a BigQuery. Se in BigQuery esiste uno snapshot precedente del risultato, questo rimane il record più recente disponibile nel set di dati, anche se non riflette gli aggiornamenti recenti in Security Command Center.

Ad esempio, se il filtro per un'esportazione in BigQuery contiene lo stato attivo, viene generato un nuovo risultato con lo stato attivo e uno snapshot del risultato viene esportato correttamente in BigQuery.

In un secondo momento, lo stato del risultato in Security Command Center viene aggiornato su Inattivo. L'aggiornamento attiva l'esportazione di un nuovo snapshot del risultato in BigQuery, ma, poiché il valore dello stato non corrisponde più al filtro, quest'ultimo blocca l'esportazione dello snapshot del risultato.

Di conseguenza, lo snapshot del risultato in BigQuery ha ancora lo stato attivo, ma lo stesso risultato in Security Command Center ha lo stato inattivo.

Ciò comporta anche una mancata corrispondenza tra il numero di risultati attivi in Security Command Center e il numero di risultati attivi in BigQuery. Il numero di risultati attivi è quasi sempre maggiore in BigQuery rispetto a Security Command Center.

Ad esempio, se un filtro di esportazione specifica lo stato attivo e vengono generati 100 risultati con lo stato attivo, tutti i 100 risultati vengono esportati in BigQuery. In un secondo momento, in Security Command Center, 50 di questi risultati vengono aggiornati in modo da diventare inattivi e il filtro blocca l'esportazione attivata dagli aggiornamenti perché il valore dello stato non corrisponde più al filtro. Di conseguenza, in BigQuery tutti i 100 risultati sono ancora attivi, mentre in Security Command Center rimangono attivi solo 50 risultati.

Esportazione dei risultati eliminati

Security Command Center elimina periodicamente i risultati in base alle policy di conservazione dei dati. Puoi configurare se Security Command Center esporta uno snapshot dei risultati eliminati in BigQuery.

Puoi attivare le notifiche di eliminazione quando crei o aggiorni una configurazione di esportazione. Quando le notifiche di eliminazione sono abilitate, Security Command Center invia uno snapshot dei risultati a BigQuery con il campo deleted_finding impostato su true e event_time impostato sull'ora in cui il risultato è stato eliminato. In questo modo puoi eseguire query che monitorano i risultati eliminati. Quando modifichi l'opzione di notifica di eliminazione in una configurazione di esportazione, la modifica si applica solo alle eliminazioni future dei risultati. I risultati eliminati prima dell'attivazione dell'opzione non vengono esportati retroattivamente.

Esporta i risultati da Security Command Center a BigQuery

Per esportare i risultati, abilita prima l'API Security Command Center.

Abilitazione dell'API Security Command Center

Per abilitare l'API Security Command Center:

  1. Vai alla pagina Libreria API nella console Google Cloud .

    Vai alla libreria API

  2. Seleziona il progetto per cui vuoi abilitare l'API Security Command Center.

  3. Nella casella Cerca, inserisci Security Command Center e poi fai clic su Security Command Center nei risultati di ricerca.

  4. Nella pagina dell'API visualizzata, fai clic su Abilita.

L'API Security Command Center è abilitata per il tuo progetto. Successivamente, utilizzerai gcloud CLI per creare una nuova configurazione di esportazione in BigQuery.

Concessione dell'accesso al perimetro nei Controlli di servizio VPC

Se utilizzi i Controlli di servizio VPC e il tuo set di dati BigQuery fa parte di un progetto all'interno di un perimetro di servizio, devi concedere l'accesso ai progetti per esportare i risultati.

Per concedere l'accesso ai progetti, crea regole in entrata e in uscita per le entità e i progetti da cui esporti i risultati. Le regole consentono l'accesso alle risorse protette e permettono a BigQuery di verificare che gli utenti dispongano dell'autorizzazione setIamPolicy sul set di dati BigQuery.

Prima di configurare una nuova esportazione in BigQuery

Console

  1. Nella console Google Cloud , vai alla pagina Controlli di servizio VPC.

    Vai a Controlli di servizio VPC

  2. Seleziona la tua organizzazione.
  3. Nell'elenco a discesa, seleziona la policy di accesso che contiene il perimetro di servizio a cui vuoi concedere l'accesso.

    I perimetri di servizio associati alla policy di accesso vengono visualizzati nell'elenco.

  4. Fai clic sul nome del perimetro di servizio che vuoi aggiornare.

    Per trovare il perimetro di servizio da modificare, puoi controllare i log per individuare le voci che mostrano violazioni di RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER. In queste voci, controlla il campo servicePerimeterName:

    accessPolicies/ACCESS_POLICY_ID/servicePerimeters/SERVICE_PERIMETER_NAME
  5. Fai clic su Modifica.

Aggiungi una regola in uscita

  1. Fai clic su Policy in uscita.
  2. Fai clic su Aggiungi una regola in uscita.
  3. Nella sezione Da, imposta i seguenti dettagli:

    1. In Identità > Identità, seleziona Seleziona identità e gruppi.
    2. Fai clic su Aggiungi identità.
    3. Inserisci l'indirizzo email che identifica l'entità utilizzata per chiamare l'API Security Command Center.
    4. Seleziona l'entità o premi INVIO, quindi fai clic su Aggiungi identità.
  4. Nella sezione A, imposta i seguenti dettagli:

    1. In Risorse > Progetti, seleziona Tutti i progetti.
    2. In Operazioni o ruoli IAM, seleziona Seleziona operazioni.
    3. Fai clic su Aggiungi operazioni e poi aggiungi le seguenti operazioni:

      • Aggiungi il servizio bigquery.googleapis.com.
        1. Fai clic su Tutti i metodi.
        2. Fai clic su Aggiungi tutti i metodi.

Aggiungi una regola in entrata

  1. Fai clic su Criterio in entrata.
  2. Fai clic su Aggiungi una regola in entrata.
  3. Nella sezione Da, imposta i seguenti dettagli:

    1. In Identità > Identità, seleziona Seleziona identità e gruppi.
    2. Fai clic su Aggiungi identità.
    3. Inserisci l'indirizzo email che identifica l'entità utilizzata per chiamare l'API Security Command Center.
    4. Seleziona l'entità o premi INVIO, quindi fai clic su Aggiungi identità.
  4. Nella sezione A, imposta i seguenti dettagli:

    1. In Risorse > Progetti, seleziona Seleziona progetti.
    2. Fai clic su Aggiungi progetti, quindi aggiungi il progetto che contiene il set di dati BigQuery.
    3. In Operazioni o ruoli IAM, seleziona Seleziona operazioni.
    4. Fai clic su Aggiungi operazioni e poi aggiungi le seguenti operazioni:

      • Aggiungi il servizio bigquery.googleapis.com.
        1. Fai clic su Tutti i metodi.
        2. Fai clic su Aggiungi tutti i metodi.
  5. Fai clic su Salva.

gcloud

  1. Se non è già impostato un progetto di quota, impostalo. Scegli un progetto in cui è abilitata l'API Gestore contesto accesso.

    gcloud config set billing/quota_project QUOTA_PROJECT_ID

    Sostituisci QUOTA_PROJECT_ID con l'ID del progetto che vuoi utilizzare per la fatturazione e la quota.

  2. Crea un file denominato egress-rule.yaml con i seguenti contenuti:

    - egressFrom:
        identities:
        - PRINCIPAL_ID
      egressTo:
        operations:
        - serviceName: bigquery.googleapis.com
          methodSelectors:
          - method: '*'
        resources:
        - '*'

    Sostituisci PRINCIPAL_ID con l'identificatore dell'entità utilizzata per chiamare l'API Security Command Center.

  3. Crea un file denominato ingress-rule.yaml con i seguenti contenuti:

    - ingressFrom:
        identities:
        - PRINCIPAL_ID
        sources:
        - accessLevel: '*'
      ingressTo:
        operations:
        - serviceName: bigquery.googleapis.com
          methodSelectors:
          - method: '*'
        resources:
        - projects/PROJECT_ID

    Sostituisci PRINCIPAL_ID con l'identificatore dell'entità utilizzata per chiamare l'API Security Command Center.

    Sostituisci PROJECT_ID con l'ID del progetto che contiene il set di dati BigQuery.

  4. Aggiungi la regola in uscita al perimetro:

    gcloud access-context-manager perimeters update PERIMETER_NAME \
        --set-egress-policies=egress-rule.yaml

    Sostituisci quanto segue:

    • PERIMETER_NAME: il nome del perimetro. Ad esempio, accessPolicies/1234567890/servicePerimeters/example_perimeter.

      Per trovare il perimetro di servizio da modificare, puoi controllare i log per individuare le voci che mostrano violazioni di RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER. In queste voci, controlla il campo servicePerimeterName:

      accessPolicies/ACCESS_POLICY_ID/servicePerimeters/SERVICE_PERIMETER_NAME
  5. Aggiungi la regola in entrata al perimetro:

    gcloud access-context-manager perimeters update PERIMETER_NAME \
        --set-ingress-policies=ingress-rule.yaml

    Sostituisci quanto segue:

    • PERIMETER_NAME: il nome del perimetro. Ad esempio, accessPolicies/1234567890/servicePerimeters/example_perimeter.

      Per trovare il perimetro di servizio da modificare, puoi controllare i log per individuare le voci che mostrano violazioni di RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER. In queste voci, controlla il campo servicePerimeterName:

      accessPolicies/ACCESS_POLICY_ID/servicePerimeters/SERVICE_PERIMETER_NAME

Per saperne di più, consulta Regole in entrata e in uscita.

Configura una nuova esportazione in BigQuery

In questo passaggio, creerai una configurazione di esportazione per esportare i risultati in un'istanza BigQuery. Puoi creare configurazioni di esportazione a livello di progetto, cartella o organizzazione. Ad esempio, se vuoi esportare i risultati di un progetto in un set di dati BigQuery, crei una configurazione di esportazione a livello di progetto per esportare solo i risultati correlati a quel progetto. Facoltativamente, puoi specificare filtri per esportare solo determinati risultati.

Assicurati di creare le configurazioni di esportazione al livello appropriato. Ad esempio, se crei una configurazione di esportazione nel Progetto B per esportare i risultati dal Progetto A e definisci filtri come resource.project_display_name: project-a-id, la configurazione non esporta alcun risultato.

Puoi creare un massimo di 500 configurazioni di esportazione in BigQuery per la tua organizzazione. Puoi utilizzare lo stesso set di dati per più configurazioni di esportazione. Se utilizzi lo stesso set di dati, tutti gli aggiornamenti verranno apportati alla stessa tabella dei risultati.

Quando crei la prima configurazione di esportazione, viene creato automaticamente un account di servizio. Questo account di servizio è necessario per creare o aggiornare la tabella dei risultati all'interno di un set di dati e per esportare i risultati nella tabella. Ha il formato service-org-ORGANIZATION_ID@gcp-sa-scc-notification.iam.gservicaccount.com e gli viene concesso il ruolo BigQuery Data Editor (roles/bigquery.dataEditor) a livello di set di dati BigQuery.

gcloud

  1. Vai alla console Google Cloud .

    Vai alla console Google Cloud

  2. Seleziona il progetto per cui hai abilitato l'API Security Command Center.

  3. Fai clic su Attiva Cloud Shell.

  4. Per creare una nuova configurazione di esportazione, esegui questo comando:

    gcloud scc bqexports create BIGQUERY_EXPORT \
        --dataset=DATASET_NAME \
        --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID \
        --location=LOCATION \
        [--description=DESCRIPTION] \
        [--filter=FILTER] \
        [--deletion-notifications-enabled]
    

    Sostituisci quanto segue:

    • BIGQUERY_EXPORT con un nome per questa configurazione di esportazione.
    • DATASET_NAME con il nome del set di dati BigQuery, ad esempio projects/PROJECT_ID/datasets/DATASET_ID.
    • FOLDER_ID, ORGANIZATION_ID o PROJECT_ID con il nome della cartella, dell'organizzazione o del progetto. Devi impostare una di queste opzioni. Per le cartelle e le organizzazioni, il nome è l'ID cartella o l'ID organizzazione. Per i progetti, il nome è il numero o l'ID progetto.
    • LOCATION: la località di Security Command Center in cui creare una configurazione di esportazione; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.
    • DESCRIPTION con una descrizione leggibile della configurazione di esportazione. Questa variabile è facoltativa.
    • FILTER con un'espressione che definisce i risultati da includere nell'esportazione. Ad esempio, se vuoi filtrare in base alla categoria XSS_SCRIPTING, digita "category=\"XSS_SCRIPTING\". Questa variabile è facoltativa.

    Utilizza i seguenti flag per configurare se ricevere notifiche per i risultati eliminati. Se non specifichi nessuno dei due flag, il comportamento predefinito è non esportare i risultati eliminati.

    • --deletion-notifications-enabled: attiva le notifiche per i risultati eliminati a causa delle policy di conservazione. Se l'opzione è abilitata, i risultati eliminati vengono esportati in BigQuery con deleted_finding = true. Questo flag si applica solo agli eventi di eliminazione futuri. I risultati eliminati prima dell'attivazione di questo flag non vengono esportati retroattivamente.

    • --no-deletion-notifications-enabled: disattiva le notifiche per i risultati eliminati.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del fornitore Terraform.

Crea una configurazione di esportazione per un'organizzazione:

resource "google_bigquery_dataset" "default" {
  dataset_id                  = "my-dataset"
  friendly_name               = "test"
  description                 = "This is a test description"
  location                    = "US"
  default_table_expiration_ms = 3600000
  default_partition_expiration_ms = null

  labels = {
    env = "default"
  }

  lifecycle {
    ignore_changes = [default_partition_expiration_ms]
  }
}

resource "google_scc_v2_organization_scc_big_query_export" "custom_big_query_export_config" {
  name         = "my-export"
  big_query_export_id    = "my-export"
  organization = "123456789"
  dataset      = google_bigquery_dataset.default.id
  location     = "global"
  description  = "Cloud Security Command Center Findings Big Query Export Config"
  filter       = "state=\"ACTIVE\" AND NOT mute=\"MUTED\""
}

Crea una configurazione di esportazione per una cartella:

resource "google_folder" "folder" {
  parent       = "organizations/123456789"
  display_name = "folder-name"

  deletion_protection = false
}

resource "google_bigquery_dataset" "default" {
  dataset_id                  = "my_dataset_id"
  friendly_name               = "test"
  description                 = "This is a test description"
  location                    = "US"
  default_table_expiration_ms = 3600000
  default_partition_expiration_ms = null

  labels = {
    env = "default"
  }

  lifecycle {
    ignore_changes = [default_partition_expiration_ms]
  }
}

resource "google_scc_v2_folder_scc_big_query_export" "custom_big_query_export_config" {
  big_query_export_id    = "my-export"
  folder       = google_folder.folder.folder_id
  dataset      = google_bigquery_dataset.default.id
  location     = "global"
  description  = "Cloud Security Command Center Findings Big Query Export Config"
  filter       = "state=\"ACTIVE\" AND NOT mute=\"MUTED\""
}

Crea una configurazione di esportazione per un progetto:

resource "google_bigquery_dataset" "default" {
  dataset_id                  = "my_dataset_id"
  friendly_name               = "test"
  description                 = "This is a test description"
  location                    = "US"
  default_table_expiration_ms = 3600000
  default_partition_expiration_ms = null

  labels = {
    env = "default"
  }

  lifecycle {
    ignore_changes = [default_partition_expiration_ms]
  }
}

resource "google_scc_v2_project_scc_big_query_export" "custom_big_query_export_config" {
  name         = "my-export"
  big_query_export_id    = "my-export"
  project      = "my-project-name"
  dataset      = google_bigquery_dataset.default.id
  location     = "global"
  description  = "Cloud Security Command Center Findings Big Query Export Config"
  filter       = "state=\"ACTIVE\" AND NOT mute=\"MUTED\""
}

Java

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.


import com.google.cloud.securitycenter.v2.BigQueryExport;
import com.google.cloud.securitycenter.v2.CreateBigQueryExportRequest;
import com.google.cloud.securitycenter.v2.OrganizationLocationName;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import java.io.IOException;
import java.util.UUID;

public class CreateBigQueryExport {

  public static void main(String[] args) throws IOException {
    // TODO(Developer): Modify the following variable values.
    // organizationId: Google Cloud Organization id.
    String organizationId = "{google-cloud-organization-id}";

    // projectId: Google Cloud Project id.
    String projectId = "{your-project}";

    // Specify the location.
    String location = "global";

    // filter: Expression that defines the filter to apply across create/update events of findings.
    String filter = "severity=\"LOW\" OR severity=\"MEDIUM\"";

    // bigQueryDatasetId: The BigQuery dataset to write findings' updates to.
    String bigQueryDatasetId = "{bigquery-dataset-id}";

    // bigQueryExportId: Unique identifier provided by the client.
    // For more info, see:
    // https://cloud.google.com/security-command-center/docs/how-to-analyze-findings-in-big-query#export_findings_from_to
    String bigQueryExportId = "default-" + UUID.randomUUID().toString().split("-")[0];

    createBigQueryExport(organizationId, location, projectId, filter, bigQueryDatasetId,
        bigQueryExportId);
  }

  // Create export configuration to export findings from a project to a BigQuery dataset.
  // Optionally specify filter to export certain findings only.
  public static BigQueryExport createBigQueryExport(String organizationId, String location,
      String projectId, String filter, String bigQueryDatasetId, String bigQueryExportId)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      OrganizationLocationName organizationName = OrganizationLocationName.of(organizationId,
          location);
      // Create the BigQuery export configuration.
      BigQueryExport bigQueryExport =
          BigQueryExport.newBuilder()
              .setDescription(
                  "Export low and medium findings if the compute resource "
                      + "has an IAM anomalous grant")
              .setFilter(filter)
              .setDataset(String.format("projects/%s/datasets/%s", projectId, bigQueryDatasetId))
              .build();

      CreateBigQueryExportRequest bigQueryExportRequest =
          CreateBigQueryExportRequest.newBuilder()
              .setParent(organizationName.toString())
              .setBigQueryExport(bigQueryExport)
              .setBigQueryExportId(bigQueryExportId)
              .build();

      // Create the export request.
      BigQueryExport response = client.createBigQueryExport(bigQueryExportRequest);

      System.out.printf("BigQuery export request created successfully: %s\n", response.getName());
      return response;
    }
  }
}

Python

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.



def create_bigquery_export(
    parent: str, export_filter: str, bigquery_dataset_id: str, bigquery_export_id: str
):
    from google.cloud import securitycenter_v2

    """
    Create export configuration to export findings from a project to a BigQuery dataset.
    Optionally specify filter to export certain findings only.

    Args:
        parent: Use any one of the following resource paths:
             - organizations/{organization_id}/locations/{location_id}
             - folders/{folder_id}/locations/{location_id}
             - projects/{project_id}/locations/{location_id}
        export_filter: Expression that defines the filter to apply across create/update events of findings.
        bigquery_dataset_id: The BigQuery dataset to write findings' updates to.
             - projects/{PROJECT_ID}/datasets/{BIGQUERY_DATASET_ID}
        bigquery_export_id: Unique identifier provided by the client.
             - example id: f"default-{str(uuid.uuid4()).split('-')[0]}"
        For more info, see:
        https://cloud.google.com/security-command-center/docs/how-to-analyze-findings-in-big-query#export_findings_from_to
    """
    client = securitycenter_v2.SecurityCenterClient()

    # Create the BigQuery export configuration.
    bigquery_export = securitycenter_v2.BigQueryExport()
    bigquery_export.description = "Export low and medium findings if the compute resource has an IAM anomalous grant"
    bigquery_export.filter = export_filter
    bigquery_export.dataset = bigquery_dataset_id

    request = securitycenter_v2.CreateBigQueryExportRequest()
    request.parent = parent
    request.big_query_export = bigquery_export
    request.big_query_export_id = bigquery_export_id

    # Create the export request.
    response = client.create_big_query_export(request)

    print(f"BigQuery export request created successfully: {response.name}\n")
    return response

Dovresti visualizzare i risultati nel set di dati BigQuery entro circa 15 minuti dalla creazione della configurazione di esportazione. Dopo la creazione della tabella BigQuery, tutti i risultati nuovi e aggiornati che corrispondono al filtro e all'ambito verranno visualizzati nella tabella quasi in tempo reale.

Per esaminare i risultati, consulta Esamina i risultati.

Crea una regola in entrata per la nuova esportazione in BigQuery

Se utilizzi i Controlli di servizio VPC e il tuo set di dati BigQuery fa parte di un progetto all'interno di un perimetro di servizio, devi creare una regola in entrata per una nuova esportazione in BigQuery.

Console

  1. Riapri il perimetro di servizio della sezione precedente.

    Vai a Controlli di servizio VPC

Aggiungi una regola in entrata

  1. Fai clic su Criterio in entrata.
  2. Fai clic su Aggiungi una regola in entrata.
  3. Nella sezione Da, imposta i seguenti dettagli:

    1. In Identità > Identità, seleziona Seleziona identità e gruppi.
    2. Fai clic su Aggiungi identità.
    3. Inserisci l'indirizzo email che identifica l'agente di servizio di configurazione di BigQuery Export. Questo indirizzo ha il seguente formato:

      service-org-ORGANIZATION_ID@gcp-sa-scc-notification.iam.gserviceaccount.com

      Sostituisci ORGANIZATION_ID con l'ID organizzazione.

    4. Seleziona l'agente di servizio o premi INVIO, quindi fai clic su Aggiungi identità.
  4. Nella sezione A, imposta i seguenti dettagli:

    1. In Risorse > Progetti, seleziona Seleziona progetti.
    2. Fai clic su Aggiungi progetti, quindi aggiungi il progetto che contiene il set di dati BigQuery.
    3. In Operazioni o ruoli IAM, seleziona Seleziona operazioni.
    4. Fai clic su Aggiungi operazioni e poi aggiungi le seguenti operazioni:

      • Aggiungi il servizio bigquery.googleapis.com.
        1. Fai clic su Tutti i metodi.
        2. Fai clic su Aggiungi tutti i metodi.
  5. Fai clic su Salva.

gcloud

  1. Se non è già impostato un progetto di quota, impostalo. Scegli un progetto in cui è abilitata l'API Gestore contesto accesso.

    gcloud config set billing/quota_project QUOTA_PROJECT_ID

    Sostituisci QUOTA_PROJECT_ID con l'ID del progetto che vuoi utilizzare per la fatturazione e la quota.

  2. Crea un file denominato ingress-rule.yaml con i seguenti contenuti:

    - ingressFrom:
        identities:
        - serviceAccount:service-org-ORGANIZATION_ID@gcp-sa-scc-notification.iam.gserviceaccount.com
        sources:
        - accessLevel: '*'
      ingressTo:
        operations:
        - serviceName: bigquery.googleapis.com
          methodSelectors:
          - method: '*'
        resources:
        - projects/PROJECT_ID

    Sostituisci ORGANIZATION_ID con l'ID organizzazione.

    Sostituisci PROJECT_ID con l'ID del progetto che contiene il set di dati BigQuery.

  3. Aggiungi la regola in entrata al perimetro:

    gcloud access-context-manager perimeters update PERIMETER_NAME \
        --set-ingress-policies=ingress-rule.yaml

    Sostituisci quanto segue:

    • PERIMETER_NAME: il nome del perimetro. Ad esempio, accessPolicies/1234567890/servicePerimeters/example_perimeter.

      Per trovare il perimetro di servizio da modificare, puoi controllare i log per individuare le voci che mostrano violazioni di RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER. In queste voci, controlla il campo servicePerimeterName:

      accessPolicies/ACCESS_POLICY_ID/servicePerimeters/SERVICE_PERIMETER_NAME

Per saperne di più, consulta Regole in entrata e in uscita.

I progetti, gli utenti e i service account selezionati ora possono accedere alle risorse protette ed esportare i risultati.

Se hai seguito tutti i passaggi di questa guida e le esportazioni funzionano correttamente, ora puoi eliminare quanto segue:

  • La regola in entrata per l'entità
  • La regola in uscita per l'entità

Queste regole erano necessarie solo per configurare l'esportazione. Tuttavia, affinché le configurazioni di esportazione continuino a funzionare, devi mantenere la regola in entrata che hai creato in precedenza, che consente a Security Command Center di esportare i risultati nel set di dati BigQuery dietro il perimetro di servizio.

Visualizza i dettagli di una configurazione di esportazione

gcloud

  1. Vai alla console Google Cloud .

    Vai alla console Google Cloud

  2. Seleziona il progetto per cui hai abilitato l'API Security Command Center.

  3. Fai clic su Attiva Cloud Shell.

  4. Per verificare i dettagli della configurazione di esportazione, esegui questo comando:

    gcloud scc bqexports get BIGQUERY_EXPORT \
        --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID \
        --location=LOCATION
    

    Sostituisci quanto segue:

    • BIGQUERY_EXPORT con il nome di questa configurazione di esportazione.
    • FOLDER_ID, ORGANIZATION_ID o PROJECT_ID con il nome della cartella, dell'organizzazione o del progetto. Devi impostare una di queste opzioni. Per le cartelle e le organizzazioni, il nome è l'ID cartella o l'ID organizzazione. Per i progetti, il nome è il numero o l'ID progetto.
    • LOCATION: la località di Security Command Center in cui creare una configurazione di esportazione; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.

      Ad esempio, per ottenere una configurazione di esportazione denominata my-bq-export da un'organizzazione con un ID organizzazione impostato su 123, esegui:

      gcloud scc bqexports get my-bq-export \
          --organization=123 \
          --location=global
      

Java

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.


import com.google.cloud.securitycenter.v2.BigQueryExport;
import com.google.cloud.securitycenter.v2.BigQueryExportName;
import com.google.cloud.securitycenter.v2.GetBigQueryExportRequest;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import java.io.IOException;

public class GetBigQueryExport {

  public static void main(String[] args) throws IOException {
    // TODO(Developer): Modify the following variable values.
    // organizationId: Google Cloud Organization id.
    String organizationId = "{google-cloud-organization-id}";

    // Specify the location to list the findings.
    String location = "global";

    // bigQueryExportId: Unique identifier that is used to identify the export.
    String bigQueryExportId = "{bigquery-export-id}";

    getBigQueryExport(organizationId, location, bigQueryExportId);
  }

  // Retrieve an existing BigQuery export.
  public static BigQueryExport getBigQueryExport(String organizationId, String location,
      String bigQueryExportId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      BigQueryExportName bigQueryExportName = BigQueryExportName.of(organizationId, location,
          bigQueryExportId);

      GetBigQueryExportRequest bigQueryExportRequest =
          GetBigQueryExportRequest.newBuilder()
              .setName(bigQueryExportName.toString())
              .build();

      BigQueryExport response = client.getBigQueryExport(bigQueryExportRequest);
      System.out.printf("Retrieved the BigQuery export: %s", response.getName());
      return response;
    }
  }
}

Python

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

def get_bigquery_export(parent: str, bigquery_export_id: str):
    from google.cloud import securitycenter_v2

    """
    Retrieve an existing BigQuery export.
    Args:
        parent: Use any one of the following resource paths:
                 - organizations/{organization_id}/locations/{location_id}
                 - folders/{folder_id}/locations/{location_id}
                 - projects/{project_id}/locations/{location_id}
        bigquery_export_id: Unique identifier that is used to identify the export.
    """

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.GetBigQueryExportRequest()
    request.name = f"{parent}/bigQueryExports/{bigquery_export_id}"

    response = client.get_big_query_export(request)
    print(f"Retrieved the BigQuery export: {response.name}")
    return response

Aggiorna una configurazione di esportazione

Se necessario, puoi modificare il filtro, il set di dati e la descrizione di una configurazione di esportazione esistente. Non puoi modificare il nome della configurazione di esportazione.

gcloud

  1. Vai alla console Google Cloud .

    Vai alla console Google Cloud

  2. Seleziona il progetto per cui hai abilitato l'API Security Command Center.

  3. Fai clic su Attiva Cloud Shell.

  4. Per aggiornare una configurazione di esportazione, esegui questo comando:

    gcloud scc bqexports update BIGQUERY_EXPORT \
        --dataset=DATASET_NAME \
        --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID \
        --location=LOCATION \
        [--description=DESCRIPTION] \
        [--filter=FILTER] \
        [--deletion-notifications-enabled]
    

    Sostituisci quanto segue:

    • BIGQUERY_EXPORT con il nome della configurazione di esportazione che vuoi aggiornare.
    • DATASET_NAME con il nome del set di dati BigQuery, ad esempio projects/PROJECT_ID/datasets/DATASET_ID.
    • FOLDER_ID, ORGANIZATION_ID o PROJECT_ID con il nome della cartella, dell'organizzazione o del progetto. Devi impostare una di queste opzioni. Per le cartelle e le organizzazioni, il nome è l'ID cartella o l'ID organizzazione. Per i progetti, il nome è il numero o l'ID progetto.
    • LOCATION: la località di Security Command Center in cui aggiornare la configurazione di esportazione; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.
    • DESCRIPTION con una descrizione leggibile della configurazione di esportazione. Questa variabile è facoltativa.
    • FILTER con un'espressione che definisce i risultati da includere nell'esportazione. Ad esempio, se vuoi filtrare in base alla categoria XSS_SCRIPTING, digita "category=\"XSS_SCRIPTING\". Questa variabile è facoltativa.

    Utilizza i seguenti flag per configurare se ricevere notifiche per i risultati eliminati. Se non specifichi nessuno dei due flag, il comportamento predefinito è non esportare i risultati eliminati.

    • --deletion-notifications-enabled: attiva le notifiche per i risultati eliminati a causa dei criteri di conservazione. Se abilitata, i risultati eliminati vengono esportati in BigQuery con deleted_finding = true. Questo flag si applica solo agli eventi di eliminazione futuri. I risultati eliminati prima dell'attivazione di questo flag non vengono esportati in modo retroattivo.

    • --no-deletion-notifications-enabled: disattiva le notifiche per i risultati eliminati.

Java

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.


import com.google.cloud.securitycenter.v2.BigQueryExport;
import com.google.cloud.securitycenter.v2.BigQueryExportName;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.UpdateBigQueryExportRequest;
import com.google.protobuf.FieldMask;
import java.io.IOException;

public class UpdateBigQueryExport {

  public static void main(String[] args) throws IOException {
    // TODO(Developer): Modify the following variable values.
    // organizationId: Google Cloud Organization id.
    String organizationId = "{google-cloud-organization-id}";

    // Specify the location to list the findings.
    String location = "global";

    // filter: Expression that defines the filter to apply across create/update events of findings.
    String filter =
        "severity=\"LOW\" OR severity=\"MEDIUM\" AND "
            + "category=\"Persistence: IAM Anomalous Grant\" AND "
            + "-resource.type:\"compute\"";

    // bigQueryExportId: Unique identifier provided by the client.
    // For more info, see:
    // https://cloud.google.com/security-command-center/docs/how-to-analyze-findings-in-big-query#export_findings_from_to
    String bigQueryExportId = "{bigquery-export-id}";

    updateBigQueryExport(organizationId, location, filter, bigQueryExportId);
  }

  // Updates an existing BigQuery export.
  public static BigQueryExport updateBigQueryExport(String organizationId, String location,
      String filter, String bigQueryExportId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      // Optionally BigQueryExportName or String can be used
      // String bigQueryExportName = String.format("organizations/%s/locations/%s
      // /bigQueryExports/%s",organizationId,location, bigQueryExportId);
      BigQueryExportName bigQueryExportName = BigQueryExportName.of(organizationId, location,
          bigQueryExportId);

      //  Set the new values for export configuration.
      BigQueryExport bigQueryExport =
          BigQueryExport.newBuilder()
              .setName(bigQueryExportName.toString())
              .setDescription("Updated description.")
              .setFilter(filter)
              .build();

      UpdateBigQueryExportRequest request =
          UpdateBigQueryExportRequest.newBuilder()
              .setBigQueryExport(bigQueryExport)
              // Set the update mask to specify which properties should be updated.
              // If empty, all mutable fields will be updated.
              // For more info on constructing field mask path, see the proto or:
              // https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.FieldMask
              .setUpdateMask(FieldMask.newBuilder()
                  .addPaths("filter")
                  .addPaths("description").build())
              .build();

      BigQueryExport response = client.updateBigQueryExport(request);
      System.out.println("BigQueryExport updated successfully!");
      return response;
    }
  }
}

Python

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

def update_bigquery_export(parent: str, export_filter: str, bigquery_export_id: str):
    """
    Updates an existing BigQuery export.
    Args:
        parent: Use any one of the following resource paths:
                 - organizations/{organization_id}/locations/{location_id}
                 - folders/{folder_id}/locations/{location_id}
                 - projects/{project_id}/locations/{location_id}
        export_filter: Expression that defines the filter to apply across create/update events of findings.export_filter = 'severity="MEDIUM"'
        bigquery_export_id: Unique identifier provided by the client.
        For more info, see:
        https://cloud.google.com/security-command-center/docs/how-to-analyze-findings-in-big-query#export_findings_from_to
    """
    from google.cloud import securitycenter_v2
    from google.protobuf import field_mask_pb2

    client = securitycenter_v2.SecurityCenterClient()

    # Set the new values for export configuration.
    bigquery_export = securitycenter_v2.BigQueryExport()
    bigquery_export.name = f"{parent}/bigQueryExports/{bigquery_export_id}"
    bigquery_export.filter = export_filter
    bigquery_export.description = "Updated description."

    # Field mask to only update the export filter.
    # Set the update mask to specify which properties should be updated.
    # If empty, all mutable fields will be updated.
    # For more info on constructing field mask path, see the proto or:
    # https://googleapis.dev/python/protobuf/latest/google/protobuf/field_mask_pb2.html
    field_mask = field_mask_pb2.FieldMask(paths=["filter", "description"])

    request = securitycenter_v2.UpdateBigQueryExportRequest()
    request.big_query_export = bigquery_export
    request.update_mask = field_mask

    response = client.update_big_query_export(request)

    if response.filter != export_filter:
        print("Failed to update BigQueryExport!")
        return
    print("BigQueryExport updated successfully!")
    return response

Visualizza tutte le configurazioni di esportazione

Puoi visualizzare tutte le configurazioni di esportazione all'interno della tua organizzazione, cartella o progetto.

gcloud

  1. Vai alla console Google Cloud .

    Vai alla console Google Cloud

  2. Seleziona il progetto per cui hai abilitato l'API Security Command Center.

  3. Fai clic su Attiva Cloud Shell.

  4. Per elencare le configurazioni di esportazione, esegui questo comando:

    gcloud scc bqexports list \
        --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID \
        --location=LOCATION \
        [--limit=LIMIT] \
        [--page-size=PAGE_SIZE]
    

    Sostituisci quanto segue:

    • FOLDER_ID, ORGANIZATION_ID o PROJECT_ID con il nome della cartella, dell'organizzazione o del progetto. Devi impostare una di queste opzioni. Per le cartelle e le organizzazioni, il nome è l'ID cartella o l'ID organizzazione. Per i progetti, il nome è il numero o l'ID progetto.

      Se specifichi un ID organizzazione, l'elenco include tutte le configurazioni di esportazione definite in quell'organizzazione, incluse quelle a livello di cartella e di progetto. Se specifichi un ID cartella, l'elenco include tutte le configurazioni di esportazione definite a livello di cartella e nei progetti all'interno della cartella. Se specifichi un numero o un ID progetto, l'elenco include tutte le configurazioni di esportazione solo per quel progetto.

    • LOCATION: la località di Security Command Center in cui elencare le configurazioni di esportazione; se la residenza dei dati è abilitata, utilizza eu, sa o us; in caso contrario, utilizza il valore global.

    • LIMIT con il numero di configurazioni di esportazione che vuoi visualizzare. Questa variabile è facoltativa.

    • PAGE_SIZE con un valore della dimensione della pagina. Questa variabile è facoltativa.

Java

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.


import com.google.cloud.securitycenter.v2.BigQueryExport;
import com.google.cloud.securitycenter.v2.ListBigQueryExportsRequest;
import com.google.cloud.securitycenter.v2.OrganizationLocationName;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.SecurityCenterClient.ListBigQueryExportsPagedResponse;
import java.io.IOException;

public class ListBigQueryExports {

  public static void main(String[] args) throws IOException {
    // TODO(Developer): Modify the following variable values.
    // organizationId: Google Cloud Organization id.
    String organizationId = "{google-cloud-organization-id}";

    // Specify the location to list the findings.
    String location = "global";

    listBigQueryExports(organizationId, location);
  }

  // List BigQuery exports in the given parent.
  public static ListBigQueryExportsPagedResponse listBigQueryExports(String organizationId,
      String location) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      OrganizationLocationName organizationName = OrganizationLocationName.of(organizationId,
          location);

      ListBigQueryExportsRequest request = ListBigQueryExportsRequest.newBuilder()
          .setParent(organizationName.toString())
          .build();

      ListBigQueryExportsPagedResponse response = client.listBigQueryExports(request);

      System.out.println("Listing BigQuery exports:");
      for (BigQueryExport bigQueryExport : response.iterateAll()) {
        System.out.println(bigQueryExport.getName());
      }
      return response;
    }
  }
}

Python

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

def list_bigquery_exports(parent: str):
    from google.cloud import securitycenter_v2

    """
    List BigQuery exports in the given parent.
    Args:
         parent: The parent which owns the collection of BigQuery exports.
             Use any one of the following resource paths:
                 - organizations/{organization_id}/locations/{location_id}
                 - folders/{folder_id}/locations/{location_id}
                 - projects/{project_id}/locations/{location_id}
    """

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.ListBigQueryExportsRequest()
    request.parent = parent

    response = client.list_big_query_exports(request)

    print("Listing BigQuery exports:")
    for bigquery_export in response:
        print(bigquery_export.name)
    return response

Elimina una configurazione di esportazione

Se non hai più bisogno di una configurazione di esportazione, puoi eliminarla.

gcloud

  1. Vai alla console Google Cloud .

    Vai alla console Google Cloud

  2. Seleziona il progetto per cui hai abilitato l'API Security Command Center.

  3. Fai clic su Attiva Cloud Shell.

  4. Per eliminare una configurazione di esportazione, esegui questo comando:

    gcloud scc bqexports delete BIGQUERY_EXPORT \
        --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID \
        --location=LOCATION
    

    Sostituisci quanto segue:

    • BIGQUERY_EXPORT con un nome per la configurazione di esportazione che vuoi eliminare.
    • FOLDER_ID, ORGANIZATION_ID o PROJECT_ID con il nome della cartella, dell'organizzazione o del progetto. Devi impostare una di queste opzioni. Per le cartelle e le organizzazioni, il nome è l'ID cartella o l'ID organizzazione. Per i progetti, il nome è il numero o l'ID progetto.
    • LOCATION: la località di Security Command Center in cui eliminare la configurazione di esportazione; se la residenza dei dati è abilitata, utilizza eu, sa o us; altrimenti, utilizza il valore global.

      Ad esempio, per eliminare una configurazione di esportazione denominata my-bq-export da un'organizzazione con un ID organizzazione impostato su 123, esegui:

      gcloud scc bqexports delete my-bq-export \
          --organization=123 \
          --location=global
      

Java

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.


import com.google.cloud.securitycenter.v2.BigQueryExportName;
import com.google.cloud.securitycenter.v2.DeleteBigQueryExportRequest;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import java.io.IOException;

public class DeleteBigQueryExport {

  public static void main(String[] args) throws IOException {
    // TODO(Developer): Modify the following variable values.
    // organizationId: Google Cloud Organization id.
    String organizationId = "{google-cloud-organization-id}";

    // Specify the location to list the findings.
    String location = "global";

    // bigQueryExportId: Unique identifier that is used to identify the export.
    String bigQueryExportId = "{bigquery-export-id}";

    deleteBigQueryExport(organizationId, location, bigQueryExportId);
  }

  // Delete an existing BigQuery export.
  public static void deleteBigQueryExport(String organizationId, String location,
      String bigQueryExportId)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {
      // Optionally BigQueryExportName or String can be used
      // String bigQueryExportName = String.format("organizations/%s/locations/%s
      // /bigQueryExports/%s",organizationId,location, bigQueryExportId);
      BigQueryExportName bigQueryExportName = BigQueryExportName.of(organizationId, location,
          bigQueryExportId);

      DeleteBigQueryExportRequest bigQueryExportRequest =
          DeleteBigQueryExportRequest.newBuilder()
              .setName(bigQueryExportName.toString())
              .build();

      client.deleteBigQueryExport(bigQueryExportRequest);
      System.out.printf("BigQuery export request deleted successfully: %s", bigQueryExportId);
    }
  }
}

Python

Per eseguire l'autenticazione in Security Command Center, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

def delete_bigquery_export(parent: str, bigquery_export_id: str):
    """
    Delete an existing BigQuery export.
    Args:
        parent: Use any one of the following resource paths:
                 - organizations/{organization_id}/locations/{location_id}
                 - folders/{folder_id}/locations/{location_id}
                 - projects/{project_id}/locations/{location_id}
        bigquery_export_id: Unique identifier that is used to identify the export.
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.DeleteBigQueryExportRequest()
    request.name = f"{parent}/bigQueryExports/{bigquery_export_id}"

    client.delete_big_query_export(request)
    print(f"BigQuery export request deleted successfully: {bigquery_export_id}")

Dopo aver eliminato la configurazione di esportazione, puoi rimuovere i dati da Data Studio. Per saperne di più, consulta Rimuovi, elimina e ripristina un'origine dati.

Esamina i risultati in BigQuery

Dopo aver creato una configurazione di esportazione, i nuovi risultati vengono esportati nel set di dati BigQuery nel progetto specificato.

Per esaminare i risultati in BigQuery, segui questi passaggi:

  1. Vai al progetto in BigQuery.

    Vai a BigQuery

  2. Seleziona un progetto.

  3. Nel riquadro Explorer, espandi il nodo per il tuo progetto.

  4. Espandi il set di dati.

  5. Fai clic sulla tabella dei risultati.

  6. Nella scheda che si apre, fai clic su Anteprima. Viene visualizzato un set di dati di esempio.

Query utili

Questa sezione fornisce query di esempio per l'analisi dei dati dei risultati. Negli esempi seguenti, sostituisci DATASET con il nome assegnato al set di dati e PROJECT_ID con il nome del progetto per il set di dati.

Per risolvere eventuali errori, consulta Messaggi di errore.

Il numero di nuovi risultati creati e aggiornati ogni giorno

SELECT
    FORMAT_DATETIME("%Y-%m-%d", event_time) AS date,
    count(DISTINCT finding_id)
FROM `PROJECT_ID.DATASET.findings`
GROUP BY date
ORDER BY date DESC

Il record dei risultati più recente per ogni risultato

SELECT
    * EXCEPT(row)
FROM (
    SELECT *, ROW_NUMBER() OVER(
        PARTITION BY finding_id
        ORDER BY event_time DESC, finding.mute_update_time DESC
    ) AS row
    FROM `PROJECT_ID.DATASET.findings`
)
WHERE row = 1

Risultati attuali attivi, ordinati per ora

WITH latestFindings AS (
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT finding_id, event_time, finding
FROM latestFindings
WHERE finding.state = "ACTIVE"
ORDER BY event_time DESC

Risultati attuali che si trovano in un progetto

WITH latestFindings AS (
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT finding_id, event_time, finding, resource
FROM latestFindings
WHERE resource.project_display_name = 'PROJECT'

Sostituisci PROJECT con il nome del progetto.

Risultati attuali che si trovano in una cartella

WITH latestFindings AS(
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT finding_id, event_time, finding, resource
FROM latestFindings
CROSS JOIN UNNEST(resource.folders) AS folder
WHERE folder.resource_folder_display_name = 'FOLDER'

Sostituisci FOLDER con il nome della cartella.

Risultati attuali dello scanner Logging Scanner

WITH latestFindings AS (
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT finding_id, event_time, finding
FROM latestFindings
CROSS JOIN UNNEST(finding.source_properties) AS source_property
WHERE source_property.key = "ScannerName"
  AND source_property.value = "LOGGING_SCANNER"

Risultati attivi correnti di tipo Persistence: IAM Anomalous Grant

WITH latestFindings AS(
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT finding_id, event_time, finding
FROM latestFindings
WHERE finding.state = "ACTIVE"
  AND finding.category = "Persistence: IAM Anomalous Grant"

Correlare i risultati attivi di un determinato tipo con Cloud Audit Logs

Questa query di esempio aiuta a esaminare i risultati relativi alle concessioni IAM anomale di Event Threat Detection utilizzando Cloud Audit Logs, visualizzando la sequenza di azioni di attività di amministrazione del concedente durante la finestra temporale precedente e successiva all'azione di concessione IAM anomala. La seguente query mette in correlazione i log delle attività di amministrazione tra 1 ora prima e 1 ora dopo il timestamp del risultato.

WITH latestFindings AS(
    SELECT * EXCEPT(row)
    FROM (
        SELECT *, ROW_NUMBER() OVER(
            PARTITION BY finding_id
            ORDER BY event_time DESC, finding.mute_update_time DESC
        ) AS row
        FROM `PROJECT_ID.DATASET.findings`
    ) WHERE row = 1
)
SELECT
  finding_id,
  ANY_VALUE(event_time) as event_time,
  ANY_VALUE(finding.access.principal_email) as grantor,
  JSON_VALUE_ARRAY(ANY_VALUE(finding.source_properties_json), '$.properties.sensitiveRoleGrant.members') as grantees,
  ARRAY_AGG(
    STRUCT(
      timestamp,
      IF(timestamp < event_time, 'before', 'after') as timeline,
      protopayload_auditlog.methodName,
      protopayload_auditlog.resourceName,
      protopayload_auditlog.serviceName
    )
    ORDER BY timestamp ASC
  ) AS recent_activity
FROM (
  SELECT
    f.*,
    a.*,
  FROM latestFindings AS f
  LEFT JOIN `PROJECT_ID.DATASET.cloudaudit_googleapis_com_activity` AS a
  ON a.protopayload_auditlog.authenticationInfo.principalEmail = f.finding.access.principal_email
  WHERE f.finding.state = "ACTIVE"
    AND f.finding.category = "Persistence: IAM Anomalous Grant"
    AND a.timestamp >= TIMESTAMP_SUB(f.event_time, INTERVAL 1 HOUR)
    AND a.timestamp <= TIMESTAMP_ADD(f.event_time, INTERVAL 1 HOUR)
  )
GROUP BY
  finding_id
ORDER BY
  event_time DESC

L'output è simile al seguente:

Screenshot dei risultati della query che mostra i risultati con gli audit log correlati

Crea grafici in Data Studio

Data Studio ti consente di creare report e dashboard interattivi.

In generale, l'accesso a BigQuery tramite Data Studio comporta costi di utilizzo di BigQuery. Per saperne di più, consulta Visualizzazione dei dati di BigQuery utilizzando Data Studio.

Per creare un grafico che visualizzi i dati dei risultati in base alla gravità e alla categoria, segui questi passaggi:

  1. Apri Data Studio e accedi.
  2. Se richiesto, fornisci ulteriori informazioni e configura altre preferenze. Leggi i Termini di servizio e, se li accetti, continua.
  3. Fai clic su Report vuoto.
  4. Nella scheda Connessione ai dati, fai clic sulla scheda BigQuery.
  5. Se richiesto, autorizza Data Studio ad accedere ai progetti BigQuery.
  6. Connettiti ai dati dei risultati:

    1. In Progetto, seleziona il progetto per il set di dati. In alternativa, nella scheda I miei progetti, inserisci l'ID progetto per cercarlo.
    2. In Set di dati, fai clic sul nome del set di dati.
    3. In Tabella, fai clic su findings.
    4. Fai clic su Aggiungi.
    5. Nella finestra di dialogo, fai clic su Aggiungi al report.
  7. Dopo aver aggiunto il report, fai clic su Aggiungi un grafico.

  8. Fai clic su Grafico a colonne in pila, poi fai clic sull'area in cui vuoi posizionarlo.

    Screenshot della selezione del grafico
  9. Nel riquadro Grafico > Barra, nella scheda Dati, imposta i seguenti campi:

    1. Nel campo Dimensione, seleziona finding.severity.
    2. Nel campo Dimensione di distribuzione, seleziona finding.category.
    Screenshot di un grafico dei risultati classificati per gravità e sottoclassificati per categoria

Il report viene aggiornato per mostrare più colonne con i risultati suddivisi per gravità e categoria.

Passaggi successivi