Creazione e gestione di moduli personalizzati per Event Threat Detection

Solo livello Premium: questa funzionalità è disponibile solo con il livello Premium di Security Command Center.

Questa pagina spiega come creare e gestire moduli personalizzati per Event Threat Detection.

Prima di iniziare

Questa sezione descrive i requisiti per l'utilizzo di moduli personalizzati per Event Threat Detection.

Security Command Center Premium ed Event Threat Detection

Per utilizzare i moduli personalizzati di Event Threat Detection, è necessario abilitare Event Threat Detection. Per abilitare Event Threat Detection, vedi Abilitare o disabilitare un servizio integrato.

Ruoli IAM

I ruoli IAM determinano le azioni che puoi eseguire con i moduli personalizzati Event Threat Detection.

Importante: a partire dal 22 gennaio 2024, verrà eseguita la migrazione della funzionalità dei moduli personalizzati nella console Google Cloud in una nuova API sottostante.

Se la tua azienda utilizza ruoli IAM personalizzati per il controllo rigoroso dell'accesso alle risorse Google Cloud, per continuare a utilizzare i moduli personalizzati nella console Google Cloud dopo questa data, devi chiedere all'amministratore della sicurezza di aggiungere le seguenti autorizzazioni al ruolo personalizzato prima della data di migrazione, in base alle tue responsabilità:

• Per visualizzare o testare i moduli di rilevamento personalizzati di Event Threat Detection, devi disporre delle seguenti autorizzazioni, contenute nel ruolo IAM Visualizzatore moduli personalizzati ETD gestione Centro sicurezza (securitycentermanagement.etdCustomModulesViewer):
  • securitycentermanagement.eventThreatDetectionCustomModules.list
  • securitycentermanagement.eventThreatDetectionCustomModules.get
  • securitycentermanagement.effectiveEventThreatDetectionCustomModules.list
  • securitycentermanagement.effectiveEventThreatDetectionCustomModules.get
  • securitycentermanagement.eventThreatDetectionCustomModules.validate
• Per modificare i moduli di rilevamento personalizzati di Event Threat Detection, oltre alle autorizzazioni precedenti, devi avere anche le seguenti autorizzazioni, contenute nel ruolo IAM Editor moduli ETD personalizzati gestione Centro sicurezza (securitycentermanagement.etdCustomModulesEditor):
  • securitycentermanagement.eventThreatDetectionCustomModules.create
  • securitycentermanagement.eventThreatDetectionCustomModules.update
  • securitycentermanagement.eventThreatDetectionCustomModules.delete

Se la tua azienda utilizza ruoli IAM predefiniti, non devi fare nulla. Le nuove autorizzazioni sono già incluse nei ruoli predefiniti.

La seguente tabella contiene un elenco di autorizzazioni del modulo personalizzato Event Threat Detection e i ruoli IAM predefiniti che le includono. Queste autorizzazioni sono valide almeno fino al 22 gennaio 2024. Dopo questa data, saranno necessarie le autorizzazioni elencate nella seconda tabella seguente.

Puoi utilizzare la console Google Cloud o l'API Security Command Center per applicare questi ruoli a livello di organizzazione, cartella o progetto.

Autorizzazioni richieste prima del 22 gennaio 2024	Ruolo
securitycenter.eventthreatdetectioncustommodules.create securitycenter.eventthreatdetectioncustommodules.update securitycenter.eventthreatdetectioncustommodules.delete	roles/securitycenter.settingsEditor roles/securitycenter.admin
securitycenter.eventthreatdetectioncustommodules.get securitycenter.eventthreatdetectioncustommodules.list	roles/securitycenter.settingsViewer roles/securitycenter.adminViewer roles/securitycenter.admin

La seguente tabella contiene un elenco di autorizzazioni del modulo personalizzato Event Threat Detection che saranno richieste a partire dal 22 gennaio 2024, nonché i ruoli IAM predefiniti che le includono.

