Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Taggare le risorse del AWS Security Hub
Un tag è un'etichetta opzionale che è possibile definire e assegnare alle AWS risorse, inclusi alcuni tipi di risorse del AWS Security Hub. I tag possono aiutarti a identificare, classificare e gestire le risorse in diversi modi, ad esempio per scopo, proprietario, ambiente o altri criteri. Ad esempio, è possibile utilizzare i tag per distinguere le risorse, identificare le risorse che supportano determinati requisiti o flussi di lavoro di conformità o allocare i costi.
È possibile assegnare tag ai seguenti tipi di risorse del Security Hub: regole di automazione, politiche di configurazione e Hub risorsa.
Una risorsa può avere fino a 50 tag. Ogni tag è composto da una chiave di tag obbligatoria e da un valore di tag opzionale, entrambi definibili dall'utente. Una chiave di tag è un'etichetta generale che funge da categoria per un valore di tag più specifico. Un valore di tag funge da descrittore di una chiave di tag.
Ad esempio, se si creano regole di automazione diverse per ambienti diversi (un set di regole di automazione per gli account di test e un altro per gli account di produzione), è possibile assegnare una chiave di Environment tag a tali regole. Il valore del tag associato potrebbe Test riferirsi alle regole associate agli account di test e alle regole associate Prod agli account di produzione e alle unità organizzative.
Quando definisci e assegni i tag alle risorse del AWS Security Hub, tieni presente quanto segue:
-
Ogni risorsa può avere un massimo di 50 tag.
-
Per ogni risorsa, ogni chiave di tag deve essere unica e può avere un solo valore di tag.
-
I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole. Come best practice, ti consigliamo di definire una strategia per utilizzare i tag in maiuscolo e di implementarla in modo coerente tra le tue risorse.
-
Una chiave tag può contenere un massimo di 128 caratteri UTF-8. Il valore di un tag può contenere un massimo di 256 caratteri UTF-8. I caratteri possono essere lettere, numeri, spazi o i seguenti simboli: _.:/= + - @
-
Il aws: prefisso è riservato all'uso diAWS. Non puoi usarlo in nessuna chiave o valore di tag che definisci. Inoltre, non è possibile modificare o rimuovere le chiavi o i valori dei tag che utilizzano questo prefisso. I tag che utilizzano questo prefisso non vengono conteggiati per la quota di 50 tag per ogni risorsa.
-
Tutti i tag che assegni sono disponibili solo per te Account AWS e solo nel gruppo Regione AWS in cui li assegni.
-
Se si assegnano tag a una risorsa utilizzando Security Hub, i tag vengono applicati solo alla risorsa archiviata direttamente in Security Hub nel paese applicabileRegione AWS. Non vengono applicati alle risorse di supporto associate che Security Hub crea, utilizza o gestisce per te in altriServizi AWS. Ad esempio, se assegni tag a una regola di automazione che aggiorna i risultati relativi ad Amazon Simple Storage Service (Amazon S3), i tag vengono applicati solo alla regola di automazione in Security Hub per la regione specificata. Non vengono applicati ai tuoi bucket S3. Per assegnare tag anche a una risorsa associata, puoi utilizzare AWS Resource Groups o Servizio AWS quello che memorizza la risorsa, ad esempio Amazon S3 per un bucket S3. L'assegnazione di tag alle risorse associate può aiutarti a identificare le risorse di supporto per le risorse del Security Hub.
-
Se si elimina una risorsa, vengono eliminati anche tutti i tag assegnati alla risorsa.
Non archiviate dati riservati o di altro tipo nei tag. I tag sono accessibili da moltiServizi AWS, tra cuiAWS Billing and Cost Management. Non sono destinati a essere utilizzati per dati sensibili.
Per aggiungere e gestire i tag per le risorse di Security Hub, puoi utilizzare la console Security Hub, l'API Security Hub o l'API AWS Resource Groups Tagging. Con Security Hub, puoi aggiungere tag a una risorsa quando la crei. È inoltre possibile aggiungere e gestire tag per singole risorse esistenti. Con Resource Groups, puoi aggiungere e gestire tag in blocco per più risorse esistenti che coprono più areeServizi AWS, incluso Security Hub.
Per ulteriori suggerimenti e best practice sull'etichettatura, consulta Tagging your AWS resources nella Tagging Resources User Guide. AWS
Dopo aver iniziato a taggare le risorse, puoi definire autorizzazioni a livello di risorsa basate su tag nelle policy (IAM). AWS Identity and Access Management Utilizzando i tag in questo modo, puoi implementare un controllo granulare su quali utenti e ruoli all'interno dell'azienda Account AWS sono autorizzati a creare e contrassegnare risorse e quali utenti e ruoli sono autorizzati ad aggiungere, modificare e rimuovere tag più in generale. Per controllare l'accesso in base ai tag, puoi utilizzare le chiavi di condizione relative ai tag nell'elemento Condition delle politiche IAM.
Ad esempio, puoi creare una policy IAM che consenta a un utente di avere accesso completo a tutte le risorse del AWS Security Hub, se il Owner tag della risorsa specifica il suo nome utente:
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ModifyResourceIfOwner",
"Effect": "Allow",
"Action": "securityhub:*",
"Resource": "*",
"Condition": {
"StringEqualsIgnoreCase": {"aws:ResourceTag/Owner": "${aws:username}"}
}
}
]
}
Se vengono definite autorizzazioni a livello di risorsa basate su tag, le autorizzazioni diventano subito effettive. Ciò significa che le risorse sono più sicure non appena vengono create e che è possibile avviare rapidamente l'applicazione di tag alle nuove risorse. È inoltre possibile utilizzare le autorizzazioni a livello di risorsa per controllare quali chiavi e valori di tag possono essere associati a risorse nuove ed esistenti. Per ulteriori informazioni, consulta Controllo dell'accesso alle risorse AWS mediante i tag delle risorse nella Guida per l'utente di IAM.
Per aggiungere tag a una singola risorsa AWS Security Hub, puoi utilizzare la console Security Hub o l'API Security Hub. La console non supporta l'aggiunta di tag alla Hub risorsa.
Per aggiungere tag a più risorse Security Hub contemporaneamente, utilizza le operazioni di tagging dell'API AWS Resource GroupsTagging.
L'aggiunta di tag a una risorsa può influire sull'accesso alla risorsa. Prima di aggiungere un tag a una risorsa, esamina le politiche AWS Identity and Access Management (IAM) che potrebbero utilizzare i tag per controllare l'accesso alle risorse.
- Console
-
Per aggiungere un tag a una risorsa
Quando si crea una regola di automazione o una politica di configurazione, la console Security Hub offre opzioni per aggiungere tag. È possibile fornire la chiave e il valore del tag nella sezione Tag.
- Security Hub API & AWS CLI
-
Per aggiungere un tag a una risorsa
Per creare una risorsa e aggiungervi uno o più tag a livello di codice, utilizzate l'operazione appropriata per il tipo di risorsa che desiderate creare:
Nella richiesta, utilizzate il tags parametro per specificare la chiave del tag e il valore del tag opzionale per ogni tag da aggiungere alla risorsa. Il tags parametro specifica una matrice di oggetti. Ogni oggetto specifica una chiave di tag e il relativo valore di tag associato.
Per aggiungere uno o più tag a una risorsa esistente, utilizza l'TagResourceoperazione dell'API Security Hub o, se utilizzi ilAWS CLI, esegui il comando tag-resource. Nella richiesta, specifica l'Amazon Resource Name (ARN) della risorsa a cui desideri aggiungere un tag. Utilizza il tags parametro per specificare la chiave del tag (key) e il valore del tag opzionale (value) per ogni tag da aggiungere. Il tags parametro specifica una matrice di oggetti, un oggetto per ogni chiave di tag e il valore del tag associato.
Ad esempio, il AWS CLI comando seguente aggiunge una chiave di Environment tag con un valore di Prod tag alla politica di configurazione specificata. Questo esempio è formattato per Linux, macOS o Unix e utilizza il carattere di continuazione di riga rovesciata (\) per migliorare la leggibilità.
Esempio di comando CLI:
$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags key=Environment,value=Prod
Dove:
-
resource-arnspecifica l'ARN della politica di configurazione a cui aggiungere un tag.
-
Environment
-
ProdEnvironment
Nell'esempio seguente, il comando aggiunge diversi tag alla politica di configurazione.
$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags key=Environment,value=Prod key=CostCenter,value=12345 key=Owner,value=jane-doe
Per ogni oggetto di una tags matrice, sono obbligatori key sia gli value argomenti che. Tuttavia, il valore dell'valueargomento può essere una stringa vuota. Se non desiderate associare un valore di tag a una chiave di tag, non specificate un valore per l'valueargomento. Ad esempio, il comando seguente aggiunge una chiave di Owner tag senza alcun valore di tag associato:
$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags key=Owner,value=
Se un'operazione di tagging ha esito positivo, Security Hub restituisce una risposta HTTP 200 vuota. Altrimenti, Security Hub restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.
È possibile esaminare i tag (sia chiavi che valori dei tag) per una regola di automazione o una politica di configurazione di Security Hub utilizzando la console Security Hub o l'API Security Hub. La console non supporta la revisione dei tag per la Hub risorsa.
Per esaminare i tag per più risorse Security Hub contemporaneamente, utilizza le operazioni di tagging dell'API AWS Resource GroupsTagging.
- Console
-
Per esaminare i tag di una risorsa
Utilizzando le credenziali dell'amministratore del Security Hub, aprire la console AWS Security Hub all'indirizzo https://console.aws.amazon.com/securityhub/.
-
A seconda del tipo di risorsa a cui vuoi aggiungere un tag, esegui una delle seguenti operazioni:
Per esaminare i tag per una regola di automazione, scegli Automazioni nel riquadro di navigazione. Quindi, scegli una regola di automazione.
Per esaminare i tag relativi a una politica di configurazione, scegli Configurazione nel riquadro di navigazione. Quindi, nella scheda Politiche, seleziona l'opzione accanto a una politica di configurazione. Si apre un pannello laterale che mostra il numero di tag assegnati alla politica. Puoi espandere l'intestazione Tags per visualizzare le chiavi e i valori dei tag.
La sezione Tag elenca tutti i tag attualmente assegnati alla risorsa.
- Security Hub API & AWS CLI
-
Per rivedere i tag di una risorsa
Per recuperare e rivedere i tag di una risorsa esistente, richiama l'ListTagsForResourceAPI. Nella tua richiesta, utilizza il resourceArn parametro per specificare l'Amazon Resource Name (ARN) della risorsa.
Se si utilizza ilAWS CLI, eseguire il list-tags-for-resourcecomando e utilizzare il resource-arn parametro per specificare l'ARN della risorsa. Per esempio:
$ aws securityhub list-tags-for-resource --resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
Se l'operazione ha esito positivo, Security Hub restituisce un tags array. Ogni oggetto dell'array specifica un tag (sia la chiave del tag che il valore del tag) attualmente assegnato alla risorsa. Per esempio:
{
"tags": [
{
"key": "Environment",
"value": "Prod"
},
{
"key": "CostCenter",
"value": "12345"
},
{
"key": "Owner",
"value": ""
}
]
}
Dove Environment e CostCenter Owner sono le chiavi dei tag assegnate alla risorsa. Prodè il valore del tag associato alla chiave del Environment tag. 12345è il valore del tag associato alla chiave del CostCenter tag. La chiave Owner tag non ha un valore di tag associato.
Per recuperare un elenco di tutte le risorse del Security Hub che dispongono di tag e di tutti i tag assegnati a ciascuna di tali risorse, utilizza il GetResourcesfunzionamento dell'API AWS Resource Groups Tagging. Nella richiesta, imposta il valore del ResourceTypeFilters parametro su. securityhub A tale scopoAWS CLI, eseguite il comando get-resources e impostate il valore del resource-type-filters parametro su. securityhub Per esempio:
$ aws resourcegroupstaggingapi get-resources -\-resource-type-filters "securityhub"
Se l'operazione ha esito positivo, Resource Groups restituisce un ResourceTagMappingList array. L'array contiene un oggetto per ogni risorsa Security Hub con tag. Ogni oggetto specifica l'ARN di una risorsa Security Hub e le chiavi e i valori dei tag assegnati alla risorsa.
Per modificare i tag (chiavi o valori dei tag) per una risorsa AWS Security Hub, puoi utilizzare l'API Security Hub. La console Security Hub attualmente non supporta la modifica dei tag.
Per modificare i tag per più risorse Security Hub contemporaneamente, utilizza le operazioni di tagging dell'API AWS Resource GroupsTagging.
La modifica dei tag per una risorsa può influire sull'accesso alla risorsa. Prima di modificare la chiave o il valore di un tag per una risorsa, esamina le politiche AWS Identity and Access Management (IAM) che potrebbero utilizzare il tag per controllare l'accesso alle risorse.
- Security Hub API & AWS CLI
-
Per modificare i tag di una risorsa
Quando modificate un tag per una risorsa a livello di codice, sovrascrivete il tag esistente con nuovi valori. Pertanto, il modo migliore per modificare un tag dipende dal fatto che si desideri modificare una chiave di tag, un valore di tag o entrambi. Per modificare una chiave di tag, rimuovi il tag corrente e aggiungi un nuovo tag.
Per modificare o rimuovere solo il valore del tag associato a una chiave di tag, sovrascrivi il valore esistente utilizzando il TagResourcefunzionamento dell'API Security Hub. Se utilizzi ilAWS CLI, esegui il comando tag-resource. Nella richiesta, specifica l'Amazon Resource Name (ARN) della risorsa di cui desideri modificare o rimuovere il valore del tag.
Per modificare il valore di un tag, utilizza il tags parametro per specificare la chiave del tag di cui desideri modificare il valore del tag. È inoltre necessario specificare il nuovo valore del tag per la chiave. Ad esempio, il AWS CLI comando seguente modifica il valore del tag da Prod a Test per la chiave di Environment tag assegnata alla regola di automazione specificata. Questo esempio è formattato per Linux, macOS o Unix e utilizza il carattere di continuazione di riga rovesciata (\) per migliorare la leggibilità.
$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags key=Environment,value=Test
Dove:
-
resource-arnspecifica l'ARN della politica di configurazione.
-
Environment
-
TestEnvironment
Per rimuovere un valore di tag da una chiave di tag, non specificate un valore per l'valueargomento della chiave nel tags parametro. Per esempio:
$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags key=Owner,value=
Se l'operazione ha esito positivo, Security Hub restituisce una risposta HTTP 200 vuota. Altrimenti, Security Hub restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.
Per rimuovere i tag da una risorsa AWS Security Hub, puoi utilizzare l'API Security Hub. La console Security Hub attualmente non supporta la rimozione dei tag.
Per rimuovere i tag da più risorse Security Hub contemporaneamente, utilizza le operazioni di tagging dell'API AWS Resource GroupsTagging.
La rimozione dei tag da una risorsa può influire sull'accesso alla risorsa. Prima di rimuovere un tag, esamina le politiche AWS Identity and Access Management (IAM) che potrebbero utilizzare il tag per controllare l'accesso alle risorse.
- Security Hub API & AWS CLI
-
Per rimuovere i tag da una risorsa
Per rimuovere uno o più tag da una risorsa a livello di codice, utilizza il UntagResourcefunzionamento dell'API Security Hub. Nella tua richiesta, utilizza il resourceArn parametro per specificare l'Amazon Resource Name (ARN) della risorsa da cui rimuovere un tag. Usa il tagKeys parametro per specificare la chiave del tag da rimuovere. Per rimuovere più tag, aggiungete il tagKeys parametro e l'argomento per ogni tag da rimuovere, separati da una e commerciale (&), ad esempio. tagKeys=key1&tagKeys=key2 Per rimuovere solo un valore di tag specifico (non una chiave di tag) da una risorsa, modifica il tag anziché rimuovere il tag.
Se utilizzi ilAWS CLI, esegui il comando untag-resource per rimuovere uno o più tag da una risorsa. Per il resource-arn parametro, specificate l'ARN della risorsa da cui rimuovere un tag. Utilizzate il tag-keys parametro per specificare la chiave del tag da rimuovere. Ad esempio, il comando seguente rimuove il Environment tag (sia la chiave del tag che il valore del tag) dalla politica di configurazione specificata:
$ aws securityhub untag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tag-keys Environment
Dove resource-arn specifica l'ARN della politica di configurazione da cui rimuovere un tag Environment
Per rimuovere più tag da una risorsa, aggiungi ogni chiave di tag aggiuntiva come argomento per il tag-keys parametro. Per esempio:
$ aws securityhub untag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tag-keys Environment Owner
Se l'operazione ha esito positivo, Security Hub restituisce una risposta HTTP 200 vuota. Altrimenti, Security Hub restituisce una risposta HTTP 4 xx o 500 che indica il motivo per cui l'operazione non è riuscita.
