Modification des balises pour les ressources CSPM du Security Hub - AWSSecurity Hub

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modification des balises pour les ressources CSPM du Security Hub

À mesure que votre environnement ou vos exigences évoluent au fil du temps, vous pouvez évaluer les balises existantes pour vos ressources AWS Security Hub CSPM et modifier les balises si nécessaire. Une étiquette est une étiquette que vous définissez et attribuez à une ou plusieurs AWS ressources, y compris certains types de ressources Macie. Chaque balise comprend une clé de balise obligatoire et une valeur de balise facultative. Une clé de balise est une étiquette générale qui fait office de catégorie pour une valeur de balise plus spécifique. Une valeur de balise tient lieu de descripteur pour une clé de balise.

Les balises peuvent vous aider à identifier, à classer et à gérer les ressources de différentes manières, par exemple en fonction de leur objectif, de leur propriétaire, de leur environnement ou d'autres critères. Par exemple, vous pouvez utiliser des balises pour : appliquer des politiques, répartir les coûts, distinguer les versions des ressources ou identifier les ressources qui répondent à certaines exigences de conformité ou à certains flux de travail.

Vous pouvez ajouter des balises aux types de ressources CSPM du Security Hub suivants :

  • Règles d’automatisation

  • Politiques de configuration

  • Hub ressource

Pour modifier les clés ou les valeurs de balise d'une ressource Security Hub CSPM, vous pouvez utiliser l'API Security Hub CSPM. La console Security Hub CSPM ne prend actuellement pas en charge la modification des balises.

Important

La modification des balises d'une ressource peut affecter l'accès à cette ressource. Avant de modifier une balise pour une ressource, passez en revue les politiques Gestion des identités et des accès AWS (IAM) susceptibles d'utiliser des balises pour contrôler l'accès aux ressources.

Security Hub CSPM API

Pour modifier les balises d'une ressource CSPM (API) du Security Hub

Lorsque vous modifiez une balise pour une ressource par programmation, vous remplacez la balise existante par de nouvelles valeurs. Par conséquent, la meilleure façon de modifier une balise dépend de la modification d'une clé de balise, d'une valeur de balise ou des deux. Pour modifier une clé de balise, supprimez la balise actuelle et ajoutez-en une nouvelle.

Pour modifier ou supprimer uniquement la valeur de balise associée à une clé de balise, remplacez la valeur existante à l'aide de l'TagResourceAPI Security Hub CSPM. Si vous utilisez leAWS CLI, exécutez la commande tag-resource. Dans votre demande, spécifiez le Amazon Resource Name (ARN) de la ressource dont vous souhaitez modifier ou supprimer la valeur de balise.

Pour modifier la valeur d'une balise, utilisez le tags paramètre pour spécifier la clé de balise dont vous souhaitez modifier la valeur de balise. Vous devez également spécifier la nouvelle valeur de balise pour la clé. Par exemple, la AWS CLI commande suivante modifie la valeur de balise de Prod à Test pour la clé de Environment balise affectée à la règle d'automatisation spécifiée. Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\) pour améliorer la lisibilité.

$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags '{"Environment":"Test"}'

Où :

  • resource-arnspécifie l'ARN de la politique de configuration.

  • Environmentest la clé de balise associée à la valeur de balise à modifier.

  • Testest la nouvelle valeur de balise pour la clé de balise spécifiée (Environment).

Pour supprimer une valeur de balise d'une clé de balise, ne spécifiez pas de valeur pour l'valueargument de la clé dans le tags paramètre. Par exemple :

$ aws securityhub tag-resource \
--resource-arn arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--tags '{"Owner":""}'

Si l'opération réussit, Security Hub CSPM renvoie une réponse HTTP 200 vide. Sinon, Security Hub CSPM renvoie une réponse HTTP 4 xx ou 500 indiquant pourquoi l'opération a échoué.