Puoi utilizzare la console Google Cloud o l'API Security Command Center per applicare questi ruoli a livello di organizzazione, cartella o progetto.

Autorizzazioni richieste dopo il 22 gennaio 2024	Ruolo
securitycentermanagement.eventThreatDetectionCustomModules.create securitycentermanagement.eventThreatDetectionCustomModules.update securitycentermanagement.eventThreatDetectionCustomModules.delete	roles/securitycentermanagement.etdCustomModulesEditor roles/securitycenter.settingsEditor roles/securitycenter.admin
securitycentermanagement.eventThreatDetectionCustomModules.list securitycentermanagement.eventThreatDetectionCustomModules.get securitycentermanagement.effectiveEventThreatDetectionCustomModules.list securitycentermanagement.effectiveEventThreatDetectionCustomModules.get securitycentermanagement.eventThreatDetectionCustomModules.validate	roles/securitycentermanagement.etdCustomModulesViewer roles/securitycentermanagement.etdCustomModulesEditor roles/securitycenter.adminViewer roles/securitycenter.admin

Se si verificano errori di accesso in Security Command Center, chiedi assistenza al tuo amministratore. Consulta una delle pagine seguenti, a seconda del livello a cui hai attivato Security Command Center:

• IAM per attivazioni a livello di organizzazione di Security Command Center

• IAM per le attivazioni a livello di progetto di Security Command Center

Log obbligatori

Assicurati che i log pertinenti siano attivati per l'organizzazione, le cartelle e i progetti. Per informazioni su quali log sono richiesti da ogni tipo di modulo personalizzato, consulta la tabella in Moduli e modelli personalizzati.

I log da origini esterne a Google Cloud non sono supportati.

Livelli di moduli personalizzati

Questo documento utilizza i termini seguenti per descrivere il livello a cui è stato creato un modulo personalizzato:

Modulo per la casa

Il modulo è stato creato nella vista o nell'ambito corrente. Ad esempio, se ti trovi nella visualizzazione organizzazione della console Google Cloud, i moduli residenziali sono i moduli creati a livello di organizzazione.

Modulo ereditato

Il modulo è stato creato in una vista o in un ambito padre. Ad esempio, un modulo creato a livello di organizzazione è un modulo ereditato a qualsiasi livello di cartella o progetto.

Modulo discendente

Il modulo è stato creato in una vista secondaria o in un ambito. Ad esempio, un modulo creato a livello di cartella o progetto è un modulo discendente a livello di organizzazione.

Creare moduli personalizzati

Puoi creare moduli personalizzati Event Threat Detection tramite la console Google Cloud o modificando un modello JSON e inviandolo tramite gcloud CLI. Se prevedi di usare gcloud CLI per creare moduli personalizzati, ti servono i modelli JSON.

Per un elenco dei modelli di moduli supportati, consulta Moduli e modelli personalizzati.

Struttura del modello

I modelli definiscono i parametri che i moduli personalizzati utilizzano per identificare le minacce nei log. I modelli sono scritti in JSON e hanno una struttura simile ai risultati generati da Security Command Center. Devi configurare un modello JSON solo se prevedi di utilizzare gcloud CLI per creare un modulo personalizzato.

Ogni modello contiene campi personalizzabili:

• severity: la gravità o il livello di rischio da assegnare ai risultati di questo tipo, LOW, MEDIUM, HIGH o CRITICAL.
• description: la descrizione del modulo personalizzato.
• recommendation: azioni consigliate per gestire i risultati generati dal modulo personalizzato.
• Parametri di rilevamento: le variabili utilizzate per valutare i log e i risultati dei trigger. I parametri di rilevamento sono diversi per ogni modulo, ma includono uno o più dei seguenti elementi:
  • domains: domini web da controllare
  • ips: indirizzi IP da controllare
  • permissions: autorizzazioni per monitorare
  • regions: regioni in cui sono consentite nuove istanze di Compute Engine
  • roles: ruoli da tenere d'occhio
  • accounts: account da controllare
  • Parametri che definiscono i tipi di istanza Compute Engine consentiti, ad esempio series, cpus e ram_mb.
  • Espressioni regolari da cui controllare le proprietà, ad esempio caller_pattern e resource_pattern.

