In diesem Thema wird beschrieben, wie Sie ein Secret erstellen. Ein Secret enthält ein oder mehrere Secrets Versionen zusammen mit Metadaten wie Labels und Replikationsinformationen. Die Der eigentliche Secret-Inhalt wird in einer Secret-Version gespeichert.
Hinweise
- Aktivieren Sie die Secret Manager API einmal pro Projekt.
- Weisen Sie die Secret Manager-Administratorrolle (
roles/secretmanager.admin
) für das Projekt, den Ordner oder die Organisation zu. Authentifizieren Sie sich bei der Secret Manager API auf eine der folgenden Arten:
- Wenn Sie Clientbibliotheken zum 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 für die Authentifizierung Ihre Google Cloud CLI-Anmeldedaten.
- Verwenden Sie zum Authentifizieren eines REST-Aufrufs entweder Google Cloud CLI-Anmeldedaten oder 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 beliebiges Format haben, darf aber nicht größer als 64 KiB sein. Sie können auch eine Textdatei mit dem Secret-Wert hochladen: die Option Datei hochladen. -
Klicken Sie auf Secret erstellen.
gcloud
Wenn Sie Secret Manager in der Befehlszeile verwenden möchten, Installieren Sie die Google Cloud CLI oder führen Sie ein Upgrade auf Version 378.0.0 oder höher durch. 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 versioniert Secret-Daten automatisch mithilfe von Secret-Versionen und die meisten
Vorgänge wie Zugriff, Löschen, Deaktivieren und Aktivieren laufen in einer Secret-Version ab.
Mit Secret Manager können Sie ein Secret an bestimmte Versionen wie 42
oder Floating anheften
Aliasnamen wie latest
. Weitere Informationen zum Hinzufügen einer Secret-Version
Auf Secret-Version zugreifen
Um auf die Secret-Daten einer bestimmten Secret-Version für eine erfolgreiche Authentifizierung zuzugreifen, Siehe Auf Secret-Version zugreifen.
Nächste Schritte
- Replikationsrichtlinie auswählen
- Zugriff auf Secrets verwalten
- Weitere Informationen zum Einrichten von Benachrichtigungen für Secrets