Cette page a été traduite par l'API Cloud Translation.

Migrer vers la version 2 de l'API Security Command Center

Cette page explique les différences entre la version 1 (v1) et la version 2 (v2) de l'API Security Command Center. Il explique également comment migrer vers l'API Security Command Center v2, en combinaison avec l'API Security Command Center Management v1.

À partir du 9 décembre 2024, si vous activez Security Command Center pour la première fois dans une organisation, vous devrez utiliser uniquement la version 2 de l'API Security Command Center dans cette organisation. Les versions antérieures ne sont pas compatibles.

Si vous avez activé Security Command Center au niveau du projet avant le 9 décembre 2024, tous les projets que vous activez dans la même organisation seront compatibles avec toutes les versions disponibles de l'API Security Command Center.

Pour toutes les intégrations avec Security Command Center, nous vous recommandons d'adopter l'API Security Command Center v2 et l'API Security Command Center Management v1. Nous vous recommandons d'utiliser les bibliothèques clientes Cloud ou le fournisseur Terraform pour appeler ces API. Google Cloud Pour en savoir plus, consultez les ressources suivantes :

Terraform

Bibliothèques clientes

Différences entre les API v1 et v2

Lorsque vous migrez vers l'API Security Command Center v2, tenez compte des différences suivantes par rapport à l'API v1.

Résidence des données

L'API Security Command Center v2 est compatible avec la résidence des données, ce qui vous permet de mieux contrôler l'emplacement de vos données Security Command Center.

Si la résidence des données est activée pour votre organisation, vous devez effectuer les opérations suivantes pour accéder aux ressources soumises aux contrôles de résidence des données :

Utilisez un point de terminaison de service régional pour accéder à la ressource.
Spécifiez un emplacement lorsque vous appelez les méthodes de la ressource.

Si la résidence des données n'est pas activée pour votre organisation, nous vous recommandons d'appeler la version tenant compte de l'emplacement de chaque méthode et de spécifier l'emplacement global. Cela facilitera l'adoption de la résidence des données à l'avenir.

Pour utiliser la version géolocalisée de chaque méthode, procédez comme suit :

Console

La console Google Cloud utilise la version géolocalisée de chaque méthode chaque fois que cela est nécessaire.

gcloud

Lorsque vous exécutez des commandes gcloud CLI qui vous permettent de spécifier un emplacement, comme gcloud scc findings list, fournissez toujours un emplacement. Pour ce faire, vous disposez de différentes méthodes :

Utilisez l'option --location.
Si vous fournissez le chemin d'accès complet du nom de la ressource, utilisez un format qui spécifie un emplacement, comme projects/123/sources/456/locations/global/findings/a1b2c3.

Terraform

Fournissez toujours l'argument location pour les ressources qui le prennent en charge, comme google_scc_v2_organization_mute_config.

REST

Appelez la version de la méthode dont le nom contient locations. Par exemple, appelez organizations.locations.findings.bulkMute plutôt que organizations.findings.bulkMute.

Bibliothèques clientes

Consultez les exemples de code pour Security Command Center ou la documentation de référence de l'API pour votre bibliothèque cliente.

Pour savoir comment utiliser les points de terminaison régionaux lorsque la résidence des données est activée, consultez Points de terminaison régionaux Security Command Center.

Configurations de notifications et configurations BigQuery Export

L'API Security Command Center v1 vous permet de créer et de gérer les types de configurations d'exportation suivants :

Configurations de notification, qui envoient les résultats à Pub/Sub
Configurations d'exportation BigQuery, qui diffusent les résultats vers BigQuery

Vous pouvez également créer et gérer ces configurations d'exportation avec l'API Security Command Center v2. Toutefois, si vous créez une configuration d'exportation avec l'API Security Command Center v1, elle n'est pas visible dans l'API Security Command Center v2. De même, si vous créez une configuration d'exportation avec l'API Security Command Center v2, elle n'est pas visible dans l'API Security Command Center v1.

De plus, les configurations d'exportation que vous créez avec l'API Security Command Center v2 ne peuvent pas utiliser le champ source_properties pour filtrer les résultats. Vous devez utiliser un autre champ.

Console

Dans la console Google Cloud , si une configuration d'exportation a été créée avec l'API Security Command Center v1, elle comporte le libellé Ancienne. Vous pouvez utiliser la consoleGoogle Cloud pour gérer ces ressources.