Il seguente esempio di codice è un modello JSON di esempio per Configurable Bad IP.

{
  "metadata": {
    "severity": "LOW",
    "description": "Flagged by Cymbal as malicious",
    "recommendation": "Contact the owner of the relevant project."
  },
  "ips": [
    "192.0.2.1",
    "192.0.2.0/24"
  ]
}

Nell'esempio precedente, il modulo personalizzato genera un risultato di bassa gravità se i log indicano una risorsa connessa all'indirizzo IP 192.0.2.1 o 192.0.2.0/24.

Modificare un modello di modulo

Per creare moduli, devi scegliere un modello di modulo e modificarlo.

Se prevedi di utilizzare Google Cloud CLI per creare il tuo modulo personalizzato, devi eseguire questa attività.

Se prevedi di utilizzare la console Google Cloud per creare il modulo personalizzato, salta questa attività. Utilizzerai le opzioni visualizzate sullo schermo per modificare i parametri del modello.

1. Scegli un modello da Moduli e modelli personalizzati.
2. Copia il codice in un file locale.
3. Aggiorna i parametri che vuoi utilizzare per valutare i log.
4. Salva il file come file JSON.
5. Crea un modulo personalizzato tramite gcloud CLI utilizzando il file JSON.

Crea un modulo personalizzato

Questa sezione descrive come creare un modulo personalizzato mediante la console Google Cloud e gcloud CLI. Ogni modulo personalizzato di Event Threat Detection ha un limite di dimensioni di 6 MB.

Per creare un modulo personalizzato:

Console

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. Fai clic su Crea modulo.
3. Fai clic sul modello di modulo che vuoi utilizzare.
4. Fai clic su Seleziona.
5. In Nome modulo, inserisci un nome visualizzato per il nuovo modello. Il nome non deve superare i 128 caratteri e deve contenere solo caratteri alfanumerici e trattini bassi, ad esempio example_custom_module.
6. Seleziona o aggiungi i valori parametro richiesti. I parametri sono diversi per ogni modulo. Ad esempio, se hai selezionato il modello di modulo Configurable allowed Compute Engine region, devi selezionare una o più regioni. In alternativa, fornisci l'elenco in formato JSON.
7. Tocca Avanti.
8. In Gravità, inserisci il livello di gravità che vuoi assegnare ai risultati generati dal nuovo modulo personalizzato.
9. In Descrizione, inserisci una descrizione per il nuovo modulo personalizzato.
10. In Passaggi successivi, inserisci le azioni consigliate in formato di testo normale. Eventuali interruzioni di paragrafo aggiunte vengono ignorate.
11. Fai clic su Crea.

gcloud

1. Crea un file JSON contenente la definizione del modulo personalizzato. Utilizza i modelli in Moduli e modelli personalizzati come guida.

2. Crea il modulo personalizzato inviando il file JSON in un comando gcloud:

 gcloud alpha scc custom-modules etd create \
     --RESOURCE_FLAG=RESOURCE_ID \
     --display-name="DISPLAY_NAME" \
     --module-type="MODULE_TYPE" \
     --enablement-state="ENABLED" \
     --custom-config-from-file=PATH_TO_JSON_FILE

Sostituisci quanto segue:

• RESOURCE_FLAG: l'ambito della risorsa padre in cui verrà creato il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID risorsa della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.
• DISPLAY_NAME: un nome visualizzato per il nuovo modello. Il nome non deve superare i 128 caratteri e deve contenere solo caratteri alfanumerici e trattini bassi.
• MODULE_TYPE: il tipo di modulo personalizzato che vuoi creare, ad esempio CONFIGURABLE_ALLOWED_COMPUTE_ENGINE_REGION.
• PATH_TO_JSON_FILE: il file JSON contenente la definizione JSON del modulo personalizzato in base al modello del modulo.

