Questa pagina fornisce una panoramica dei moduli personalizzati di Security Health Analytics. Per informazioni sui moduli integrati, consulta Rilevatori integrati di Security Health Analytics.
Con i moduli personalizzati, puoi estendere le funzionalità di rilevamento di Security Health Analytics creando rilevatori personalizzati che eseguono la scansione delle risorse e delle policy che specifichi utilizzando regole che definisci per verificare la presenza di vulnerabilità, configurazioni errate o violazioni della conformità. Google Cloud
La configurazione o la definizione di un modulo personalizzato, che tu lo crei nella consoleGoogle Cloud o lo codifichi autonomamente, determina le risorse che il rilevatore controlla, le proprietà che valuta e le informazioni che restituisce quando viene rilevata una vulnerabilità o una configurazione errata.
Puoi creare moduli personalizzati per qualsiasi risorsa o asset supportato da Security Command Center.
Se codifichi autonomamente le definizioni dei moduli personalizzati, utilizzi YAML e le espressioni Common Expression Language (CEL). Se utilizzi la consoleGoogle Cloud per creare i tuoi moduli personalizzati, la maggior parte della codifica viene eseguita automaticamente, anche se devi codificare le espressioni CEL.
Per un esempio di definizione di modulo personalizzato in un file YAML, vedi Esempio di definizione di modulo personalizzato.
I moduli personalizzati vengono eseguiti insieme ai rilevatori integrati di Security Health Analytics nelle scansioni in tempo reale e batch. In modalità in tempo reale, le scansioni vengono attivate ogni volta che la configurazione di un asset cambia. Le scansioni in modalità batch vengono eseguite una volta al giorno con tutti i rilevatori per le organizzazioni o i progetti registrati.
Durante una scansione, ogni rilevatore personalizzato viene applicato a tutte le risorse corrispondenti in ogni organizzazione, cartella o progetto per cui è abilitato.
I risultati dei rilevatori personalizzati vengono scritti in Security Command Center.
Per ulteriori informazioni, consulta le seguenti risorse:
- Creare moduli personalizzati
- Tipi di scansione di Security Health Analytics
- Tipi di risorse supportati
- YAML
- Introduzione a CEL
Confronto tra rilevatori integrati e moduli personalizzati
I moduli personalizzati offrono funzionalità di rilevamento più ampie rispetto ai rilevatori integrati di Security Health Analytics. Tuttavia, i moduli personalizzati non supportano alcune funzionalità di Security Command Center fornite dai rilevatori integrati.
Funzionalità supportate
I moduli personalizzati di Security Health Analytics non sono supportati dalle simulazioni del percorso di attacco. I risultati prodotti dai moduli personalizzati non includono punteggi di esposizione agli attacchi o percorsi di attacco.
Confronto della logica di rilevamento
Per farti un'idea di cosa puoi fare con un modulo personalizzato, confronta i controlli eseguiti dal rilevatore integrato PUBLIC_SQL_INSTANCE con quelli che puoi eseguire con un modulo personalizzato.
Il rilevatore integrato PUBLIC_SQL_INSTANCE verifica se la proprietà
authorizedNetworks delle istanze Cloud SQL è impostata su 0.0.0.0/0.
In questo caso, il rilevatore genera un risultato che indica che l'istanza Cloud SQL è aperta al pubblico, perché accetta connessioni da tutti gli indirizzi IP.
Con un modulo personalizzato, puoi implementare una logica di rilevamento più complessa per controllare le istanze Cloud SQL per elementi quali:
- Indirizzi IP con prefissi specifici, utilizzando caratteri jolly.
- Il valore della proprietà
state, che puoi utilizzare per ignorare le istanze se il valore è impostato suMAINTENANCEo per attivare i risultati se il valore è diverso. - Il valore della proprietà
region, che puoi utilizzare per attivare i risultati solo per le istanze con indirizzi IP pubblici in regioni specifiche.
Ruoli e autorizzazioni IAM richiesti
I ruoli IAM determinano le azioni che puoi eseguire con i moduli personalizzati di Security Health Analytics.
La tabella seguente contiene un elenco delle autorizzazioni dei moduli personalizzati di Security Health Analytics richieste, 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 obbligatorie | Ruoli |
|---|---|
securitycentermanagement.securityHealthAnalyticsCustomModules.create |
roles/securitycentermanagement.shaCustomModulesEditor |
securitycentermanagement.securityHealthAnalyticsCustomModules.list |
roles/securitycentermanagement.shaCustomModulesViewer
|
Per saperne di più sui ruoli e sulle autorizzazioni IAM e su come concederli, consulta Concedi un ruolo IAM utilizzando la console Google Cloud .
Quote dei moduli personalizzati
I moduli personalizzati di Security Health Analytics sono soggetti a limiti di quota.
Il limite di quota predefinito per la creazione di moduli personalizzati è 100, ma puoi richiedere un aumento della quota, se necessario.
Anche le chiamate API ai metodi dei moduli personalizzati sono soggette a limiti di quota. La tabella seguente mostra i limiti di quota predefiniti per le chiamate API del modulo personalizzato.
| Tipo di chiamata API | Limite |
|---|---|
| CustomModules Read Requests (Get, List) | 1000 chiamate API al minuto per organizzazione |
| CustomModules Write Requests (Create, Update, Delete) | 60 chiamate API al minuto per organizzazione |
| CustomModules Test Requests | 12 chiamate API al minuto per organizzazione |
Per gli aumenti di quota, invia una richiesta nella console Google Cloud nella pagina Quote.
Per saperne di più sulle quote di Security Command Center, consulta Quote e limiti.
Tipi di risorse supportati
Questa sezione riepiloga i tipi di risorse Google Cloud supportati con i moduli personalizzati.
Passaggi successivi
- Per lavorare con i moduli personalizzati, consulta Utilizzo dei moduli personalizzati per Security Health Analytics.
- Per codificare autonomamente le definizioni dei moduli personalizzati, consulta Codificare moduli personalizzati per Security Health Analytics.
- Per testare i moduli personalizzati, consulta Testare i moduli personalizzati per Security Health Analytics.