Si vous créez une configuration d'exportation dans la console Google Cloud , elle est toujours créée avec l'API Security Command Center v2.

gcloud

Pour gérer les configurations d'exportation créées avec l'API Security Command Center v1, ne spécifiez pas de lieu lorsque vous exécutez des commandes gcloud CLI telles que gcloud scc notifications describe :

N'utilisez pas l'option --location.
Si vous fournissez le chemin d'accès complet de l'ID de configuration, utilisez un format qui ne spécifie pas d'emplacement, comme organizations/123/notificationConfigs/456. N'utilisez pas un format tel que organizations/123/locations/global/notificationConfigs/456.

De même, pour créer ou gérer des configurations d'exportation avec l'API Security Command Center v2, spécifiez un emplacement lorsque vous exécutez la commande gcloud CLI. Lorsque vous créez des configurations, nous vous recommandons d'utiliser l'API Security Command Center v2.

Terraform

Votre fichier de configuration Terraform définit les configurations d'exportation en tant que ressources v1 ou v2. Par exemple, consultez les ressources sur les configurations de notification :

Lorsque vous créez des configurations, nous vous recommandons de créer des ressources v2.

REST

Pour gérer les configurations d'exportation créées avec l'API Security Command Center v1, vous devez utiliser l'API Security Command Center v1.

Lorsque vous créez des configurations, nous vous recommandons d'utiliser l'API Security Command Center v2.

Bibliothèques clientes

Pour gérer les configurations d'exportation créées avec l'API Security Command Center v1, vous devez utiliser les bibliothèques clientes Cloud pour l'API Security Command Center v1.

Lorsque vous créez des configurations, nous vous recommandons d'utiliser l'API Security Command Center v2.

Services intégrés et modules personnalisés

L'API Security Command Center v1 vous permet d'afficher et de mettre à jour les types de ressources suivants :

Les services intégrés de Security Command Center et leurs états d'activation
Modules personnalisés pour les services intégrés suivants :
- Event Threat Detection
- Analyse de l'état de la sécurité

Pour gérer ces types de ressources, utilisez l'API Security Command Center Management et ses bibliothèques clientes. L'API Security Command Center v2 ne peut pas gérer ces types de ressources.

Gestion des composants

Si votre organisation a activé Security Command Center avant le 20 juin 2023, vous pouvez utiliser l'API Security Command Center v1 pour afficher les composants dans une organisation, un dossier ou un projet. Ces fonctionnalités de gestion des composants Security Command Center sont obsolètes et ne sont pas disponibles dans l'API Security Command Center v2. Ces fonctionnalités seront supprimées de l'API Security Command Center v1 à partir du 20 juin 2024.

Vous pouvez utiliser inventaire des éléments cloud pour afficher vos composants, y compris leurs indicateurs de sécurité. Pour en savoir plus, consultez Lister les composants.

Vous pouvez également utiliser l'API Security Command Center v2 pour mettre à jour les marques de sécurité de vos composants. Les méthodes de l'API Security Command Center qui mettent à jour les marques de sécurité ne sont pas obsolètes.

Mettre à jour les bibliothèques clientes et le fournisseur Terraform

Pour mettre à jour votre code afin d'utiliser l'API Security Command Center v2, procédez comme suit :

Terraform

Installez la version actuelle du fournisseur Terraform pour Google Cloud. Pour en savoir plus, consultez la documentation du fournisseur.

De plus, mettez à jour votre fichier de configuration Terraform pour créer des ressources qui commencent par le préfixe google_scc_v2_ ou google_scc_management_. N'oubliez pas que les ressources suivantes ne sont pas partagées entre les API v1 et v2 :

Si vous appliquez un plan d'exécution Terraform qui remplace ces ressources par leurs équivalents v2, Terraform supprimera les configurations v1 et créera des configurations v2.

C++

Mettez à jour votre application pour inclure le fichier d'en-tête v2 de la bibliothèque cliente :

#include "google/cloud/securitycenter/v2/security_center_client.h"

De plus, mettez à jour votre application pour qu'elle utilise les classes de l'espace de noms v2 :

namespace securitycenter = ::google::cloud::securitycenter_v2;

C#

Installez la bibliothèque cliente v2, puis mettez à jour votre application pour qu'elle l'utilise :

Install-Package Google.Cloud.SecurityCenter.V2