Il modulo personalizzato viene creato e avvia la scansione. Per eliminare un modulo, consulta Eliminare un modulo personalizzato.

Il nome della categoria del modulo personalizzato contiene la categoria di ricerca del tipo di modulo e il nome visualizzato del modulo che hai impostato. Ad esempio, il nome della categoria di un modulo personalizzato può essere Unexpected Compute Engine Region: example_custom_module. Nella console Google Cloud, i trattini bassi vengono visualizzati come spazi. Tuttavia, nelle query devi includere i trattini bassi.

Le quote regolano l'utilizzo dei moduli personalizzati per Event Threat Detection.

Latenza del rilevamento

La latenza del rilevamento per Event Threat Detection e tutti gli altri servizi integrati di Security Command Center sono descritti in Latenza dell'analisi.

Esamina i risultati

I risultati generati dai moduli personalizzati possono essere visualizzati nella console Google Cloud o utilizzando gcloud CLI.

Console

Per visualizzare i risultati nella console Google Cloud, segui questi passaggi:

1. Vai alla pagina Risultati di Security Command Center nella console Google Cloud.

   Vai a Risultati

2. Seleziona l'organizzazione, la cartella o il progetto.

3. Nel riquadro Filtri rapidi, scorri verso il basso fino a Nome visualizzato dell'origine e seleziona Moduli personalizzati di Event Threat Detection.

   Nota: se non vedi Event Threat Detection Custom Modules, i risultati potrebbero non essere ancora stati generati.

   Il riquadro Risultati delle query dei risultati viene compilato con i risultati per il tipo di origine selezionato.

4. Per visualizzare i dettagli di un risultato specifico nella tabella, fai clic sul nome del risultato in Categoria.

gcloud

Per utilizzare gcloud CLI per visualizzare i risultati:

1. Apri una finestra del terminale.

2. Recuperare l'ID origine per i moduli personalizzati Event Threat Detection. Il comando dipende dal fatto che tu abbia attivato Security Command Center a livello di organizzazione o di progetto:

   gcloud scc sources describe RESOURCE_LEVEL/RESOURCE_ID \
       --source-display-name='Event Threat Detection Custom Modules'
   

   Sostituisci quanto segue:

   • RESOURCE_LEVEL: il livello di attivazione della tua istanza di Security Command Center; uno tra organizations o projects.
   • RESOURCE_ID: l'ID risorsa della tua organizzazione o progetto.

   L'output è simile al seguente. SOURCE_ID è un ID assegnato dal server per le origini di sicurezza.

   canonicalName: RESOURCE_LEVEL/RESOURCE_ID/sources/SOURCE_ID
   description: Provider used by Event Threat Detection Custom Modules
   displayName: Event Threat Detection Custom Modules
   name: RESOURCE_LEVEL/RESOURCE_ID/sources/SOURCE_ID
   

3. Per elencare tutti i risultati per i moduli personalizzati di Event Threat Detection, esegui il comando seguente con l'ID origine del passaggio precedente:

   gcloud scc findings list RESOURCE_LEVEL/RESOURCE_ID --source=SOURCE_ID
   

   Sostituisci quanto segue:

   • RESOURCE_LEVEL: il livello di risorsa in cui vuoi elencare i risultati; uno tra organizations, folders o projects.
   • RESOURCE_ID: l'ID della risorsa, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.
   • SOURCE_ID: l'ID origine per i moduli personalizzati di Event Threat Detection.

