In diesem Thema wird beschrieben, wie Sie ein Secret erstellen. Ein Secret enthält eine oder mehrere Secret-Versionen sowie Metadaten wie Labels und Replikationsinformationen. Der tatsächliche Inhalt eines Secrets wird in einer Secret-Version gespeichert.
Hinweise
- Aktivieren Sie die Secret Manager API einmal pro Projekt.
- Weisen Sie dem Projekt, dem Ordner oder der Organisation die Rolle „Secret Manager-Administrator“ (
roles/secretmanager.admin
) zu. Authentifizieren Sie sich bei der Secret Manager API auf eine der folgenden Arten:
- Wenn Sie Clientbibliotheken für den Zugriff auf die Secret Manager API verwenden, richten Sie Standardanmeldedaten für Anwendungen ein.
- Wenn Sie über die Google Cloud CLI auf die Secret Manager API zugreifen, verwenden Sie zur Authentifizierung Ihre Google Cloud CLI-Anmeldedaten.
- Verwenden Sie zum Authentifizieren eines REST-Aufrufs entweder die Anmeldedaten der Google Cloud CLI oder die Standardanmeldedaten für Anwendungen.
Secret erstellen
Console
-
Rufen Sie in der Google Cloud Console die Seite Secret Manager auf.
-
Klicken Sie auf der Seite Secret Manager auf Secret erstellen.
-
Geben Sie auf der Seite Secret erstellen unter Name einen Namen für das Secret ein (z. B.
my-secret
). Ein Secret-Name kann Groß- und Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten. Die maximal zulässige Länge für einen Namen beträgt 255 Zeichen. -
Optional: Wenn Sie beim Erstellen des ersten Secrets auch eine Secret-Version hinzufügen möchten, geben Sie im Feld Secret-Wert einen Wert für das Secret ein (z. B.
abcd1234
). Der Secret-Wert kann ein beliebiges Format haben, darf aber nicht größer als 64 KiB sein. -
Lassen Sie den Abschnitt Regionen unverändert.
-
Klicken Sie auf Secret erstellen.
gcloud
Wenn Sie Secret Manager in der Befehlszeile verwenden möchten, müssen Sie zuerst die Google Cloud CLI installieren oder ein Upgrade auf Version 378.0.0 oder höher ausführen. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
$ gcloud secrets create secret-id \
--replication-policy="automatic"
C#
Um diesen Code auszuführen, müssen Sie eine C#-Entwicklungsumgebung einrichten und das Secret Manager C# SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
Go
Um diesen Code auszuführen, müssen Sie zuerst eine Go-Entwicklungsumgebung einrichten und das Secret Manager Go SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
Java
Um diesen Code auszuführen, müssen Sie zuerst eine Java-Entwicklungsumgebung einrichten und das Secret Manager Java SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
Node.js
Um diesen Code auszuführen, müssen Sie zuerst eine Node.js-Entwicklungsumgebung einrichten und das Cloud KMS Node.js SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
PHP
Um diesen Code auszuführen, müssen Sie zuerst die Informationen zur Verwendung von PHP in Google Cloud und zum Installieren des Secret Manager PHP SDK lesen. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
Python
Um diesen Code auszuführen, müssen Sie zuerst eine Python-Entwicklungsumgebung einrichten und das Secret Manager Python SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
Ruby
Um diesen Code auszuführen, müssen Sie zuerst eine Ruby-Entwicklungsumgebung einrichten und das Secret Manager Ruby SDK installieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
API
In diesen Beispielen wird curl verwendet, um die Verwendung mit der API zu demonstrieren. Sie können Zugriffstokens mit gcloud auth print-access-token generieren. In Compute Engine oder GKE müssen Sie sich mit dem Bereich cloud-platform authentifizieren.
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets?secretId=secret-id" \
--request "POST" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--data "{\"replication\": {\"automatic\": {}}}"
Informationen zum Auswählen der richtigen Replikationsrichtlinie für Ihr Secret finden Sie unter Replikationsrichtlinie auswählen.
Secret-Version hinzufügen
Secret Manager erstellt eine automatische Version von Secret-Daten mit Secret-Versionen. Die meisten Vorgänge wie „Zugriff“, „Löschen“, „Deaktivieren“ und „Aktivieren“ finden auf einer Secret-Version statt.
Mit Secret Manager können Sie ein Secret an bestimmte Versionen wie 42
oder an Floating-Aliasse wie latest
anpinnen. Secret-Version hinzufügen
Auf eine Secret-Version zugreifen
Informationen zum Zugriff auf die Secret-Daten von einer bestimmten Secret-Version für eine erfolgreiche Authentifizierung finden Sie unter Auf eine Secret-Version zugreifen.
Nächste Schritte
- Replikationsrichtlinie auswählen
- Informationen zum Verwalten des Zugriffs auf Secrets
- Informationen zum Einrichten von Benachrichtigungen für ein Secret