Cette page explique comment intégrer Cloud HSM pour Google Workspace (CHGWS), le service de clés de chiffrement pour Google Workspace proposé par Cloud Key Management Service (Cloud KMS). Cloud HSM pour Google Workspace offre des paramètres de confidentialité améliorés pour Google Workspace, ce qui vous aide à respecter les normes réglementaires telles que DISA IL5 et à renforcer la sécurité des données. Cloud HSM est un service de gestion de clés disponibilité élevée, entièrement géré et conforme aux normes, qui fonctionne à l'échelle du cloud avec des clés intégrées au matériel stockées dans des HSM (modules de sécurité matériels) conformes à la norme FIPS 140-2 de niveau 3.
CHGWS est compatible avec les clés Cloud HSM mutualisées et à locataire unique.
Pour en savoir plus, consultez Cloud HSM pour Google Workspace.
Assistance automatisée pour l'intégration
La console d'administration Google Workspace propose un processus d'intégration automatisé qui est beaucoup plus rapide que l'intégration manuelle. Toutefois, l'intégration automatisée n'est possible que si vous remplissez tous les critères suivants :
- Vous configurez le chiffrement côté client Google Workspace pour la première fois.
- Vous utilisez Google Identity comme fournisseur d'identité (IdP).
- Vous utilisez des clés Cloud HSM mutualisées.
Si vous remplissez tous ces critères, accédez à la console d'administration et suivez le processus d'intégration automatisé.
Vous devrez effectuer l'intégration manuellement si vous remplissez l'un des critères suivants :
- Vous utilisez un IdP tiers.
- Vous utilisez Cloud HSM à locataire unique.
- Vous prévoyez de migrer des clés depuis un autre service de clés.
- Vous souhaitez modifier une configuration Cloud HSM existante pour Google Workspace.
Si vous remplissez l'un de ces critères, suivez les instructions de configuration de ce document.
Avant de commencer
Avant d'intégrer Cloud HSM pour Google Workspace, remplissez les conditions préalables suivantes :
- Configurez un compte Google Workspace.
- Activez le chiffrement côté client Google Workspace (CSE) dans votre Google Workspace.
- Configurez votre fournisseur d'identité (IdP) dans le CSE Google Workspace. Notez l'ID client de votre IdP. Si vous utilisez Google Identity Platform, recherchez l'ID client dans votre projet Google Cloud .
- Facultatif : Si vous autorisez l'accès au contenu chiffré par CSE sur des applications de plate-forme autres que Web (par exemple, mobiles ou de bureau), ajoutez les ID client de ces plates-formes dans les paramètres de votre IdP dans la console d'administration Google Workspace. Notez tous les ID client de ce fournisseur d'identité. Si vous utilisez Google Identity Platform, recherchez ces ID client dans votre projet Google Cloud . Pour les autres fournisseurs d'identité, créez ces ID client séparément.
Emplacements compatibles
Vous pouvez stocker vos clés Cloud KMS dans n'importe quel emplacement régional ou multirégional des zones géographiques États-Unis ou Europe. Cloud HSM pour Google Workspace est compatible avec les clés Cloud HSM mutualisées et à locataire unique. Pour trouver un emplacement spécifique, accédez à Emplacements Cloud KMS et filtrez par type de HSM.
Cloud HSM pour Google Workspace fournit automatiquement le point de terminaison dans l'un des emplacements multirégionaux suivants, le plus proche de l'emplacement de votre clé :
useur3
Configurer un projet Google Cloud pour Cloud KMS
Les points de terminaison Cloud HSM pour Google Workspace s'appuient sur des clés Cloud KMS pour les opérations cryptographiques. Configurez un nouveau projet Google Cloud pour héberger les clés Cloud KMS.
Créer un projet Google Cloud Il s'agit de votre projet clé. Notez l'ID du projet et le numéro du projet, car vous en aurez besoin pour terminer la configuration.
Activez l'API Cloud KMS dans votre projet de clé Google Cloud .
Activez l'API Workspace Key Access (preview) dans votre projet de cléGoogle Cloud .
Dans la console Google Cloud , cliquez sur terminal Activer Cloud Shell.
Vérifiez que vous êtes dans le bon projet en comparant l'ID de votre projet à celui de l'invite Cloud Shell.
À l'aide de Cloud Shell, créez le compte de service Cloud HSM pour Google Workspace :
gcloud beta services identity create \ --service=cloudkmskacls-pa.googleapis.comNotez l'identité de service créée par cette commande. Vous aurez besoin du nom de l'identité de service à l'étape suivante.
Attribuez les rôles Agent de service de clé CHGWS et Navigateur au compte de service que vous avez créé :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudkmskacls.iam.gserviceaccount.com \ --role=roles/cloudkmskacls.serviceAgent gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudkmskacls.iam.gserviceaccount.com \ --role=roles/browserRemplacez les éléments suivants :
PROJECT_ID: ID du projet de votre clé.PROJECT_NUMBER: numéro de votre projet de clé.
Attribuez le rôle Administrateur de l'API Workspace Key Access (
roles/workspacekeyaccess.admin) (preview) à l'administrateur qui crée et gère les configurations et les points de terminaison CHGWS :gcloud projects add-iam-policy-binding PROJECT_ID \ --member=user:ADMIN_USER_EMAIL \ --role=roles/workspacekeyaccess.adminRemplacez les éléments suivants :
PROJECT_ID: ID du projet de votre clé.ADMIN_USER_EMAIL: adresse e-mail de l'administrateurGoogle Cloud qui crée et gère les configurations et les points de terminaison CHGWS.
Configurer des clés Cloud KMS
Configurez les ressources Cloud KMS pour le point de terminaison de votre service de clés CHGWS.
Créez un trousseau de clés dans l'une des régions prises en charge :
gcloud kms keyrings create KEY_RING --location LOCATIONRemplacez les éléments suivants :
KEY_RING: nom que vous souhaitez utiliser pour votre trousseau de clés CHGWS, par exempleCHGWS_KEY_RING.LOCATION: emplacement où vous souhaitez créer votre trousseau de clés, par exempleus.
Créez une clé Cloud HSM.
Cloud HSM mutualisé
Pour créer une clé avec le niveau de protection
hsm:gcloud kms keys create KEY_NAME \ --protection-level "hsm" \ --keyring KEY_RING \ --location LOCATION \ --purpose "encryption" \ --rotation-period ROTATION_PERIOD \ --next-rotation-time NEXT_ROTATION_TIMERemplacez les éléments suivants :
KEY_NAME: nom que vous souhaitez utiliser pour votre clé, par exempleCHGWS_KEY.KEY_RING: nom de votre trousseau de clés (par exemple,CHGWS_KEY_RING).LOCATION: emplacement dans lequel vous avez créé votre trousseau de clés, par exempleus.ROTATION_PERIOD: fréquence à laquelle vous souhaitez effectuer la rotation de vos clés, par exemple7d.NEXT_ROTATION_TIME: date et heure de la prochaine rotation de clé, par exemple2024-03-20T01:00:00.
Cloud HSM à locataire unique
Pour créer une clé avec le niveau de protection
hsm_single_tenant, vous devez d'abord provisionner une instance Cloud HSM à locataire unique au même emplacement.Créer et provisionner une instance Cloud HSM à locataire unique : suivez les instructions du guide Créer et gérer une instance Cloud HSM à locataire unique. Notez l'ID de l'instance provisionnée. Vous en aurez besoin à l'étape suivante.
Créer une clé :
gcloud kms keys create KEY_NAME \ --protection-level "hsm_single_tenant" \ --keyring KEY_RING \ --location LOCATION \ --purpose "encryption" \ --crypto-key-backend "projects/PROJECT_ID/locations/LOCATION/singleTenantHsmInstances/INSTANCE_NAME" \ --rotation-period ROTATION_PERIOD \ --next-rotation-time NEXT_ROTATION_TIMERemplacez les éléments suivants :
KEY_NAME: nom que vous souhaitez utiliser pour votre clé, par exempleCHGWS_KEY.KEY_RING: nom de votre trousseau de clés (par exemple,CHGWS_KEY_RING).LOCATION: emplacement dans lequel vous avez créé votre trousseau de clés, par exempleus.PROJECT_ID: ID du projet de votre clé.INSTANCE_NAME: nom de l'instance Cloud HSM à locataire unique dans laquelle vous souhaitez créer la clé.ROTATION_PERIOD: fréquence à laquelle vous souhaitez effectuer la rotation de vos clés (par exemple,7d).NEXT_ROTATION_TIME: date et heure de la prochaine rotation de clé, par exemple2024-03-20T01:00:00.
Pour en savoir plus sur les options de création de clés, consultez Créer des clés.
Intégrer à l'aide de l'API Workspace Key Access en libre-service
Vous pouvez utiliser la Google Cloud CLI avec l'API Workspace Key Access pour créer et gérer les ressources CHGWS suivantes :
- Config : stocke les informations sur votre organisation Google Workspace et votre IdP, y compris votre ID client, les adresses e-mail des administrateurs, les domaines autorisés et les paramètres d'authentification par jeton Web JSON (JWT).
- Point de terminaison : connecte votre configuration CHGWS à votre clé Cloud KMS et fournit l'URL du service de clé (
uri) que vous enregistrez dans la console d'administration Google Workspace pour le CSE.
Les sections suivantes vous expliquent comment créer et gérer vos configurations et points de terminaison CHGWS à l'aide de la Google Cloud CLI.
Vous pouvez également demander un point de terminaison CHGWS en contactant votre responsable de compte.
Créer des configurations CHGWS
Votre configuration CHGWS stocke des informations sur votre organisation Google Workspace et les fournisseurs d'identité (IdP) avec lesquels vos utilisateurs s'authentifient. Vous pouvez utiliser CHGWS avec un IdP principal uniquement, ou configurer à la fois un IdP principal et un IdP pour les invités.
Pour configurer CHGWS de sorte qu'il n'utilise qu'un IdP principal, procédez comme suit :
Créez une configuration CHGWS pour enregistrer votre Google Workspace à l'aide de la commande
workspace-key-access configs create:gcloud beta workspace-key-access configs create CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION \ --customer-id=CUSTOMER_ID \ --admin-emails=ADMIN_EMAILS \ --kacls-owner-domains=OWNER_DOMAINS \ --idp-configs=' idpType=PRIMARY_IDP, issuer=IDP_ISSUER, jwksUri=IDP_JWKS_URI, audience=IDP_AUDIENCE, additionalAudiences=[ADDITIONAL_IDP_AUDIENCES] 'Remplacez les éléments suivants :
CONFIG_ID: identifiant de votre configuration, par exemplemy-workspace-config.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement où vous souhaitez créer votre configuration, par exempleus. Spécifiez l'un des emplacements compatibles.CUSTOMER_ID: ID client Google Workspace. Pour trouver votre numéro client, consultez Trouver votre numéro client.ADMIN_EMAILS: liste d'adresses e-mail d'administrateur Google Workspace, séparées par une virgule.OWNER_DOMAINS: liste de domaines client Google Workspace autorisés, séparés par une virgule, dans lesquels vous enregistrez le service de clé. Recherchez vos domaines dans la console d'administration Google Workspace, sur la page Gérer les domaines.IDP_ISSUER: URL de l'émetteur JWT de votre IdP principal. Pour Google Identity Platform, utilisezhttps://accounts.google.com.IDP_JWKS_URI: URL de l'ensemble de clés Web JSON (JWKS) de votre IdP principal. Pour Google Identity Platform, utilisezhttps://www.googleapis.com/oauth2/v3/certs.IDP_AUDIENCE: ID client OAuth 2.0 de votre IdP principal pour les applications Web.ADDITIONAL_IDP_AUDIENCES(facultatif) : liste d'ID client OAuth 2.0 pour les applications de plates-formes non Web, séparés par une virgule sans espace. Les applications peuvent inclure des applications mobiles ou de bureau. Si vous n'avez pas besoin de configurer d'autres audiences, supprimez l'espace réservé pour que les crochets soient vides (additionalAudiences=[]). Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
Pour en savoir plus sur les options disponibles, consultez
gcloud beta workspace-key-access configs create.
Pour configurer CHGWS afin d'utiliser à la fois un IdP principal et un IdP invité, procédez comme suit :
Créez une configuration CHGWS pour enregistrer votre Google Workspace à l'aide de la commande
workspace-key-access configs createet spécifiez deux fois l'option--idp-configs:gcloud beta workspace-key-access configs create CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION \ --customer-id=CUSTOMER_ID \ --admin-emails=ADMIN_EMAILS \ --kacls-owner-domains=OWNER_DOMAINS \ --idp-configs=' idpType=PRIMARY_IDP, issuer=IDP_ISSUER, jwksUri=IDP_JWKS_URI, audience=IDP_AUDIENCE, additionalAudiences=[ADDITIONAL_IDP_AUDIENCES] ' \ --idp-configs=' idpType=GUEST_IDP, issuer=GUEST_IDP_ISSUER, jwksUri=GUEST_IDP_JWKS_URI, audience=GUEST_IDP_AUDIENCE, additionalAudiences=[GUEST_ADDITIONAL_IDP_AUDIENCES] 'Remplacez les éléments suivants :
CONFIG_ID: identifiant de votre configuration, par exemplemy-workspace-config.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement où vous souhaitez créer votre configuration, par exempleus. Spécifiez l'un des emplacements compatibles.CUSTOMER_ID: ID client Google Workspace. Pour trouver votre numéro client, consultez Trouver votre numéro client.ADMIN_EMAILS: liste d'adresses e-mail d'administrateur Google Workspace, séparées par une virgule.OWNER_DOMAINS: liste de domaines client Google Workspace autorisés, séparés par une virgule, dans lesquels vous enregistrez le service de clé. Recherchez vos domaines dans la console d'administration Google Workspace, sur la page Gérer les domaines.IDP_ISSUER: URL de l'émetteur JWT de votre IdP principal. Pour Google Identity Platform, utilisezhttps://accounts.google.com.IDP_JWKS_URI: URL de l'ensemble de clés Web JSON (JWKS) de votre IdP principal. Pour Google Identity Platform, utilisezhttps://www.googleapis.com/oauth2/v3/certs.IDP_AUDIENCE: ID client OAuth 2.0 de votre IdP principal pour les applications Web.ADDITIONAL_IDP_AUDIENCES(facultatif) : liste d'ID client OAuth 2.0 pour les applications de plates-formes non Web, séparés par une virgule sans espace. Les applications peuvent inclure des applications mobiles ou de bureau. Si vous n'avez pas besoin de configurer d'autres audiences, supprimez l'espace réservé pour que les crochets soient vides (additionalAudiences=[]). Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.GUEST_IDP_ISSUER: URL de l'émetteur du jeton JWT de votre IdP invité. Pour Google Identity Platform, utilisezhttps://accounts.google.com.GUEST_IDP_JWKS_URI: URL JWKS de votre IdP invité. Pour Google Identity Platform, utilisezhttps://www.googleapis.com/oauth2/v3/certs.GUEST_IDP_AUDIENCE: ID client OAuth 2.0 de votre IdP invité pour les applications Web, à l'exception de Google Meet.GUEST_ADDITIONAL_IDP_AUDIENCES: (facultatif) Liste d'ID client OAuth 2.0 pour les applications de plates-formes non Web que vous configurez pour votre IdP invité, séparés par une virgule sans espace. Les applications peuvent inclure des applications mobiles ou de bureau. Si vous n'avez pas besoin de configurer d'autres audiences, supprimez l'espace réservé pour que les crochets soient vides (additionalAudiences=[]). Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
Pour en savoir plus sur les options disponibles, consultez
gcloud beta workspace-key-access configs create.
Facultatif : Pour vérifier que votre configuration est correcte, procédez comme suit :
Décrivez la configuration pour afficher ses détails :
gcloud beta workspace-key-access configs describe CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION
Créer un point de terminaison CHGWS
Créez un point de terminaison de service de clé CHGWS, puis associez-le à votre configuration CHGWS et à votre clé Cloud KMS :
gcloud beta workspace-key-access endpoints create ENDPOINT_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION \ --config=projects/PROJECT_ID/locations/ENDPOINT_LOCATION/configs/CONFIG_ID \ --kms-key=projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAMERemplacez les éléments suivants :
ENDPOINT_ID: identifiant du point de terminaison de votre service de clé, par exemplemy-kacls-endpoint.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement de votre configuration et de votre point de terminaison, par exempleus. Spécifiez l'un des emplacements compatibles.CONFIG_ID: ID de la configuration que vous avez créée précédemment.LOCATION: emplacement où vous avez créé votre trousseau de clés Cloud KMS (par exemple,us).KEY_RING: nom de votre trousseau de clés Cloud KMS.KEY_NAME: nom de votre clé Cloud KMS.
Décrivez le point de terminaison pour récupérer son
urigénéré et vérifiez que sonstateestACTIVE:gcloud beta workspace-key-access endpoints describe ENDPOINT_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATIONCopiez la valeur
urifigurant dans le résultat. Vous utiliserez cette URL dans Configurer le point de terminaison CHGWS dans le CSE Google Workspace.
Demander un point de terminaison CHGWS
Pour demander l'intégration et la création de points de terminaison, contactez votre responsable de compte et fournissez-lui les informations suivantes :
Détails de Google Workspace :
Numéro client Google Workspace : votre numéro client Google Workspace. Pour trouver votre numéro client, consultez Trouver votre numéro client.
Adresses e-mail des administrateurs Google Workspace : fournissez une liste d'adresses e-mail d'administrateurs séparées par une virgule.
Informations sur le fournisseur d'identité :
Informations sur le fournisseur d'identité principal :
- URL JWKS de l'IdP : pour Google Identity Platform, utilisez
https://www.googleapis.com/oauth2/v3/certs. - Émetteur de jetons JWT : pour Google Identity Platform, utilisez
https://accounts.google.com. - Audience JWT : ID client de votre IdP pour les applications Web.
- Audiences JWT supplémentaires (facultatif) : indiquez les ID client des applications de plate-forme non Web que vous configurez. Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
- URL JWKS de l'IdP : pour Google Identity Platform, utilisez
Informations sur l'IdP pour les invités : (facultatif) complétez cette section si vous utilisez un IdP pour les invités.
- URL JWKS de l'IdP pour les invités : URL JWKS de votre IdP pour les invités.
- Émetteur de jeton JWT invité : émetteur de jeton JWT de votre IdP invité.
- Audience JWT des invités : ID client de votre IdP pour les invités pour les applications Web, à l'exception de Google Meet.
- Audiences JWT supplémentaires pour les invités : facultatif. Si vous configurez un ID client Web Google Meet ou d'autres ID client d'application pour une plate-forme non Web, indiquez les ID client pour chacun d'eux. Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
Informations importantes sur le CSE :
- Google Cloud ID du projet :
PROJECT_ID - Google Cloud Numéro de projet :
PROJECT_NUMBER - Nom du trousseau de clés Cloud KMS :
KEY_RING - Emplacement du trousseau de clés Cloud KMS :
LOCATION - Nom de la clé Cloud KMS :
KEY_NAME - Niveau de protection de la clé Cloud KMS :
hsmouhsm_single_tenant - URL de base CHGWS (facultatif) : liste d'URL pour activer la migration des clés. Si vous configurez CHGWS pour la première fois pour ce compte Google Workspace, laissez ce champ vide.
- Google Cloud ID du projet :
Informations supplémentaires :
- Customer Name (Nom du client) : indiquez le nom du client.
- Nombre d'utilisateurs attendu : indiquez le nombre d'utilisateurs attendu dans votre instance Google Workspace.
Gérer les points de terminaison du service CHGWS
Les sections suivantes vous expliquent comment gérer vos points de terminaison CHGWS.
Configurer le point de terminaison CHGWS dans le CSE Google Workspace
Après avoir créé un point de terminaison CHGWS, accédez à la console d'administration Google Workspace pour configurer Google Workspace afin qu'il utilise le point de terminaison. L'URL du point de terminaison et les paramètres du fournisseur d'identité dans la console d'administration doivent correspondre aux détails du point de terminaison CHGWS. Si vous mettez à jour la configuration du point de terminaison CHGWS, vous devez également mettre à jour la configuration du service de clés dans la console d'administration Google Workspace pour qu'elle corresponde aux informations mises à jour. Pour en savoir plus, consultez Ajouter et gérer des services de clés pour le chiffrement côté client.
Migration du service de clés
CHGWS vous permet de déplacer votre service de clés vers ou depuis CHGWS. Pour lancer une migration de service de clés, contactez votre responsable de compte pour obtenir de l'aide afin d'envoyer une demande de migration. Dans la requête, incluez les informations suivantes :
- ID du point de terminaison : ID du point de terminaison de CHGWS.
URL du service de clés : liste d'URL permettant d'activer la migration du service de clés.
- Si vous migrez vers Cloud HSM pour Google Workspace, indiquez l'URL de base de chaque point de terminaison de service de clé à partir duquel vous effectuez la migration.
- Si vous migrez depuis Cloud HSM pour Google Workspace, indiquez les URL de base des points de terminaison du service de clés vers lesquels vous souhaitez effectuer la migration.
Mettre à jour une configuration à l'aide de l'API Workspace Key Access en libre-service
Vous pouvez mettre à jour les adresses e-mail des administrateurs, les domaines client autorisés ou les détails de l'IdP d'une configuration CHGWS existante à l'aide de la gcloud CLI. La mise à jour d'une configuration met automatiquement à jour tous les points de terminaison qui l'utilisent.
Mettez à jour votre configuration CHGWS. N'incluez que les options des champs que vous souhaitez mettre à jour et supprimez toutes les options des champs que vous souhaitez conserver inchangés. Chaque option que vous incluez remplace les valeurs existantes de ce champ :
gcloud beta workspace-key-access configs update CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION \ --admin-emails=ADMIN_EMAILS \ --kacls-owner-domains=OWNER_DOMAINS \ --idp-configs=' idpType=PRIMARY_IDP, issuer=IDP_ISSUER, jwksUri=IDP_JWKS_URI, audience=IDP_AUDIENCE, additionalAudiences=[ADDITIONAL_IDP_AUDIENCES] ' \ --idp-configs=' idpType=GUEST_IDP, issuer=GUEST_IDP_ISSUER, jwksUri=GUEST_IDP_JWKS_URI, audience=GUEST_IDP_AUDIENCE, additionalAudiences=[GUEST_ADDITIONAL_IDP_AUDIENCES] 'Remplacez les éléments suivants :
CONFIG_ID: ID de la configuration que vous souhaitez mettre à jour.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement de votre configuration, par exempleus. Spécifiez l'un des emplacements compatibles.ADMIN_EMAILS: (facultatif) liste d'adresses e-mail d'administrateur Google Workspace, séparées par une virgule. Supprimez--admin-emailssi vous ne souhaitez pas mettre à jour les adresses e-mail des administrateurs.OWNER_DOMAINS(facultatif) : liste de domaines client Google Workspace autorisés où vous enregistrez le service de clé, séparés par une virgule. Recherchez vos domaines dans la console d'administration Google Workspace, sur la page Gérer les domaines. Supprimez--kacls-owner-domainssi vous ne souhaitez pas mettre à jour les domaines client autorisés.--idp-configs:- Si vous n'avez configuré qu'un IdP principal : supprimez le deuxième (
GUEST_IDP) flag--idp-configs(et la barre oblique inverse de fin sur la ligne précédente) et mettez à jour les détails dans le flagPRIMARY_IDP. Votre IdP pour les invités n'est toujours pas défini. - Si vous avez configuré un IdP principal et un IdP pour les invités : vous devez inclure les deux options
--idp-configs, même si vous n'en mettez à jour qu'une seule. Si vous omettez l'optionGUEST_IDP, votre IdP pour les invités est écrasé et n'est pas défini. Si vous omettez l'optionPRIMARY_IDP, la mise à jour échoue. - Si vous ne souhaitez pas mettre à jour d'IdP : supprimez les deux options
--idp-configsafin que les détails de votre IdP existant restent inchangés.
- Si vous n'avez configuré qu'un IdP principal : supprimez le deuxième (
- Informations sur l'IdP principal : obligatoire chaque fois que vous incluez
--idp-configs:IDP_ISSUER: URL de l'émetteur du jeton JWT de votre fournisseur d'identité principal. Pour Google Identity Platform, utilisezhttps://accounts.google.com.IDP_JWKS_URI: URL JWKS de votre fournisseur d'identité principal. Pour Google Identity Platform, utilisezhttps://www.googleapis.com/oauth2/v3/certs.IDP_AUDIENCE: ID client OAuth 2.0 de votre IdP principal pour les applications Web.ADDITIONAL_IDP_AUDIENCES(facultatif) : liste d'ID client OAuth 2.0 pour les applications de plates-formes non Web (telles que les applications Android, iOS ou de bureau), séparés par des virgules sans espaces. Si vous n'avez pas besoin de configurer d'autres audiences, supprimez l'espace réservé pour que les crochets soient vides (additionalAudiences=[]). Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
- Informations sur l'IdP pour les invités : facultatif : requis uniquement lorsque vous incluez le deuxième (
GUEST_IDP) flag--idp-configs:GUEST_IDP_ISSUER: URL de l'émetteur du jeton JWT de votre IdP invité. Pour Google Identity Platform, utilisezhttps://accounts.google.com.GUEST_IDP_JWKS_URI: URL JWKS de votre IdP invité. Pour Google Identity Platform, utilisezhttps://www.googleapis.com/oauth2/v3/certs.GUEST_IDP_AUDIENCE: ID client OAuth 2.0 de votre IdP invité pour les applications Web, à l'exception de Google Meet.GUEST_ADDITIONAL_IDP_AUDIENCES: (facultatif) liste d'ID client OAuth 2.0 séparés par une virgule si vous configurez un ID client Web Google Meet ou d'autres ID client d'application de plate-forme non Web pour votre IdP invité (séparés par des virgules sans espaces). Si vous n'avez pas besoin de configurer d'autres audiences, supprimez l'espace réservé pour que les crochets soient vides (additionalAudiences=[]). Pour Google Identity Platform, utilisez les ID client indiqués dans Si vous utilisez l'identité Google pour le CSE.
Pour en savoir plus sur les options disponibles, consultez
gcloud beta workspace-key-access configs update.Facultatif : Examinez les détails de la configuration pour vérifier qu'elle est correctement mise à jour :
gcloud beta workspace-key-access configs describe CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATIONFacultatif : Si vous disposez d'une configuration inutilisée qui n'est associée à aucun point de terminaison, vous pouvez la supprimer :
gcloud beta workspace-key-access configs delete CONFIG_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATION
Mettre à jour un point de terminaison pour utiliser une autre configuration
Vous pouvez associer un point de terminaison CHGWS à une autre configuration dans le même projet et le même emplacement Google Cloud . Toutefois, vous ne pouvez pas modifier la clé Cloud KMS associée à un point de terminaison.
Mettez à jour la configuration associée à un point de terminaison :
gcloud beta workspace-key-access endpoints update ENDPOINT_ID \
--project=PROJECT_ID \
--location=ENDPOINT_LOCATION \
--config=projects/PROJECT_ID/locations/ENDPOINT_LOCATION/configs/NEW_CONFIG_ID
Remplacez les éléments suivants :
ENDPOINT_ID: ID du point de terminaison du service de clé que vous souhaitez mettre à jour.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement de votre point de terminaison et de votre configuration, par exempleus. Spécifiez l'un des emplacements compatibles.NEW_CONFIG_ID: ID de la configuration dans le même projet et le même emplacement que vous souhaitez associer au point de terminaison.
Demander des mises à jour d'un point de terminaison
Si vous avez effectué l'intégration en demandant un point de terminaison CHGWS et que vous devez mettre à jour vos informations CHGWS existantes, contactez votre responsable de compte pour envoyer une demande de mise à jour. Dans la demande, incluez votre ID client Google Workspace, votre ID de projet Google Cloud et l'ID de point de terminaison CHGWS, ainsi que les adresses e-mail de l'administrateur Google Workspace ou les détails du fournisseur d'identité mis à jour, listés dans Demander un point de terminaison CHGWS.
Désactiver et activer les points de terminaison et la facturation
Vous ne pouvez pas supprimer un point de terminaison CHGWS. Toutefois, si vous avez intégré vous-même votre point de terminaison, vous pouvez le désactiver ou le réactiver à l'aide de Workspace Key Access avec la gcloud CLI. La désactivation d'un point de terminaison le fait passer à l'état DISABLED et met fin à son abonnement de facturation.
Pour désactiver un point de terminaison que vous avez intégré vous-même, procédez comme suit :
Désactivez le point de terminaison actif et désactivez la facturation :
gcloud beta workspace-key-access endpoints disable ENDPOINT_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATIONRemplacez les éléments suivants :
ENDPOINT_ID: ID du point de terminaison du service de clé que vous souhaitez désactiver.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement de votre point de terminaison, par exempleus. Spécifiez l'un des emplacements compatibles.
Avant de pouvoir réactiver un point de terminaison, la clé Cloud KMS et les versions de clé utilisées par le point de terminaison doivent être accessibles et actives. L'activation d'un point de terminaison redémarre son abonnement de facturation et fait passer le point de terminaison à l'état ACTIVE.
Pour réactiver un point de terminaison que vous avez désactivé à l'aide de la commande workspace-key-access
endpoints disable, procédez comme suit :
Réactivez le point de terminaison et redémarrez la facturation :
gcloud beta workspace-key-access endpoints enable ENDPOINT_ID \ --project=PROJECT_ID \ --location=ENDPOINT_LOCATIONRemplacez les éléments suivants :
ENDPOINT_ID: ID du point de terminaison du service de clé que vous souhaitez activer.PROJECT_ID: ID du projet de votre clé.ENDPOINT_LOCATION: emplacement de votre point de terminaison, par exempleus. Spécifiez l'un des emplacements compatibles.
Désactiver et activer les versions de clé sous-jacentes
Quelle que soit la manière dont vous avez intégré votre point de terminaison, vous pouvez désactiver les versions de clé Cloud KMS sous-jacentes dans Cloud KMS à l'aide de la consoleGoogle Cloud , de gcloud CLI ou de l'API Cloud KMS. La désactivation des versions de clé sous-jacentes désactive le point de terminaison sans résilier l'abonnement de facturation. Vous pouvez ensuite désactiver la facturation séparément.
Pour désactiver les versions de clé sous-jacentes, procédez comme suit :
Pour chaque version de clé Cloud KMS qui sauvegarde le point de terminaison, exécutez la commande suivante :
gcloud kms keys versions disable KEY_VERSION --keyring \ KEY_RING --location LOCATION --key KEY_NAMERemplacez les éléments suivants :
KEY_VERSION: version de la clé que vous souhaitez désactiver (par exemple,1).KEY_RING: nom du trousseau de clés, par exempleCHGWS_KEY_RING.LOCATION: emplacement de la version de clé que vous souhaitez désactiver, par exempleus.KEY_NAME: nom de la clé, par exempleCHGWS_KEY.
Pour réactiver un point de terminaison CHGWS que vous avez désactivé en désactivant toutes les versions de la clé Cloud KMS qui le sauvegarde, procédez comme suit :
Pour chaque version de clé Cloud KMS qui sauvegarde le point de terminaison, exécutez la commande suivante :
gcloud kms keys versions enable KEY_VERSION --keyring \ KEY_RING --location LOCATION --key KEY_NAMERemplacez les éléments suivants :
KEY_VERSION: version de la clé que vous souhaitez activer (par exemple,1).KEY_RING: nom du trousseau de clés, par exempleCHGWS_KEY_RING.LOCATION: emplacement de la version de clé que vous souhaitez activer (par exemple,us).KEY_NAME: nom de la clé, par exempleCHGWS_KEY.
Gérer la facturation pour CHGWS
La facturation commence dès que votre point de terminaison CHGWS est créé et actif. À partir de ce moment, les frais d'abonnement récurrents pour Cloud HSM pour Google Workspace continuent tant que le point de terminaison reste ACTIVE sur le projetGoogle Cloud . Cette section explique comment arrêter d'accumuler des frais pour Cloud HSM pour Google Workspace et comment les reprendre.
Désactiver et activer des points de terminaison
Si vous avez intégré vous-même votre point de terminaison, vous pouvez utiliser l'API Workspace Key Access pour désactiver un point de terminaison CHGWS tout en conservant les autres ressources de votre projet Google Cloud actives.
La désactivation d'un point de terminaison le fait passer à l'état DISABLED et met fin à son abonnement de facturation. Vous pourrez réactiver le point de terminaison ultérieurement pour redémarrer son abonnement de facturation et le faire repasser à l'état ACTIVE.
Pour en savoir plus, consultez Désactiver et activer les points de terminaison et la facturation.
Désactiver ou activer la facturation d'un projet
Vous pouvez désactiver la facturation pour le projet qui contient vos clés Cloud KMS pour Cloud HSM pour Google Workspace. La désactivation de la facturation entraîne l'arrêt de tous les services payants du projet. Une fois la facturation au niveau du projet désactivée, les frais d'abonnement Cloud HSM pour Google Workspace devraient cesser dans les 24 heures.
Lorsque vous souhaitez recommencer à utiliser Cloud HSM pour Google Workspace, vous pouvez réactiver la facturation sur le projet. Une fois la facturation réactivée, vos frais d'abonnement reprennent, et votre point de terminaison CHGWS et vos clés Cloud KMS fonctionnent à nouveau normalement.
Demander la désactivation ou l'activation manuelle
Si vous avez effectué l'intégration en demandant un point de terminaison CHGWS et que vous devez le désactiver tout en conservant les autres ressources du projet actives, envoyez une demande semblable à la demande d'intégration. Fournissez les détails de Google Workspace, l'ID de point de terminaison CHGWS et d'autres informations pertinentes, puis décrivez votre besoin. Le traitement des demandes manuelles par l'équipe CHGWS peut prendre 48 heures. Une fois la demande traitée, les frais d'abonnement à Cloud HSM pour Google Workspace devraient cesser dans les 24 heures.
Vous pouvez réactiver le point de terminaison CHGWS et sa facturation en créant une requête similaire.
Supprimer ou restaurer le projet
Vous pouvez supprimer le projet contenant vos clés Cloud KMS pour Cloud HSM pour Google Workspace. La suppression d'un projet entraîne l'arrêt de tous les services qu'il contient. Vous pouvez récupérer un projet supprimé dans les 30 jours suivant sa suppression. Toutefois, les clés Cloud KMS du projet ne peuvent pas être récupérées. Par conséquent, tous les documents et autres données chiffrés avec des clés du projet restauré restent définitivement détruits par chiffrement. La restauration d'un projet supprimé entraîne la reprise des frais d'abonnement à Cloud HSM pour Google Workspace, même si les clés Cloud KMS restent irrécupérables.
Étapes suivantes
- En savoir plus sur Cloud HSM pour Google Workspace
- Consultez les bonnes pratiques concernant Cloud HSM pour Google Workspace.
- En savoir plus sur Cloud Key Management Service
- Découvrez comment ajouter et gérer des services de clés pour le chiffrement côté client.
- Découvrez comment configurer automatiquement le chiffrement côté client pour la première fois.