4. Per elencare i risultati relativi a un modulo personalizzato specifico, esegui questo comando:

   MODULE="CUSTOM_MODULE_CATEGORY_NAME"
   FILTER="category=\"$MODULE\""
   gcloud scc findings list RESOURCE_LEVEL/RESOURCE_ID --source=SOURCE_ID --filter="$FILTER"
   

   Sostituisci quanto segue:

   • CUSTOM_MODULE_CATEGORY_NAME: nome della categoria del modulo personalizzato. Questo nome è composto dalla categoria di risultati del tipo di modulo (indicata in Moduli e modelli personalizzati) e dal nome visualizzato del modulo con trattini bassi anziché spazi. Ad esempio, il nome della categoria di un modulo personalizzato può essere Unexpected Compute Engine region: example_custom_module.
   • RESOURCE_LEVEL: il livello di risorsa in cui vuoi elencare i risultati; uno tra organizations, folders o projects.
   • RESOURCE_ID: l'ID della risorsa, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.
   • SOURCE_ID: l'ID origine dei moduli personalizzati Event Threat Detection.

Per scoprire di più sul filtro dei risultati, consulta Risultati sulla sicurezza degli elenchi.

I risultati generati dai moduli personalizzati possono essere gestiti come tutti i risultati in Security Command Center. Per ulteriori informazioni, consulta le seguenti risorse:

• Utilizzo dei contrassegni di sicurezza
• Configurazione delle notifiche sui risultati
• Esportazione dei dati di Security Command Center

Gestire i moduli personalizzati di Event Threat Detection

Questa sezione descrive come visualizzare, elencare, aggiornare ed eliminare i moduli personalizzati di Event Threat Detection.

Visualizzare o elencare moduli personalizzati

Console

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. (Facoltativo) Per visualizzare solo i moduli personalizzati, nel campo Filtro inserisci Type:Custom.

I risultati includono quanto segue:

• Tutti i moduli personalizzati di Event Threat Detection per uso residenziale.
• Tutti i moduli personalizzati Event Threat Detection ereditati. Ad esempio, se ti trovi nella visualizzazione del progetto, i moduli personalizzati creati nelle cartelle padre e nell'organizzazione del progetto sono inclusi nei risultati.
• Tutti i moduli personalizzati Event Threat Detection discendenti creati nelle risorse figlio. Ad esempio, se sei nella visualizzazione dell'organizzazione, i moduli personalizzati creati nelle cartelle e nei progetti all'interno dell'organizzazione sono inclusi nei risultati.

gcloud

gcloud alpha scc custom-modules etd list \
    --RESOURCE_FLAG=RESOURCE_ID

Sostituisci quanto segue:

• RESOURCE_FLAG: l'ambito in cui vuoi elencare i moduli personalizzati; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.

I risultati includono quanto segue:

• Tutti i moduli personalizzati di Event Threat Detection per uso residenziale.
• Tutti i moduli personalizzati Event Threat Detection ereditati. Ad esempio, quando elenchi moduli personalizzati a livello di progetto, i moduli personalizzati creati nelle cartelle padre e nell'organizzazione di quel progetto sono inclusi nei risultati.

Ogni elemento nei risultati include il nome, lo stato e le proprietà del modulo. Le proprietà sono diverse per ogni modulo.

Il nome di ogni modulo contiene il relativo ID modulo personalizzato. Molte operazioni gcloud in questa pagina richiedono l'ID modulo personalizzato.

name: RESOURCE_LEVEL/RESOURCE_ID/eventThreatDetectionSettings/customModules/CUSTOM_MODULE_ID

Disattivare un modulo personalizzato

Console

Vedi Attivare o disattivare un modulo.

Quando disabiliti un modulo personalizzato ereditato, le modifiche vengono applicate solo al livello di risorsa attuale. Il modulo personalizzato originale che si trova al livello padre non è interessato. Ad esempio, se sei a livello di progetto e disattivi un modulo personalizzato ereditato dalla cartella padre, il modulo personalizzato viene disabilitato solo a livello di progetto.

Non puoi disabilitare un modulo personalizzato discendente. Ad esempio, se ti trovi nella visualizzazione organizzazione, non puoi disabilitare un modulo personalizzato creato a livello di progetto.

