Par défaut, Cloud Scheduler chiffre le contenu client au repos. Cloud Scheduler gère le chiffrement sans intervention de votre part. Cette option est appelée chiffrement par défaut de Google.
Si vous souhaitez contrôler vos clés de chiffrement, vous pouvez utiliser des clés de chiffrement gérées par le client (CMEK) dans Cloud KMS avec des services bénéficiant d'une intégration des CMEK, y compris Cloud Scheduler. L'utilisation de clés Cloud KMS vous permet de contrôler leur niveau de protection, leur emplacement, leur calendrier de rotation, leurs autorisations d'utilisation et d'accès, ainsi que leurs limites cryptographiques. Grâce à Cloud KMS, vous pouvez également afficher les journaux d'audit et contrôler les cycles de vie des clés. Au lieu de laisser Google posséder et gérer les clés de chiffrement de clés (KEK) symétriques qui protègent vos données, c'est vous qui vous chargez de cette tâche dans Cloud KMS.
Une fois que vous avez configuré vos ressources avec des CMEK, l'accès à vos ressources Cloud Scheduler est semblable à celui du chiffrement par défaut de Google. Pour en savoir plus sur les options de chiffrement, consultez Clés de chiffrement gérées par le client (CMEK).
Éléments protégés par CMEK
Vous pouvez spécifier une clé Cloud KMS par projet Google Cloud et par région Cloud Scheduler compatible. Cette clé est utilisée pour protéger les données suivantes dans ce projet et cette région :
- Jobs avec une cible de point de terminaison HTTP ou HTTPS : le corps de la requête HTTP et les en-têtes client.
- Jobs avec une cible de sujet Pub/Sub : charge utile et attributs du message Pub/Sub.
Avant de commencer
Avant d'utiliser CMEK dans Cloud Scheduler, effectuez les étapes préalables suivantes.
Mettez à jour les composants
gcloud.gcloud components update
Connectez-vous à votre compte.
gcloud auth login
Activez l'API Cloud KMS pour le projet qui stocke vos clés de chiffrement :
gcloud services enable cloudkms.googleapis.com \ --project=KMS_PROJECT_ID
Remplacez
KMS_PROJECT_IDpar l'ID du projet qui stocke vos clés Cloud KMS. Il peut s'agir du même projet que vos jobs Cloud Scheduler ou d'un projet distinct.Cloud KMS génère des Cloud Audit Logs lorsque les clés sont activées, désactivées ou utilisées par les ressources Cloud Scheduler pour chiffrer et déchiffrer les données.
Assurez-vous que la journalisation est activée pour l'API Cloud KMS dans votre projet et que vous avez déterminé les autorisations et rôles spécifiques à Logging qui s'appliquent à votre cas d'utilisation. Pour en savoir plus, consultez Journaux d'audit Cloud KMS.
Rôles requis
Pour obtenir les autorisations nécessaires pour configurer des CMEK pour Cloud Scheduler, demandez à votre administrateur de vous accorder les rôles IAM suivants :
-
Accordez à l'agent de service l'accès à la clé : Administrateur Cloud KMS (
roles/cloudkms.admin) sur la clé, le trousseau de clés ou le projet contenant la clé Cloud KMS. -
Activer ou désactiver les CMEK : Administrateur Cloud Scheduler (
roles/cloudscheduler.admin) sur le projet Cloud Scheduler -
Affichez l'état de la configuration ou de l'opération CMEK :
- Lecteur Cloud Scheduler (
roles/cloudscheduler.viewer) sur le projet Cloud Scheduler - Administrateur Cloud Scheduler (
roles/cloudscheduler.admin) sur le projet Cloud Scheduler
- Lecteur Cloud Scheduler (
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour configurer les CMEK pour Cloud Scheduler. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Vous devez disposer des autorisations suivantes pour configurer CMEK pour Cloud Scheduler :
-
Accordez à l'agent de service l'accès à la clé :
cloudkms.cryptoKeys.setIamPolicysur la clé, le trousseau de clés ou le projet contenant la clé Cloud KMS. -
Activez ou désactivez les CMEK :
cloudscheduler.cmekConfig.updatesur le projet Cloud Scheduler. -
Affichez l'état de la configuration ou de l'opération CMEK :
-
cloudscheduler.cmekConfig.getsur le projet Cloud Scheduler -
cloudscheduler.operations.getsur le projet Cloud Scheduler
-
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Créer un trousseau de clés et une clé Cloud KMS
Vous pouvez créer un trousseau de clés ou en utiliser un existant. Dans le trousseau de clés, vous pouvez ajouter une clé ou en utiliser une existante. Nous vous recommandons d'utiliser des clés différentes pour des applications, des services ou des environnements distincts.
Créez une clé. La clé doit utiliser l'algorithme de chiffrement symétrique.
Accorder à l'agent de service Cloud Scheduler l'accès à la clé
Vous devez attribuer le rôle IAM (Identity and Access Management) Chiffreur/Déchiffreur de CryptoKeys Cloud KMS à l'agent de service Cloud Scheduler afin qu'il puisse accéder à la clé Cloud KMS. Si vous avez récemment activé l'API Cloud Scheduler dans un projet et que vous n'avez pas encore créé de jobs, vous devrez peut-être d'abord créer l'agent de service en exécutant gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID.
gcloud kms keys add-iam-policy-binding KEY_NAME \ --keyring=KEY_RING \ --location=LOCATION \ --project=KMS_PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler. \ --role=roles/cloudkms.cryptoKeyEncrypterDecrypter
Remplacez les éléments suivants :
KEY_NAME: nom de la clé (par exemple,my-key).KEY_RING: nom du trousseau de clés, par exemplemy-keyring.LOCATION: emplacement de la clé (par exemple,us-central1).KMS_PROJECT_ID: ID du projet dans lequel se trouve la clé Cloud KMS.PROJECT_NUMBER: numéro de votre projet Cloud Scheduler Google Cloud . Vous pouvez trouver le numéro de votre projet sur la page Bienvenue de la console Google Cloud ou en exécutant la commande suivante :export PROJECT=$(gcloud info --format='value(config.project)') gcloud projects describe ${PROJECT} --format="value(projectNumber)"
Tant que l'agent de service dispose du rôle roles/cloudkms.cryptoKeyEncrypterDecrypter, un job de votre projet peut chiffrer et déchiffrer ses données à l'aide de la clé CMEK. Si vous révoquez ce rôle, ou si vous désactivez ou détruisez la clé CMEK, ces données ne seront plus accessibles. Dans ce document, consultez Supprimer Cloud KMS.
Activer CMEK pour une région Cloud Scheduler
Spécifiez la clé Cloud KMS à utiliser pour le chiffrement des données dans une région Cloud Scheduler à l'aide de la commande gcloud scheduler cmek-config update :
gcloud scheduler cmek-config update \ --location=LOCATION \ --kms-key-name=KEY_NAME \ --kms-keyring=KEY_RING \ --kms-project=KMS_PROJECT_ID
Remplacez les éléments suivants :
LOCATION: région Cloud Scheduler compatible.KEY_NAME: nom de la clé (par exemple,my-key).KEY_RING: nom du trousseau de clés, par exemplemy-keyring.KMS_PROJECT_ID: ID du projet dans lequel se trouve la clé Cloud KMS que vous souhaitez utiliser.
Veuillez noter les points suivants :
- L'activation, la modification ou la désactivation d'une clé CMEK dans Cloud Scheduler s'exécute de manière asynchrone et renvoie une opération de longue durée (
projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID). Vous pouvez vérifier si la mise à jour est terminée en exécutant la commandegcloud scheduler operations describe. - Cloud Scheduler chiffre les jobs nouveaux et mis à jour dans le projet et la région protégés avec la clé activée. Les jobs existants précédemment chiffrés avec une ancienne clé sont rechiffrés avec la nouvelle clé.
- Les jobs non protégés existants sont chiffrés.
- La rotation d'une clé dans Cloud KMS ne rechiffre pas automatiquement les jobs existants et ne fait pas basculer les nouveaux jobs de la région vers la nouvelle version de la clé primaire. Pour en savoir plus, consultez Rotation des clés CMEK.
- Si vous désactivez CMEK pour une région, les jobs existants sont chiffrés à l'aide du chiffrement par défaut de Google, et les jobs suivants sont créés sans chiffrement CMEK. Dans ce document, consultez Désactiver CMEK pour une région Cloud Scheduler.
Vérifier la configuration de Cloud KMS
Vérifiez que CMEK est activé en récupérant la configuration CMEK pour une région Cloud Scheduler à l'aide de la commande gcloud scheduler cmek-config describe :
gcloud scheduler cmek-config describe \ --location=LOCATION
Le résultat ressemble à ce qui suit :
kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME name: projects/PROJECT_ID/locations/LOCATION/cmekConfig
La valeur kmsKeyName correspond à l'ID de ressource de la clé Cloud KMS utilisée pour sécuriser les jobs dans la région.
Désactiver CMEK pour une région Cloud Scheduler
Vous pouvez désactiver les CMEK pour une région Cloud Scheduler afin que tous les jobs créés dans cette région le soient sans chiffrement CMEK.
gcloud scheduler cmek-config update \ --location=LOCATION \ --clear-kms-key
Cela désactive les CMEK pour la région spécifique, et tous les jobs ultérieurs sont créés sans chiffrement CMEK. Les jobs existants sont chiffrés à l'aide du chiffrement par défaut de Google.
Supprimer Cloud KMS
Si vous souhaitez révoquer l'accès aux données de vos jobs, vous pouvez supprimer Cloud KMS de l'une des manières suivantes :
Désactivez ou détruisez la version de clé appropriée de votre clé de chiffrement gérée par le client. Vous pouvez vérifier si une version de clé est utilisée. La désactivation d'une version de clé CMEK suspend l'accès à toutes les données protégées par cette version de clé jusqu'à ce que la clé soit réactivée. La destruction d'une version de clé bloque définitivement l'accès et peut entraîner une perte de données irrécupérable. Ces deux opérations n'affectent que les jobs associés à la version de clé spécifique.
Vous ne pouvez pas afficher les ressources protégées par la version de clé désactivée ou détruite. Toutes les exécutions de jobs actives échouent avec un message d'erreur correspondant.
Révoquez le rôle IAM
roles/cloudkms.cryptoKeyEncrypterDecrypterde l'agent de service Cloud Scheduler. Cela affecte tous les jobs du projet et de la régionGoogle Cloud spécifiques qui sont compatibles avec le chiffrement à l'aide de CMEK. Vous ne pouvez pas créer de jobs intégrés aux CMEK, ni afficher ou lister les jobs chiffrés par CMEK (bien que vous puissiez toujours les supprimer). Toutes les exécutions de jobs actives échouent avec un message d'erreur correspondant.
Même si aucune de ces opérations ne garantit une révocation immédiate des accès, les modifications IAM prennent généralement effet plus rapidement. Pour en savoir plus, consultez les pages Cohérence des ressources Cloud KMS et Propagation des modifications d'accès.
À propos des contraintes liées aux règles d'administration CMEK
Cloud Scheduler est compatible avec les contraintes de règles d'administration suivantes, qui peuvent vous aider à appliquer l'utilisation des CMEK dans une organisation :
constraints/gcp.restrictNonCmekServices: utilisez cette contrainte pour exiger que des CMEK soient utilisées pour protéger toutes les nouvelles ressources Cloud Scheduler d'une organisation, d'un dossier ou d'un projet.Si elle est active, cette règle d'administration empêche la création ou la mise à jour de ressources, sauf si vous activez d'abord une clé Cloud KMS. Vous ne pouvez pas non plus désactiver les CMEK pour une région Cloud Scheduler.
constraints/gcp.restrictCmekCryptoKeyProjects: utilisez cette contrainte pour vous assurer que vos ressources Cloud Scheduler protégées par CMEK utilisent une clé d'un projet approuvé.Par exemple, vous pouvez spécifier une règle semblable à la suivante : "Pour toutes les ressources Cloud Scheduler dans
projects/my-company-data-project, la clé Cloud KMS utilisée dans ce projet doit provenir deprojects/my-company-central-keysOUprojects/team-specific-keys."
Veuillez noter les points suivants :
Après avoir appliqué une règle d'administration CMEK, vous pouvez toujours accéder aux jobs existants qui utilisent le chiffrement par défaut de Google. Toutefois, vous ne pouvez pas les mettre à jour, sauf si vous configurez d'abord une clé Cloud KMS acceptable pour la région Cloud Scheduler.
Les jobs qui ciblent une application App Engine ne sont pas soumis aux règles d'administration CMEK. Par exemple, si vous définissez la contrainte
constraints/gcp.restrictNonCmekServices, vous pouvez toujours créer ou mettre à jour un job qui cible une application App Engine.
Pour en savoir plus sur la configuration des règles d'administration, consultez Règles d'administration CMEK.
Dépannage
Vous pouvez rencontrer des erreurs lorsque vous utilisez Cloud KMS avec Cloud Scheduler. Le tableau suivant décrit les différents problèmes et indique comment les résoudre.
| Problème | Description |
|---|---|
L'autorisation cloudkms.cryptoKeyVersions.useToEncrypt est refusée |
Soit la clé Cloud KMS fournie n'existe pas, soit l'autorisation n'est pas correctement configurée. Solution :
|
| La version de clé n'est pas activée |
La version de clé Cloud KMS fournie a été désactivée. Solution : réactivez la version de clé Cloud KMS. |
| La région du trousseau de clés ne correspond pas à la ressource à protéger |
La région du trousseau de clés Cloud KMS fourni est différente de la région Cloud Scheduler protégée. Solution : utilisez un trousseau de clés Cloud KMS de la même région que celle de Cloud Scheduler. Le trousseau de clés peut se trouver dans un autre projet. Pour en savoir plus, consultez les pages Emplacements Cloud KMS et Emplacements Cloud Scheduler. |
| Le projet n'est pas compatible avec les CMEK dans Cloud Scheduler |
L'activation de CMEK échoue avec une erreur Solution :
|
Journaux d'audit
Cloud KMS génère des journaux d'audit lorsque les clés sont activées, désactivées ou utilisées par les ressources Cloud Scheduler pour chiffrer et déchiffrer les messages. Pour en savoir plus, consultez Journaux d'audit Cloud KMS.
Erreurs Cloud EKM
Pour résoudre les problèmes que vous pouvez rencontrer lors de l'utilisation de clés gérées en externe via Cloud External Key Manager (Cloud EKM), consultez la documentation de référence sur les erreurs Cloud EKM.
État de la clé non disponible
Si, pour une raison quelconque, Cloud KMS n'est pas disponible, Cloud Scheduler peut ne pas être en mesure de récupérer l'état de votre clé à partir de Cloud KMS.
Si Cloud KMS n'est pas disponible lorsqu'un job est planifié, Cloud Scheduler ne peut pas déchiffrer les données du job ni appeler la cible du job.
Pour les erreurs Cloud KMS temporaires (telles que UNAVAILABLE, RESOURCE_EXHAUSTED ou une clé Cloud EKM inaccessible), Cloud Scheduler relance le déchiffrement en interne avec un intervalle exponentiel entre les tentatives et consigne les entrées de journal CmekRetryFailure dans Cloud Logging sous cloudscheduler.googleapis.com/cmek. Pour les erreurs ne pouvant pas faire l'objet d'une nouvelle tentative, telles qu'une erreur d'autorisation ou une clé désactivée ou détruite, le déchiffrement échoue immédiatement sans appeler la cible.
Quotas Cloud KMS
Lorsque vous utilisez des clés CMEK dans Cloud Scheduler, vos projets peuvent consommer des quotas de requêtes de chiffrement Cloud KMS. Par exemple, Cloud Scheduler peut utiliser ces quotas lors de l'exécution de jobs, du traitement des requêtes de gestion des jobs ou de la mise à jour de la configuration CMEK. Cloud Scheduler réutilise une clé intermédiaire mise en cache pendant cinq minutes maximum par projet et par région. Ainsi, les exécutions fréquentes de jobs ne consomment pas de quota. Les opérations de chiffrement et de déchiffrement à l'aide de clés CMEK n'affectent les quotas Cloud KMS que si vous utilisez des clés externes (Cloud EKM). Pour en savoir plus, consultez Quotas Cloud KMS.Tarifs
Cette intégration n'entraîne pas de coûts supplémentaires, outre les frais liés aux opérations de clés Cloud KMS qui sont facturées dans le cadre de votre projet Google Cloud .
Les ressources de diffusion sous-jacentes qui utilisent votre clé via des autorisations de clé peuvent effectuer des opérations Cloud KMS supplémentaires. Pour vous aider à estimer l'utilisation de Cloud KMS pour les opérations Cloud Scheduler directes, attendez-vous aux taux d'opérations cryptographiques suivants par projet et par région :
- Exécutions de jobs : Cloud Scheduler réutilise une clé intermédiaire mise en cache pendant cinq minutes maximum par projet et par région. Les projets dont l'exécution des jobs est inférieure à une toutes les cinq minutes effectuent environ une opération de déchiffrement Cloud KMS par exécution. Les projets dont les exécutions sont plus fréquentes effectuent environ une opération de déchiffrement toutes les cinq minutes dans la région.
- Opérations de gestion des jobs : les requêtes de création, de mise à jour, d'obtention, de listage, de mise en pause ou de reprise de jobs avec des données protégées utilisent une clé intermédiaire mise en cache distincte pendant cinq minutes maximum par projet et par région.
- Mises à jour de la configuration CMEK : l'activation ou la modification d'une clé CMEK avec
cmek-configeffectue des opérations de clé Cloud KMS supplémentaires pour valider la clé et rechiffrer les jobs protégés existants dans la région. La désactivation des CMEK déchiffre les jobs protégés existants pour les ramener au chiffrement par défaut de Google.
Pour en savoir plus sur les tarifs, consultez la page Tarifs de Cloud KMS.