Cloud Scheduler verschlüsselt ruhende Kundeninhalte standardmäßig. Die Verschlüsselung wird von Cloud Scheduler übernommen. Weitere Maßnahmen Ihrerseits sind nicht erforderlich. Diese Option heißt Google-Standardverschlüsselung.
Wenn Sie Ihre Verschlüsselungsschlüssel selbst verwalten möchten, können Sie kundenverwaltete Verschlüsselungsschlüssel (CMEKs) in Cloud KMS mit CMEK-integrierten Diensten wie Cloud Scheduler verwenden. Mit Cloud KMS-Schlüsseln haben Sie die Kontrolle über Schutzlevel, Speicherort, Rotationszeitplan, Nutzungs- und Zugriffsberechtigungen sowie über kryptografische Grenzen. Mit Cloud KMS können Sie außerdem Audit-Logs aufrufen und den Lebenszyklus von Schlüsseln steuern. Statt es Google zu überlassen, die symmetrischen Schlüsselverschlüsselungsschlüssel (Key Encryption Keys, KEKs) zum Schutz Ihrer Daten zu besitzen und zu verwalten, können Sie diese auch über Cloud KMS steuern und verwalten.
Nachdem Sie Ihre Ressourcen mit CMEKs eingerichtet haben, ähnelt der Zugriff auf Ihre Cloud Scheduler-Ressourcen der Verwendung der standardmäßigen Google-Verschlüsselung. Weitere Informationen zu Ihren Verschlüsselungsoptionen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel (CMEK).
Mit CMEK geschützte Inhalte
Sie können einen Cloud KMS-Schlüssel pro Google Cloud -Projekt und pro unterstützter Cloud Scheduler-Region angeben. Dieser Schlüssel wird verwendet, um die folgenden Daten in diesem Projekt und dieser Region zu schützen:
- Jobs mit einem HTTP- oder HTTPS-Endpunktziel: der HTTP-Anfragetext und die Kundenheader.
- Jobs mit einem Pub/Sub-Thema als Ziel: die Pub/Sub-Nachrichtennutzlast und -attribute.
Hinweis
Führen Sie die folgenden erforderlichen Schritte aus, bevor Sie CMEK in Cloud Scheduler verwenden.
Aktualisieren Sie die
gcloud-Komponenten:gcloud components update
Melde dich mit deinem Konto an.
gcloud auth login
Aktivieren Sie die Cloud KMS API für das Projekt, in dem Ihre Verschlüsselungsschlüssel gespeichert werden:
gcloud services enable cloudkms.googleapis.com \ --project=KMS_PROJECT_ID
Ersetzen Sie
KMS_PROJECT_IDdurch die ID des Projekts, in dem Ihre Cloud KMS-Schlüssel gespeichert sind. Dies kann dasselbe Projekt wie Ihre Cloud Scheduler-Jobs oder ein separates Projekt sein.Cloud KMS erstellt Cloud-Audit-Logs, wenn Schlüssel aktiviert, deaktiviert oder von Cloud Scheduler-Ressourcen zum Verschlüsseln und Entschlüsseln von Daten verwendet werden.
Achten Sie darauf, dass für die Cloud KMS API in Ihrem Projekt Logging aktiviert ist und dass Sie entschieden haben, welche Logging-spezifischen Berechtigungen und Rollen für Ihren Anwendungsfall gelten. Weitere Informationen finden Sie unter Audit-Logging in Cloud KMS.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von CMEK für Cloud Scheduler benötigen:
-
Gewähren Sie dem Dienst-Agent Zugriff auf den Schlüssel:
Cloud KMS-Administrator (
roles/cloudkms.admin) für den Schlüssel, den Schlüsselbund oder das Projekt, das den Cloud KMS-Schlüssel enthält. -
CMEK aktivieren oder deaktivieren:
Cloud Scheduler-Administrator (
roles/cloudscheduler.admin) für das Cloud Scheduler-Projekt -
Rufen Sie die CMEK-Konfiguration oder den Vorgangsstatus auf:
- Cloud Scheduler-Betrachter (
roles/cloudscheduler.viewer) für das Cloud Scheduler-Projekt - Cloud Scheduler-Administrator (
roles/cloudscheduler.admin) für das Cloud Scheduler-Projekt
- Cloud Scheduler-Betrachter (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Konfigurieren von CMEK für Cloud Scheduler erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um CMEK für Cloud Scheduler zu konfigurieren:
-
Gewähren Sie dem Dienst-Agent Zugriff auf den Schlüssel:
cloudkms.cryptoKeys.setIamPolicyfür den Schlüssel, den Schlüsselbund oder das Projekt, das den Cloud KMS-Schlüssel enthält. -
Aktivieren oder deaktivieren Sie CMEK:
cloudscheduler.cmekConfig.updatefür das Cloud Scheduler-Projekt -
CMEK-Konfiguration oder -Vorgangsstatus ansehen:
-
cloudscheduler.cmekConfig.getfür das Cloud Scheduler-Projekt -
cloudscheduler.operations.getfür das Cloud Scheduler-Projekt
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Cloud KMS-Schlüsselbund und -Schlüssel erstellen
Sie können einen neuen Schlüsselbund erstellen oder einen vorhandenen verwenden. Sie können dem Schlüsselbund einen neuen Schlüssel hinzufügen oder einen vorhandenen Schlüssel verwenden. Wir empfehlen, für verschiedene Anwendungen, Dienste oder Umgebungen unterschiedliche Schlüssel zu verwenden.
Schlüssel erstellen Der Schlüssel muss den symmetrischen Verschlüsselungsalgorithmus verwenden.
Cloud Scheduler-Dienst-Agent Zugriff auf den Schlüssel gewähren
Sie müssen dem Cloud Scheduler-Dienst-Agenten die IAM-Rolle (Identity and Access Management) Cloud KMS CryptoKey Encrypter/Decrypter zuweisen, damit er auf den Cloud KMS-Schlüssel zugreifen kann. Wenn Sie die Cloud Scheduler API vor Kurzem in einem Projekt aktiviert und noch keine Jobs erstellt haben, müssen Sie möglicherweise zuerst den Dienst-Agent erstellen. Führen Sie dazu gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID aus.
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.iam.gserviceaccount.com \ --role=roles/cloudkms.cryptoKeyEncrypterDecrypter
Ersetzen Sie Folgendes:
KEY_NAME: der Name des Schlüssels, z. B.my-key.KEY_RING: der Name des Schlüsselbunds, z. B.my-keyring.LOCATION: Der Speicherort des Schlüssels, z. B.us-central1.KMS_PROJECT_ID: die ID des Projekts, in dem sich der Cloud KMS-Schlüssel befindet.PROJECT_NUMBER: die Projektnummer Ihres Cloud Scheduler-Projekts in Google Cloud . Sie finden Ihre Projektnummer auf der Willkommensseite der Google Cloud Console oder durch Ausführen des folgenden Befehls:export PROJECT=$(gcloud info --format='value(config.project)') gcloud projects describe ${PROJECT} --format="value(projectNumber)"
Solange der Dienst-Agent die Rolle roles/cloudkms.cryptoKeyEncrypterDecrypter hat, kann ein Job in Ihrem Projekt seine Daten mit dem CMEK-Schlüssel verschlüsseln und entschlüsseln. Wenn Sie diese Rolle widerrufen oder den CMEK-Schlüssel deaktivieren oder löschen, kann auf diese Daten nicht zugegriffen werden. Weitere Informationen finden Sie in diesem Dokument unter Cloud KMS entfernen.
CMEK für eine Cloud Scheduler-Region aktivieren
Geben Sie den Cloud KMS-Schlüssel an, der für die Datenverschlüsselung in einer Cloud Scheduler-Region verwendet werden soll. Verwenden Sie dazu den Befehl 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
Ersetzen Sie Folgendes:
LOCATION: eine unterstützte Cloud Scheduler-Region.KEY_NAME: der Name des Schlüssels, z. B.my-key.KEY_RING: der Name des Schlüsselbunds, z. B.my-keyring.KMS_PROJECT_ID: die ID des Projekts, in dem sich der Cloud KMS-Schlüssel befindet, den Sie verwenden möchten.
Wichtige Hinweise:
- Das Aktivieren, Ändern oder Deaktivieren eines CMEK-Schlüssels in Cloud Scheduler erfolgt asynchron und gibt einen Vorgang mit langer Ausführungszeit (
projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID) zurück. Sie können mit dem Befehlgcloud scheduler operations describeprüfen, ob die Aktualisierung abgeschlossen ist. - Cloud Scheduler verschlüsselt neue und aktualisierte Jobs im geschützten Projekt und in der geschützten Region mit dem aktivierten Schlüssel. Vorhandene Jobs, die zuvor mit einem früheren Schlüssel verschlüsselt wurden, werden mit dem neuen Schlüssel neu verschlüsselt.
- Vorhandene ungeschützte Jobs werden verschlüsselt.
- Durch das Rotieren eines Schlüssels in Cloud KMS werden vorhandene Jobs nicht automatisch neu verschlüsselt und neue Jobs in der Region werden nicht auf die neue Primärschlüsselversion umgestellt. Weitere Informationen finden Sie unter CMEK-Schlüsselrotation.
- Wenn Sie CMEK für eine Region deaktivieren, werden vorhandene Jobs mit der standardmäßigen Google-Verschlüsselung verschlüsselt und nachfolgende Jobs ohne CMEK-Verschlüsselung erstellt. Weitere Informationen finden Sie in diesem Dokument unter CMEK für eine Cloud Scheduler-Region deaktivieren.
Cloud KMS-Konfiguration prüfen
Prüfen Sie, ob CMEK aktiviert ist, indem Sie die CMEK-Konfiguration für eine Cloud Scheduler-Region mit dem Befehl gcloud scheduler cmek-config describe abrufen:
gcloud scheduler cmek-config describe \ --location=LOCATION
Die Ausgabe sieht etwa so aus:
kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME name: projects/PROJECT_ID/locations/LOCATION/cmekConfig
Der Wert kmsKeyName ist die Ressourcen-ID des Cloud KMS-Schlüssels, der zum Sichern der Jobs in der Region verwendet wird.
CMEK für eine Cloud Scheduler-Region deaktivieren
Sie können CMEK für eine Cloud Scheduler-Region deaktivieren, sodass alle in dieser Region erstellten Jobs ohne CMEK-Verschlüsselung erstellt werden.
gcloud scheduler cmek-config update \ --location=LOCATION \ --clear-kms-key
Dadurch wird CMEK für die jeweilige Region deaktiviert und alle nachfolgenden Jobs werden ohne CMEK-Verschlüsselung erstellt. Vorhandene Jobs werden mit der standardmäßigen Google-Verschlüsselung verschlüsselt.
Cloud KMS entfernen
Wenn Sie den Datenzugriff auf Ihre Jobs widerrufen möchten, können Sie Cloud KMS auf eine der folgenden Arten entfernen:
Deaktivieren oder löschen Sie die entsprechende Schlüsselversion Ihres kundenverwalteten Verschlüsselungsschlüssels. Sie können prüfen, ob eine Schlüsselversion verwendet wird. Wenn Sie eine CMEK-Schlüsselversion deaktivieren, wird der Zugriff auf alle Daten, die durch diese Schlüsselversion geschützt sind, ausgesetzt, bis der Schlüssel wieder aktiviert wird. Durch das Löschen einer Schlüsselversion wird der Zugriff dauerhaft blockiert und es kann zu einem nicht wiederherstellbaren Datenverlust kommen. Beide wirken sich nur auf die Jobs aus, die mit der spezifischen Schlüsselversion verknüpft sind.
Sie können die Ressourcen, die durch die deaktivierte oder gelöschte Schlüsselversion geschützt sind, nicht ansehen. Alle aktiven Jobausführungen schlagen mit einer entsprechenden Fehlermeldung fehl.
Widerrufen Sie die IAM-Rolle
roles/cloudkms.cryptoKeyEncrypterDecrypterfür den Cloud Scheduler-Dienst-Agent. Dies betrifft alle Jobs im spezifischen Projekt und in der spezifischen Region vonGoogle Cloud , die die Verschlüsselung mit CMEK unterstützen. Sie können keine neuen CMEK-integrierten Jobs erstellen und keine CMEK-verschlüsselten Jobs ansehen oder auflisten. Sie können sie jedoch weiterhin löschen. Alle aktiven Jobausführungen schlagen mit einer entsprechenden Fehlermeldung fehl.
Obwohl keiner dieser Vorgänge eine sofortige Zugriffssperre bietet, werden IAM-Änderungen im Allgemeinen schneller übernommen. Weitere Informationen finden Sie unter Konsistenz von Cloud KMS-Ressourcen und Weitergabe von Zugriffsänderungen.
Informationen zu CMEK-Organisationsrichtlinieneinschränkungen
Cloud Scheduler unterstützt die folgenden Einschränkungen für Organisationsrichtlinien, mit denen Sie die CMEK-Nutzung in einer Organisation erzwingen können:
constraints/gcp.restrictNonCmekServices: Mit dieser Einschränkung können Sie festlegen, dass CMEKs zum Schutz aller neuen Cloud Scheduler-Ressourcen in einer Organisation, einem Ordner oder einem Projekt verwendet werden müssen.Wenn diese Organisationsrichtlinie aktiv ist, können Ressourcen nur erstellt oder aktualisiert werden, wenn Sie zuerst einen Cloud KMS-Schlüssel aktivieren. Sie können CMEK auch nicht für eine Cloud Scheduler-Region deaktivieren.
constraints/gcp.restrictCmekCryptoKeyProjects: Verwenden Sie diese Einschränkung, um sicherzustellen, dass Ihre CMEK-geschützten Cloud Scheduler-Ressourcen einen Schlüssel aus einem genehmigten Projekt verwenden.Sie können beispielsweise eine Regel wie die folgende angeben: „Für alle Cloud Scheduler-Ressourcen in
projects/my-company-data-projectmuss der in diesem Projekt verwendete Cloud KMS-Schlüssel ausprojects/my-company-central-keysODERprojects/team-specific-keysstammen.“
Wichtige Hinweise:
Nachdem Sie eine CMEK-Organisationsrichtlinie angewendet haben, können Sie weiterhin auf vorhandene Jobs zugreifen, die die standardmäßige Google-Verschlüsselung verwenden. Sie können sie jedoch erst aktualisieren, wenn Sie einen zulässigen Cloud KMS-Schlüssel für die Cloud Scheduler-Region konfiguriert haben.
Jobs, die auf eine App Engine-Anwendung ausgerichtet sind, unterliegen nicht den CMEK-Organisationsrichtlinien. Wenn Sie beispielsweise die Einschränkung
constraints/gcp.restrictNonCmekServicesfestlegen, können Sie trotzdem einen Job erstellen oder aktualisieren, der auf eine App Engine-Anwendung abzielt.
Weitere Informationen zum Konfigurieren von Organisationsrichtlinien finden Sie unter CMEK-Organisationsrichtlinien.
Fehlerbehebung
Bei der Verwendung von Cloud KMS mit Cloud Scheduler können Fehler auftreten. In der folgenden Tabelle werden verschiedene Probleme und deren Behebung beschrieben.
| Problem | Beschreibung |
|---|---|
Berechtigung cloudkms.cryptoKeyVersions.useToEncrypt wurde verweigert |
Entweder ist der angegebene Cloud KMS-Schlüssel nicht vorhanden oder die Berechtigung ist nicht ordnungsgemäß konfiguriert. Lösung:
|
| Schlüsselversion ist nicht aktiviert |
Die bereitgestellte Cloud KMS-Schlüsselversion wurde deaktiviert. Lösung: Aktivieren Sie die Cloud KMS-Schlüsselversion wieder. |
| Die Region des Schlüsselbunds stimmt nicht mit der zu schützenden Ressource überein |
Die Region des bereitgestellten Cloud KMS-Schlüsselbunds unterscheidet sich von der geschützten Cloud Scheduler-Region. Lösung: Verwenden Sie einen Cloud KMS-Schlüsselbund aus derselben Region wie die Cloud Scheduler-Region. Der Schlüsselbund kann sich in einem anderen Projekt befinden. Weitere Informationen finden Sie unter Cloud KMS-Standorte und Cloud Scheduler-Standorte. |
| Das Projekt ist nicht mit CMEK in Cloud Scheduler kompatibel |
Die Aktivierung von CMEK schlägt mit dem Fehler Lösung:
|
Audit-Logging
Cloud KMS erstellt Audit-Logs, wenn Schlüssel aktiviert, deaktiviert oder von Cloud Scheduler-Ressourcen zum Verschlüsseln und Entschlüsseln von Nachrichten verwendet werden. Weitere Informationen finden Sie unter Audit-Logging in Cloud KMS.
Cloud EKM-Fehler
Informationen zur Behebung von Problemen, die bei der Verwendung extern verwalteter Schlüssel über Cloud External Key Manager (Cloud EKM) auftreten können, finden Sie in der Cloud EKM-Fehlerreferenz.
Schlüsselstatus nicht verfügbar
Wenn Cloud KMS aus irgendeinem Grund nicht verfügbar ist, kann Cloud Scheduler den Status Ihres Schlüssels möglicherweise nicht von Cloud KMS abrufen.
Wenn Cloud KMS nicht verfügbar ist, wenn ein Job ausgeführt werden soll, kann Cloud Scheduler die Jobdaten nicht entschlüsseln oder das Ziel des Jobs nicht aufrufen.
Bei vorübergehenden Cloud KMS-Fehlern (z. B. UNAVAILABLE, RESOURCE_EXHAUSTED oder ein nicht erreichbarer Cloud EKM-Schlüssel) wiederholt Cloud Scheduler die Entschlüsselung intern mit exponentiellem Backoff und protokolliert CmekRetryFailure Logeinträge in Cloud Logging unter cloudscheduler.googleapis.com/cmek. Bei nicht wiederholbaren Fehlern, z. B. einem Berechtigungsfehler oder einem deaktivierten oder gelöschten Schlüssel, schlägt die Entschlüsselung sofort fehl, ohne dass das Ziel aufgerufen wird.
Cloud KMS-Kontingente
Wenn Sie CMEK in Cloud Scheduler verwenden, können Ihre Projekte Kontingente für kryptografische Cloud KMS-Anfragen verbrauchen. Cloud Scheduler kann diese Kontingente beispielsweise beim Ausführen von Jobs, beim Verarbeiten von Jobverwaltungsanfragen oder beim Aktualisieren der CMEK-Konfiguration nutzen. Cloud Scheduler verwendet einen im Cache gespeicherten Zwischenschlüssel bis zu fünf Minuten lang pro Projekt und Region wieder, sodass häufige Jobausführungen nicht jeweils Kontingent verbrauchen. Ver- und Entschlüsselungsvorgänge über CMEK-Schlüssel wirken sich nur dann auf Cloud KMS-Kontingente aus, wenn Sie Hardware- (Cloud HSM) oder externe Schlüssel (Cloud EKM) verwenden. Weitere Informationen finden Sie unter Cloud KMS-Kontingente.Preise
Durch diese Einbindung entstehen keine zusätzlichen Kosten über die Cloud KMS-Schlüsselvorgänge hinaus, die Ihrem Google Cloud -Projekt in Rechnung gestellt werden.
Zugrunde liegende Lieferressourcen, die Ihren Schlüssel über Schlüsselgewährungen verwenden, können zusätzliche Cloud KMS-Vorgänge ausführen. Um die Cloud KMS-Nutzung für direkte Cloud Scheduler-Vorgänge zu schätzen, können Sie die folgenden kryptografischen Vorgangsraten pro Projekt und Region erwarten:
- Jobausführungen: Cloud Scheduler verwendet einen im Cache gespeicherten Zwischenschlüssel bis zu fünf Minuten lang pro Projekt und Region wieder. In Projekten mit weniger als einer Jobausführung alle fünf Minuten wird pro Ausführung etwa ein Cloud KMS-Entschlüsselungsvorgang ausgeführt. Bei Projekten mit häufigeren Ausführungen wird etwa alle fünf Minuten ein Entschlüsselungsvorgang in der Region ausgeführt.
- Vorgänge zur Jobverwaltung: Für Anfragen zum Erstellen, Aktualisieren, Abrufen, Auflisten, Pausieren oder Fortsetzen von Jobs mit geschützten Daten wird bis zu fünf Minuten lang pro Projekt und Region ein separater zwischengespeicherter Zwischenschlüssel verwendet.
- Aktualisierungen der CMEK-Konfiguration: Wenn Sie einen CMEK-Schlüssel mit
cmek-configaktivieren oder ändern, werden zusätzliche Cloud KMS-Schlüsselvorgänge ausgeführt, um den Schlüssel zu validieren und vorhandene geschützte Jobs in der Region neu zu verschlüsseln. Wenn Sie CMEK deaktivieren, werden vorhandene geschützte Jobs wieder mit der standardmäßigen Google-Verschlüsselung entschlüsselt.
Preisinformationen finden Sie unter Cloud KMS – Preise.