gcloud

gcloud alpha scc custom-modules etd update CUSTOM_MODULE_ID \
    --RESOURCE_FLAG=RESOURCE_ID \
    --enablement-state="DISABLED"

Sostituisci quanto segue:

• CUSTOM_MODULE_ID: l'ID numerico del modulo personalizzato Event Threat Detection, ad esempio 1234567890. Puoi recuperare l'ID numerico dal campo name del modulo personalizzato pertinente quando visualizza l'elenco di moduli personalizzati.
• RESOURCE_FLAG: l'ambito della risorsa padre in cui si trova il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.

Abilita un modulo personalizzato

Console

Vedi Attivare o disattivare un modulo.

Quando abiliti un modulo personalizzato ereditato, le modifiche vengono applicate solo al livello di risorsa attuale. Il modulo personalizzato originale che si trova al livello padre non è interessato. Ad esempio, se sei a livello di progetto e abiliti un modulo personalizzato che è stato ereditato dalla cartella padre, il modulo personalizzato viene abilitato solo a livello di progetto.

Non puoi abilitare un modulo personalizzato discendente. Ad esempio, se ti trovi nella visualizzazione organizzazione, non puoi abilitare un modulo personalizzato creato a livello di progetto.

gcloud

gcloud alpha scc custom-modules etd update CUSTOM_MODULE_ID \
    --RESOURCE_FLAG=RESOURCE_ID \
    --enablement-state="ENABLED"

Sostituisci quanto segue:

• CUSTOM_MODULE_ID: l'ID numerico del modulo personalizzato Event Threat Detection, ad esempio 1234567890. Puoi ottenere l'ID numerico nel campo name del modulo personalizzato pertinente quando visualizza l'elenco di moduli personalizzati.
• RESOURCE_FLAG: l'ambito della risorsa padre in cui si trova il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.

Aggiornare la definizione di un modulo personalizzato

Questa sezione descrive come aggiornare un modulo personalizzato tramite la console Google Cloud e gcloud CLI. Ogni modulo personalizzato di Event Threat Detection ha un limite di dimensioni di 6 MB.

Non puoi aggiornare il tipo di modulo di un modulo personalizzato.

Per aggiornare un modulo personalizzato:

Console

Puoi modificare solo i moduli personalizzati residenziali. Ad esempio, se ti trovi nella visualizzazione organizzazione, puoi modificare solo i moduli personalizzati creati a livello di organizzazione.

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. Trova il modulo personalizzato che vuoi modificare.
3. Per il modulo personalizzato, fai clic su Azioni > Modifica.
4. Modifica il modulo personalizzato in base alle tue esigenze.
5. Fai clic su Salva.

gcloud

Per aggiornare un modulo, esegui il comando seguente e includi il JSON del modello di modulo aggiornato:

 gcloud alpha scc custom-modules etd update CUSTOM_MODULE_ID \
     --RESOURCE_FLAG=RESOURCE_ID \
     --enablement-state="ENABLED" \
     --custom-config-from-file=PATH_TO_JSON_FILE

Sostituisci quanto segue:

• CUSTOM_MODULE_ID: l'ID numerico del modulo personalizzato Event Threat Detection, ad esempio 1234567890. Puoi ottenere l'ID numerico nel campo name del modulo personalizzato pertinente quando visualizza l'elenco di moduli personalizzati.
• RESOURCE_FLAG: l'ambito della risorsa padre in cui si trova il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.
• PATH_TO_JSON_FILE: il file JSON contenente la definizione JSON del modulo personalizzato.

Controllare lo stato di un singolo modulo personalizzato

Console

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. Individua il modulo personalizzato nell'elenco.

Lo stato del modulo personalizzato viene visualizzato nella colonna Stato.

gcloud

 gcloud alpha scc custom-modules etd get CUSTOM_MODULE_ID \
     --RESOURCE_FLAG=RESOURCE_ID

