Auf dieser Seite erfahren Sie, wie Sie Schlüsselringe und Schlüssel in Ihrer Google Cloud-Projektressource aufrufen.
Hinweise
Bevor Sie Schlüsselringe und Schlüssel aufrufen können, müssen Sie die in diesem Abschnitt beschriebenen Einrichtungsschritte ausführen.
APIs aktivieren
Wenn Sie Schlüsselringe und Schlüssel über eine API aufrufen möchten, aktivieren Sie die Cloud KMS Inventory API.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud KMS Viewer (roles/cloudkms.viewer) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie benötigen, um Schlüssel aufzurufen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von Schlüsseln erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Für das Aufrufen von Schlüsseln sind die folgenden Berechtigungen erforderlich:
-
cloudkms.keyRings.list -
cloudkms.cryptoKeys.list -
cloudkms.locations.list -
resourcemanager.projects.get
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Schlüsselringe ansehen
Console
Rufen Sie in der Google Cloud Console die Seite Schlüsselringe auf.
Optional: Wenn Sie die Liste der Schlüsselanhänger filtern möchten, geben Sie Ihre Suchbegriffe in das Feld filter_list Filter ein und drücken Sie die Eingabetaste.
Optional: Wenn Sie die Liste nach den Werten in einer Spalte sortieren möchten, klicken Sie auf die Spaltenüberschrift.
Wenn Sie sich Ihre Schlüsselringe ansehen, können Sie einen Schlüsselring auswählen, um Details zu den zugehörigen Schlüsseln und Importjobs aufzurufen.
Schlüssel ansehen
Verwenden Sie die Google Cloud Console, um die in Ihrer Projektressource erstellten Schlüssel aufzurufen.
Console
Rufen Sie in der Google Cloud Console die Seite Schlüsselinventar auf.
Optional: Wenn Sie die Liste der Schlüssel filtern möchten, geben Sie Ihre Suchbegriffe in das Feld filter_list Filter ein und drücken Sie die Eingabetaste.
Optional: Wenn Sie die Liste nach den Werten in einer Spalte sortieren möchten, klicken Sie auf die Spaltenüberschrift.
gcloud-CLI
Wenn Sie Cloud KMS in der Befehlszeile verwenden möchten, müssen Sie zuerst die neueste Version der Google Cloud CLI installieren oder ein Upgrade ausführen.
gcloud kms inventory list-keys --project PROJECT_ID
Ersetzen Sie PROJECT_ID durch den Namen des Projekts, für das Sie die Liste der Schlüssel aufrufen möchten.
Wenn Sie Informationen zu allen Flags und möglichen Werten erhalten möchten, führen Sie den Befehl mit dem Flag --help aus.
API
In diesen Beispielen wird curl als HTTP-Client verwendet, um die Verwendung der API zu demonstrieren. Weitere Informationen zur Zugriffssteuerung finden Sie unter Auf die Cloud KMS API zugreifen.
curl "https://kmsinventory.googleapis.com/v1/projects/PROJECT_ID/cryptoKeys"
--request "GET" \
--header "x-goog-user-project: CALLING_PROJECT_ID"
--header "Content-Type: application/json" \
--header "Authorization: Bearer TOKEN"Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, das den Schlüsselbund enthält.CALLING_PROJECT_ID: die ID des Projekts, von dem aus Sie die KMS Inventory API aufrufen.
Wenn Sie sich Ihre Schlüssel ansehen, können Sie einen Schlüssel auswählen, um Details zu ihm aufzurufen, einschließlich der zugehörigen Schlüsselversionen.
Wichtige Details
Das Schlüsselinventar bietet umfassende Informationen zu den kryptografischen Schlüsseln in Ihrem Projekt. Zu den Attributen im Schlüsselinventar gehören:
- Schlüsselname: Der Name des Schlüssels.
- Status: Der aktuelle Schlüsselstatus, der auf dem Status der primären Schlüsselversion basiert. Dieses Feld gilt nur für symmetrische Schlüssel.
- Verfügbar: Die Primärschlüsselversion ist aktiviert. Der Schlüssel kann zum Verschlüsseln und Entschlüsseln von Daten verwendet werden.
- Nicht verfügbar: Die Primärschlüsselversion ist deaktiviert oder leer. Der Schlüssel kann nicht zum Verschlüsseln von Daten verwendet werden.
- In der GCP verfügbar: Bei extern verwalteten Schlüsseln ist der Schlüssel (nicht unbedingt der extern verwaltete Schlüssel selbst) zur Verwendung verfügbar.
- Schlüsselbund: Name des übergeordneten Schlüsselbunds.
- Speicherort: Speicherort des Schlüsselmaterials.
- Aktuelle Rotation: Datum und Uhrzeit der letzten Schlüsselrotation. In diesem Feld sehen Sie, wann die aktuelle Schlüsselversion erstellt wurde.
- Rotationshäufigkeit: Die aktuelle Rotationshäufigkeit des Schlüssels.
- Nächste Rotation: Das Datum für die nächste geplante Schlüsselrotation. An diesem Datum wird automatisch eine neue Schlüsselversion erstellt.
- Schutzniveau: Das Schutzniveau des Schlüssels, z. B. HSM oder Software.
- EKM-über-VPC-Verbindung: Für externe Schlüssel, auf die über VPC zugegriffen wird, der Name der EKM-über-VPC-Verbindung, die der Schlüssel verwendet. Dieses Feld ist standardmäßig ausgeblendet und leer für Schlüssel mit anderen Schutzebenen als
External via VPC. - Zweck: Das Szenario, in dem der Schlüssel verwendet werden kann.
- Labels: auf den Schlüssel angewendete Labels
Beschränkungen
Auf dem Tab Schlüsselbund können pro Standort maximal 1.000 Ressourcen (einschließlich Schlüsselbündel, Schlüssel und Schlüsselversionen) angezeigt werden. Wenn Sie Schlüsselringe für ein Projekt und einen Standort mit mehr als 1.000 Ressourcen aufrufen möchten, verwenden Sie die keyRings.list API.
Auf dem Tab Schlüsselinventar können pro Projekt maximal 20.000 Ressourcen (einschließlich Schlüsselbunde, Schlüssel und Schlüsselversionen) angezeigt werden. Wenn Sie Schlüssel für ein Projekt mit mehr als 20.000 Ressourcen aufrufen möchten, verwenden Sie die keyRings.cryptoKeys.list API.