Sintassi ed esempi delle policy di Security Hub
Le policy di Security Hub seguono una sintassi JSON standardizzata che definisce il modo in cui Security Hub è abilitato e configurato all’interno dell’organizzazione. Comprendere la struttura delle policy ti aiuta a creare policy efficaci per i tuoi requisiti di sicurezza.
Considerazioni
Prima di creare le policy di Security Hub, comprendi questi punti chiave sulla sintassi delle policy:
-
Entrambi gli elenchi
enable_in_regionsedisable_in_regionssono obbligatori nella policy, sebbene possano essere vuoti. -
Nell’elaborazione di policy efficaci,
disable_in_regionsha la precedenza suenable_in_regions. -
Le policy secondarie possono modificare quelle principali utilizzando operatori di ereditarietà a meno che non siano esplicitamente limitate.
-
La designazione
ALL_SUPPORTEDinclude le regioni attuali e future. -
I nomi delle regioni devono essere validi e disponibili in Security Hub.
-
La mappa
featuresè facoltativa ed è disponibile solo nelle Regioni AWS commerciali (regioni diverse da AWS GovCloud (US) Regions e le regioni della Cina). Non è disponibile nelle AWS GovCloud (US) Regions o nelle regioni della Cina. -
Entrambi gli elenchi
enable_in_regionsedisable_in_regionsall’interno di una funzionalità sono obbligatori, sebbene possano essere vuoti. -
Quando si elaborano policy efficaci,
disable_in_regionsha la precedenza suenable_in_regionsper una funzionalità, come per gli elenchi di primo livello. -
Una funzionalità è configurata solo nelle regioni in cui Security Hub è abilitato dalla stessa policy efficace. La disabilitazione di Security Hub in una regione ne disabilita anche le funzionalità in tale regione.
-
Le aree che non compaiono nell’elenco
enable_in_regionsné nell’elencodisable_in_regionsdi una funzionalità non vengono gestite dalla policy. -
Quando la mappa
features, o una funzionalità al suo interno, viene omessa, tale funzionalità non viene gestita dalla policy.
Struttura della policy di base
Una policy di Security Hub utilizza questa struttura di base:
{ "securityhub": { "enable_in_regions": { "@@append": ["ALL_SUPPORTED"], "@@operators_allowed_for_child_policies": ["@@all"] }, "disable_in_regions": { "@@append": [], "@@operators_allowed_for_child_policies": ["@@all"] } } }
Una policy di Security Hub può anche includere una mappa features facoltativa per gestire le funzionalità di adesione di Security Hub, come la scansione della rete, in tutta l’organizzazione. La mappa features è disponibile solo nelle Regioni AWS commerciali.
{ "securityhub": { "enable_in_regions": { "@@assign": ["ALL_SUPPORTED"], "@@operators_allowed_for_child_policies": ["@@all"] }, "disable_in_regions": { "@@assign": [], "@@operators_allowed_for_child_policies": ["@@all"] }, "features": { "network_scanning": { "enable_in_regions": { "@@assign": ["us-east-1", "us-west-2"], "@@operators_allowed_for_child_policies": ["@@all"] }, "disable_in_regions": { "@@assign": [], "@@operators_allowed_for_child_policies": ["@@all"] } } } } }
Componenti della policy
Le policy di Security Hub contengono questi componenti chiave:
securityhub-
Il container di primo livello per le impostazioni delle policy.
Obbligatorio per tutte le policy di Security Hub.
enable_in_regions-
Elenco delle regioni in cui Security Hub deve essere abilitato.
Può contenere nomi di regioni specifici o
ALL_SUPPORTED.Campo obbligatorio ma può essere vuoto.
Quando utilizzi
ALL_SUPPORTED, include le regioni future. disable_in_regions-
Elenco delle regioni in cui Security Hub deve essere disabilitato.
Può contenere nomi di regioni specifici o
ALL_SUPPORTED.Campo obbligatorio ma può essere vuoto.
Ha la precedenza su
enable_in_regionsquando le regioni vengono visualizzate in entrambi gli elenchi. - Operatori di ereditarietà
-
@@assign: sovrascrive i valori ereditati.
@@append: aggiunge nuovi valori a quelli esistenti.
@@remove: rimuove valori specifici dalle impostazioni ereditate.
features-
Il container per le impostazioni per l’adesione della funzionalità di Security Hub.
Facoltativo e disponibile solo nelle Regioni AWS commerciali.
Se omesse, tutte le funzionalità non vengono gestite dalla policy.
Ogni funzionalità è configurata dal proprio blocco secondario, ad esempio
network_scanning. network_scanning-
Controlla la funzionalità di scansione della rete all’interno della mappa
features.Facoltativo. Se omessa, la scansione della rete non viene gestita dalla policy.
Contiene i propri elenchi
enable_in_regionsedisable_in_regions. enable_in_regions(all’interno dinetwork_scanning)-
Elenco delle regioni in cui deve essere abilitata la scansione della rete.
Può contenere nomi di regioni specifici o
ALL_SUPPORTED.Campo obbligatorio ma può essere vuoto.
Quando viene utilizzato
ALL_SUPPORTED, include tutte le regioni in cui Security Hub è abilitato da questa policy.La scansione della rete è abilitata solo nelle regioni in cui Security Hub è abilitato anche da questa policy.
disable_in_regions(all’interno dinetwork_scanning)-
Elenco delle regioni in cui deve essere disabilitata la scansione della rete.
Può contenere nomi di regioni specifici o
ALL_SUPPORTED.Campo obbligatorio ma può essere vuoto.
Ha la precedenza su
enable_in_regionsquando le regioni vengono visualizzate in entrambi gli elenchi.
Esempi di policy di Security Hub
Gli esempi seguenti illustrano le configurazioni comuni delle policy di Security Hub.
L’esempio seguente abilita Security Hub in tutte le regioni attuali e future. Utilizzando ALL_SUPPORTED nell’elenco enable_in_regions e lasciando disable_in_regions vuoto, questa policy garantisce una copertura di sicurezza completa non appena saranno disponibili nuove regioni.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] }, "disable_in_regions":{ "@@assign":[ ] } } }
Questo esempio disabilita Security Hub in tutte le regioni, comprese le regioni future, poiché l’elenco disable_in_regions ha la precedenza su enable_in_regions.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2" ] }, "disable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] } } }
L’esempio seguente dimostra come le policy secondarie possono modificare le impostazioni delle policy principali utilizzando operatori di ereditarietà. Questo approccio consente un controllo granulare mantenendo al contempo la struttura generale delle policy. La policy secondaria aggiunge una nuova regione a enable_in_regions e rimuove una regione da disable_in_regions.
{ "securityhub":{ "enable_in_regions":{ "@@append":[ "eu-central-1" ] }, "disable_in_regions":{ "@@remove":[ "us-west-2" ] } } }
Questo esempio mostra come abilitare Security Hub in più regioni specifiche senza utilizzare ALL_SUPPORTED. Ciò fornisce un controllo preciso su quali regioni hanno il Security Hub abilitato, lasciando le regioni non specificate non gestite dalla policy.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2", "eu-west-1", "ap-southeast-1" ] }, "disable_in_regions":{ "@@assign":[ ] } } }
L’esempio seguente dimostra come gestire i requisiti di conformità regionali abilitando Security Hub nella maggior parte delle regioni e disabilitandolo esplicitamente in località specifiche. L’elenco disable_in_regions ha la precedenza, garantendo che Security Hub rimanga disabilitato in tali regioni indipendentemente dalle altre impostazioni delle policy.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] }, "disable_in_regions":{ "@@assign":[ "ap-east-1", "me-south-1" ] } } }
L’esempio seguente abilita Security Hub e la scansione della rete nelle stesse due regioni. La mappa features è disponibile solo nelle Regioni AWS commerciali.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2" ] }, "disable_in_regions":{ "@@assign":[ ] }, "features":{ "network_scanning":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2" ] }, "disable_in_regions":{ "@@assign":[ ] } } } } }
Questo esempio abilita Security Hub in tre regioni, ma la scansione della rete solo in due di esse. In eu-west-1, Security Hub è abilitato mentre la scansione della rete non è gestita dalla policy perché la regione non è inclusa nell’elenco delle funzionalità.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2", "eu-west-1" ] }, "disable_in_regions":{ "@@assign":[ ] }, "features":{ "network_scanning":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2" ] }, "disable_in_regions":{ "@@assign":[ ] } } } } }
L’esempio seguente abilita la scansione della rete in us-east-1 e la disabilita in us-west-2. Poiché disable_in_regions ha la precedenza, la scansione della rete rimane disabilitata in us-west-2 anche quando una regione appare in entrambi gli elenchi.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "us-east-1", "us-west-2" ] }, "disable_in_regions":{ "@@assign":[ ] }, "features":{ "network_scanning":{ "enable_in_regions":{ "@@assign":[ "us-east-1" ] }, "disable_in_regions":{ "@@assign":[ "us-west-2" ] } } } } }
Questo esempio mantiene Security Hub abilitato in tutte le regioni attuali e future mentre disabilita la scansione della rete in tutte, poiché l’elenco disable_in_regions ha la precedenza.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] }, "disable_in_regions":{ "@@assign":[ ] }, "features":{ "network_scanning":{ "enable_in_regions":{ "@@assign":[ ] }, "disable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] } } } } }
Questo esempio abilita Security Hub in tutte le regioni attuali e future e lascia la scansione della rete non gestita dalla policy utilizzando elenchi di funzionalità vuoti. Ciò ha lo stesso effetto dell’omissione della mappa features.
{ "securityhub":{ "enable_in_regions":{ "@@assign":[ "ALL_SUPPORTED" ] }, "disable_in_regions":{ "@@assign":[ ] }, "features":{ "network_scanning":{ "enable_in_regions":{ "@@assign":[ ] }, "disable_in_regions":{ "@@assign":[ ] } } } } }
L’esempio seguente dimostra come una policy secondaria può estendere le regioni di scansione della rete di una policy principale utilizzando operatori di ereditarietà. La policy secondaria aggiunge una regione all’elenco enable_in_regions ereditato con @@append, nello stesso modo in cui l’ereditarietà funziona negli elenchi di regioni di primo livello.
{ "securityhub":{ "features":{ "network_scanning":{ "enable_in_regions":{ "@@append":[ "us-west-2" ] } } } } }