Sostituisci quanto segue:

• CUSTOM_MODULE_ID: l'ID numerico del modulo personalizzato Event Threat Detection, ad esempio 1234567890. Puoi recuperare l'ID numerico dal campo name del modulo personalizzato pertinente quando visualizza l'elenco di moduli personalizzati.
• RESOURCE_FLAG: l'ambito della risorsa padre in cui si trova il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.

L'output è simile al seguente e include lo stato e le proprietà del modulo. Le proprietà sono diverse per ogni modulo.

config:
metadata:
  description: DESCRIPTION
  recommendation: RECOMMENDATION
  severity: SEVERITY
regions:
- region: REGION
displayName: USER_SPECIFIED_DISPLAY_NAME
enablementState: STATUS
lastEditor: LAST_EDITOR
name: RESOURCE_LEVEL/RESOURCE_ID/eventThreatDetectionSettings/customModules/CUSTOM_MODULE_ID
type: MODULE_TYPE
updateTime: 'UPDATE_TIME'

Eliminare un modulo personalizzato

Quando elimini un modulo personalizzato Event Threat Detection, i risultati generati non vengono modificati e rimangono disponibili in Security Command Center. Al contrario, quando elimini un modulo personalizzato di Security Health Analytics, i risultati generati vengono contrassegnati come inattivi.

Non puoi recuperare un modulo personalizzato eliminato.

Console

Non puoi eliminare i moduli personalizzati ereditati. Ad esempio, se sei nella visualizzazione del progetto, non puoi eliminare i moduli personalizzati creati a livello di cartella o organizzazione.

Per eliminare un modulo personalizzato tramite la console Google Cloud, segui questi passaggi:

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. Trova il modulo personalizzato che vuoi eliminare.
3. Per il modulo personalizzato, fai clic su Azioni > Elimina. Viene visualizzato un messaggio che ti chiede di confermare l'eliminazione.
4. Fai clic su Elimina.

gcloud

 gcloud alpha scc custom-modules etd delete CUSTOM_MODULE_ID \
     --RESOURCE_FLAG=RESOURCE_ID

Sostituisci quanto segue:

• CUSTOM_MODULE_ID: l'ID numerico del modulo personalizzato Event Threat Detection, ad esempio 1234567890. Puoi recuperare l'ID numerico dal campo name del modulo personalizzato pertinente quando visualizza l'elenco di moduli personalizzati.
• RESOURCE_FLAG: l'ambito della risorsa padre in cui si trova il modulo personalizzato; uno tra organization, folder o project.
• RESOURCE_ID: l'ID della risorsa padre, ovvero l'ID organizzazione, l'ID cartella o l'ID progetto.

Clona un modulo personalizzato

Quando cloni un modulo personalizzato, il modulo personalizzato risultante viene creato come residente della risorsa che stai visualizzando. Ad esempio, se cloni un modulo personalizzato che il tuo progetto ha ereditato dall'organizzazione, il nuovo modulo personalizzato sarà un modulo residenziale nel progetto.

Non puoi clonare un modulo personalizzato discendente.

Nota: non esiste alcun comando gcloud per clonare un modulo personalizzato. Per emulare il processo di clonazione, puoi eseguire un comando get per ottenere le impostazioni di un modulo personalizzato, quindi eseguire un comando create per creare un nuovo modulo con le stesse impostazioni.

Per clonare un modulo personalizzato tramite la console Google Cloud:

1. Visualizza i moduli del servizio Event Threat Detection. I moduli predefiniti e personalizzati vengono visualizzati in un elenco.
2. Trova il modulo personalizzato che vuoi clonare.
3. Per il modulo personalizzato, fai clic su Azioni > Clona.
4. Modifica il modulo personalizzato in base alle tue esigenze.
5. Fai clic su Crea.

Passaggi successivi

• Scopri di più sui moduli personalizzati per Event Threat Detection.