L'API Security Command Center vous permet de gérer de manière programmatique les marques de sécurité sur les éléments et les résultats. Les marques de sécurité sont des annotations personnalisables qui vous aident à ajouter un contexte métier à vos ressources cloud afin de simplifier le tri, le filtrage et la création de rapports.
Vous ne pouvez ajouter ou mettre à jour des marques de sécurité que sur les éléments compatibles avec Security Command Center. Pour obtenir la liste des assets compatibles, consultez Types d'assets acceptés dans Security Command Center.
Avant de commencer
Pour pouvoir utiliser des marques de sécurité, vous devez configurer un compte de service et un SDK.
Pour ajouter ou modifier des marques de sécurité, vous devez disposer d'un rôle de gestion de l'authentification et des accès incluant des autorisations pour le type de marque que vous souhaitez utiliser :
- Marques d'éléments : Rédacteur de marques de sécurité d'élément,
securitycenter.assetSecurityMarksWriter - Marques de résultats : Rédacteur de marques de sécurité de résultat,
securitycenter.findingSecurityMarksWriter
Pour en savoir plus sur les rôles IAM dans Security Command Center, consultez Contrôle des accès. Pour savoir comment utiliser efficacement les marques de sécurité, consultez Annoter des résultats avec des marques de sécurité et Annoter des éléments avec des marques de sécurité.
Ajouter ou mettre à jour des marques de sécurité sur des éléments
Lorsque vous utilisez l'API Security Command Center, l'ajout et la mise à jour de marques de sécurité sont identiques. L'exemple montre comment ajouter des marques de sécurité pour les paires clé-valeur (key_a, value_a) et (key_b, value_b).
Le code suivant utilise des masques de champ pour garantir que seules ces valeurs sont mises à jour. Si vous n'utilisez pas de masques de champ, toutes les marques de sécurité sont effacées avant d'ajouter les clés et les valeurs données.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
Remplacez les éléments suivants :
ASSET_ID: asset à mettre à jour.PARENT: niveau de la hiérarchie des ressources où se trouve l'élément. Utilisezorganization,folderouproject.PARENT_ID: ID numérique de l'organisation, du dossier ou du projet parent, ou ID alphanumérique du projet parent.LOCATION: emplacement Security Command Center dans lequel mettre à jour une marque de sécurité sur un élément. Si la résidence des données est activée, utilisezeu,saouus. Sinon, utilisez la valeurglobal.SECURITY_MARKS: paires clé/valeur séparées par une virgule qui représentent les marques de sécurité et leurs valeurs, par exemplekey_a=value_a,key_b=value_b.UPDATE_MASK: liste de champs de marque de sécurité à mettre à jour pour l'élément, séparés par une virgule (par exemple,marks.key_a,marks.key_b).
Go
Python
Consultez Gérer les règles pour en savoir plus sur les marques d'éléments dédiées aux détecteurs Security Health Analytics.
Supprimer des marques de sécurité sur des éléments
La suppression de marques de sécurité spécifiques s'effectue de la même manière pour l'ajout ou la mise à jour de ces dernières, en particulier pour appeler une mise à jour avec un masque de champ, mais sans aucune valeur correspondante. Dans l'exemple, les marques de sécurité avec les clés key_a et key_b sont supprimées.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
ASSET_ID: asset à mettre à jour.PARENT: niveau de la hiérarchie des ressources où se trouve l'élément. Utilisezorganization,folderouproject.PARENT_ID: ID numérique de l'organisation, du dossier ou du projet parent, ou ID alphanumérique du projet parent.LOCATION: emplacement Security Command Center dans lequel supprimer une marque de sécurité d'un élément. Si la résidence des données est activée, utilisezeu,saouus. Sinon, utilisez la valeurglobal.UPDATE_MASK: liste de champs de marque de sécurité à supprimer de l'élément, séparés par une virgule (par exemple,marks.key_a,marks.key_b).
Node.js
Python
Ajouter et supprimer des marques de sécurité dans la même requête
La technique pour ajouter et mettre à jour des marques de sécurité et pour supprimer des marques de sécurité peut être regroupée dans la même requête. Dans l'exemple, key_a est mis à jour et key_b est supprimé.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
ASSET_ID: asset à mettre à jour.PARENT: niveau de la hiérarchie des ressources où se trouve l'élément. Utilisezorganization,folderouproject.PARENT_ID: ID numérique de l'organisation, du dossier ou du projet parent, ou ID alphanumérique du projet parent.LOCATION: emplacement Security Command Center dans lequel mettre à jour et supprimer les marques de sécurité d'un élément. Si la résidence des données est activée, utilisezeu,saouus. Sinon, utilisez la valeurglobal.SECURITY_MARKS: paires clé/valeur séparées par une virgule qui représentent les marques de sécurité que vous souhaitez mettre à jour (par exemple,key_a=value_a) ; omettez les marques de sécurité que vous souhaitez supprimer.UPDATE_MASK: liste de champs de marque de sécurité à mettre à jour ou à supprimer, séparés par une virgule (par exemple,marks.key_a,marks.key_b).
Node.js
Python
Ajouter des marques de sécurité aux résultats
L'ajout, la mise à jour et la suppression de marques de sécurité sur des résultats suivent le même processus que la mise à jour de marques de sécurité sur des éléments. La seule différence réside dans le nom de la ressource utilisée dans l'appel d'API. Au lieu d'utiliser une ressource d'élément, vous devez fournir un nom de ressource de résultat.
Par exemple, pour mettre à jour des marques de sécurité dans un résultat, utilisez le code suivant :
gcloud
gcloud scc findings update-marks FINDING_NAME \ --PARENT=PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
Remplacez les éléments suivants :
FINDING_NAME: résultat à mettre à jour.PARENT: niveau de la hiérarchie des ressources où se trouve le résultat. Utilisezorganization,folderouproject.PARENT_ID: ID numérique de l'organisation, du dossier ou du projet parent, ou ID alphanumérique du projet parent.LOCATION: emplacement Security Command Center dans lequel mettre à jour une marque de sécurité sur un résultat. Si la résidence des données est activée, utilisezeu,saouus. Sinon, utilisez la valeurglobal.SOURCE_ID: ID de la sourceSECURITY_MARKS: paires clé/valeur séparées par une virgule qui représentent les marques de sécurité et leurs valeurs, par exemplekey_a=value_a,key_b=value_b.UPDATE_MASK: liste de champs de marque de sécurité à mettre à jour pour l'élément, séparés par une virgule (par exemple,marks.key_a,marks.key_b).
Java
Node.js
Python
Les marques de sécurité sont traitées lors des analyses par lot, qui sont exécutées deux fois par jour pour Security Command Center Premium et Enterprise, et une fois tous les deux jours pour Security Command Center Standard, et non en temps réel. Un délai de 12 à 24 heures peut s'écouler avant que les marques de sécurité ne soient traitées et que les règles d'application qui résolvent ou rouvrent les résultats ne soient appliquées.
Répertorier des éléments avec des filtres de marque de sécurité
Une fois les marques de sécurité définies dans un élément, elles peuvent être utilisées dans l'argument de filtre de l'appel d'API ListAssets. Par exemple, pour interroger tous les éléments utilisant key_a = value_a, utilisez le code suivant :
gcloud
# ORGANIZATION=12344321 FILTER="security_marks.marks.key_a = \"value_a\"" gcloud scc assets list $ORGANIZATION \ --filter="$FILTER"
Go
Java
Node.js
Python
Répertorier des résultats avec des filtres de marque de sécurité
Une fois les marques de sécurité définies dans un résultat, elles peuvent être utilisées dans l'argument de filtre de l'appel d'API ListFindings. Par exemple, pour interroger tous les éléments utilisant key_a != value_a, utilisez le code suivant :
gcloud
gcloud scc findings list PARENT/PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --filter=FILTER
PARENT: niveau de la hiérarchie des ressources où se trouve le résultat. Utilisezorganizations,foldersouprojects.PARENT_ID: ID numérique de l'organisation, du dossier ou du projet parent, ou ID alphanumérique du projet parent.LOCATION: emplacement Security Command Center dans lequel lister les résultats. Si la résidence des données est activée, utilisezeu,saouus. Sinon, utilisez la valeurglobal.SOURCE_ID: ID de la sourceFILTER: filtre à appliquer aux résultats. Par exemple, pour exclure les résultats associés à la marque de sécuritékey_a=value_a, utilisez"NOT security_marks.marks.key_a=\"value_a\"".
Go
Java
Node.js
Python
Étapes suivantes
- En savoir plus sur la création de listes de résultats et la création de listes d'éléments.