Einrichten Ihrer Vault Dedicated-Instanz
In diesem Tutorial erfahren Sie, wie Sie eine Vault Dedicated Plan-Instanz von IBM Cloud® Secrets Manager einrichten, indem Sie die Instanz bereitstellen, ihre Endpunkte abrufen, ein Admin-Token generieren und sich zur Erstkonfiguration
bei der Vault-Benutzeroberfläche anmelden.
Der Plan Vault Dedicated stellt Vault Enterprise als Managed Service in IBM Cloud bereit. Nachdem Ihre Instanz bereitgestellt wurde, können Sie über das Instanz-Dashboard die Verbindungsdaten abrufen und die Vault-Benutzeroberfläche
öffnen, um mit der Konfiguration Ihrer Vault-Umgebung zu beginnen.
Der Vault Dedicated-Tarif ist derzeit als öffentliche Beta-Version verfügbar. Beta-Funktionen werden zu Evaluierungs- und Testzwecken bereitgestellt und weisen im Vergleich zu allgemein verfügbaren Funktionen Einschränkungen auf.
Einschränkungen der öffentlichen Beta-Version von Vault Dedicated
Während der öffentlichen Beta-Phase gelten für den Tarif Vault Dedicated die folgenden vorübergehenden Einschränkungen:
- Instanzbegrenzung: Während der Beta-Phase ist pro Konto nur eine Vault Dedicated-Instanz zulässig.
- Kein Upgrade-Pfad: Ein Upgrade von der Beta-Version auf die GA-Version ist nicht möglich. Alle Beta-Instanzen werden vor der allgemeinen Verfügbarkeit gelöscht.
- Regionale Verfügbarkeit: Verfügbar in Dallas und Frankfurt.
- Kostenlos während der Beta-Phase: Während der Beta-Phase fallen keine Kosten an.
- Migration von der Beta- zur GA-Version: Die Datenmigration von Beta-Instanzen zu GA-Instanzen wird nicht unterstützt.
Diese Einschränkungen sind vorübergehend und gelten nur während der öffentlichen Beta-Phase. Sie werden entfernt oder geändert, sobald der Plan Vault Dedicated allgemein verfügbar ist.
Vorbereitende Schritte
Bevor Sie beginnen, stellen Sie sicher, dass Sie über ein IBM Cloud-Konto und die erforderlichen IAM-Zugriffsrechte verfügen, um mit dem Dienst arbeiten zu können.
Sie benötigen die folgenden Rollen:
- Die Manager-Service-Rolle zum Bereitstellen einer Instanz und zum Generieren eines Admin-Tokens.
- Die Service-Rolle Writer, Reader oder Viewer, um Instanzdetails anzuzeigen.
Eine Instanz des Vault Dedicated-Tarifs bereitstellen
Erstellen Sie eine Vault Dedicated Plan-Instanz aus dem Katalog IBM Cloud.
-
Wechseln Sie in der IBM Cloud-Konsole zum Katalog.
-
Wählen Sie Secrets Manager aus.
-
Wählen Sie den Vault Dedicated-Tarif.
-
Konfigurieren Sie die Instanz:
- Wählen Sie eine Bereitstellungsregion aus.
- Geben Sie einen eindeutigen Instanznamen ein.
- Wählen Sie eine Ressourcengruppe aus.
- Wählen Sie mithilfe von Key Protect entweder die vom Dienst verwaltete Verschlüsselung oder die vom Kunden verwaltete Verschlüsselung aus.
- Wählen Sie ausschließlich private Endpunkte aus oder aktivieren Sie bei Bedarf einen öffentlichen Endpunkt.
Wenn Sie ausschließlich private Endpunkte auswählen, beachten Sie bitte die folgenden Anforderungen, bevor Sie versuchen, eine Verbindung herzustellen:
- API-Zugriff: Sie müssen ein VPE-Gateway (Virtual Private Endpoint) erstellen, das auf Ihre Vault Dedicated-Instanz verweist. Cloud Service Endpoints (CSE) werden für diesen Tarif nicht unterstützt. Siehe Verwendung von Service-Endpunkten für eine private Verbindung zu Secrets Manager.
- Zugriff auf die Vault-Benutzeroberfläche: Sie müssen ein Client-to-Site-VPN verwenden, das den Datenverkehr über die VPE leitet. Die Benutzeroberfläche des privaten Vaults unter URL ist ohne VPN von einem Browser außerhalb des privaten Netzwerks IBM Cloud nicht erreichbar. Siehe Verwendung eines Client-to-Site-VPN für eine private Verbindung zu Secrets Manager.
Wenn Sie vorhaben, sowohl als auch
StandardVault DedicatedPlan-Instanzen zu verwenden, sollten Sie eine Namenskonvention wählen, die den Instanztyp leicht erkennbar macht, beispielsweise durch Einfügen von-standardoder in-vault dedicatedden Instanznamen. -
Klicken Sie auf Erstellen.
Die Bereitstellung ist in der Regel innerhalb weniger Minuten abgeschlossen, kann jedoch bis zu 15 Minuten dauern.
Weitere Informationen zur Bereitstellung einer Instanz finden Sie unter Erstellen einer Instanz.
Ein Admin-Token generieren
Um für die Erstkonfiguration auf die Vault-Benutzeroberfläche zuzugreifen, generieren Sie ein Admin-Token.
Admin-Token sind ausschließlich für die Ersteinrichtung und den Notfallzugriff vorgesehen. Widerrufen Sie diese, sobald Sie Ihre Einrichtungsaufgaben abgeschlossen haben.
Erstellen eines Admin-Tokens in der Benutzeroberfläche
- Klicken Sie im Dashboard Ihrer Secrets Manager-Instanz im Abschnitt Neues Admin-Token erstellen auf Token erstellen.
- Kopieren Sie das generierte Admin-Token und bewahren Sie es sicher auf. Sie benötigen dieses Token, um sich bei der Vault-Benutzeroberfläche anzumelden.
Erstellen eines Admin-Tokens über die CLI
Um mithilfe der IBM Cloud-CLI ein neues Vault-Admin-Token zu generieren, führen Sie den folgenden Befehl aus.
ibmcloud secrets-manager-instance-management admin-token-create --id {instance_id}
Der Befehl gibt das Vault-Admin-Token zurück. Bewahren Sie es sicher auf – Sie benötigen dieses Token, um sich bei der Vault-Benutzeroberfläche anzumelden.
Erstellen eines Admin-Tokens mit der API
curl -X POST \
-H "Authorization: Bearer {iam_token}" \
-H "Accept: application/json" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Eine erfolgreiche Anfrage gibt HTTP zurück 201 Created. Die Antwort enthält ein einziges token Feld – speichern Sie es sicher und verwenden Sie es, um sich bei der Vault-Benutzeroberfläche anzumelden. Das Token ist
1 Stunde lang gültig.
Erstellen eines Admin-Tokens mit Terraform
Um mit Terraform ein Vault-Admin-Token zu generieren, verwenden Sie die Ressource ibm_sm_admin_token. Das Token ist 1 Stunde lang gültig und wird automatisch erneuert, wenn es kurz vor dem Ablauf steht.
resource "ibm_sm_admin_token" "sm_admin_token" {
instance_id = "bfc50c2e-d66d-4f37-9ccf-9713f8325b39"
}
Nachdem die Ressource erstellt wurde, ist das Vault-Admin-Token im Attribut token verfügbar.
Öffnen Sie die Vault-Benutzeroberfläche
Verwenden Sie den Vault-API-Endpunkt, um die Vault-Benutzeroberfläche zu öffnen, und melden Sie sich mit dem Admin-Token an.
- Klicken Sie im Dashboard der Secrets Manager-Instanz auf Web-UI starten, um auf die native Benutzeroberfläche von Vault zuzugreifen.
- Verwenden Sie auf der Vault-Anmeldeseite das von Ihnen erstellte Admin-Token und schließen Sie die Erstkonfiguration von Vault ab.
Das Admin-Token widerrufen
Nachdem Sie die Ersteinrichtung abgeschlossen haben, widerrufen Sie alle aktiven Admin-Token, um das Risiko eines unbeabsichtigten Zugriffs zu verringern.
Admin-Token in der Benutzeroberfläche widerrufen
- Klicken Sie im Dashboard Ihrer Secrets Manager-Instanz im Abschnitt Alle Admin-Token widerrufen auf Widerrufen.
- Bestätigen Sie den Widerruf, wenn Sie dazu aufgefordert werden.
Durch das Widerrufen des Tokens wird dieses sofort ungültig gemacht, wodurch das Risiko eines unbeabsichtigten Zugriffs verringert wird.
Admin-Token über die CLI widerrufen
Um alle aktiven Vault-Administrator-Token mithilfe der IBM Cloud-CLI zu widerrufen, führen Sie den folgenden Befehl aus.
ibmcloud secrets-manager-instance-management admin-tokens-delete --id {instance_id}
Dieser Vorgang macht alle Admin-Token sofort ungültig, sodass für den zukünftigen administrativen Zugriff neue Token generiert werden müssen.
Admin-Token über die API widerrufen
curl -X DELETE \
-H "Authorization: Bearer {iam_token}" \
"https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"
Bei einer erfolgreichen Sperrung wird ein 204 No Content Statuscode zurückgegeben.
Nächste Schritte
Nachdem Sie sich bei Vault angemeldet haben, können Sie mit der Erstkonfiguration Ihrer Instanz fortfahren.
- Informationen zum Konfigurieren von Authentifizierungsmethoden für Ihre Teams und Anwendungen finden Sie unter Authentifizierungsmethoden konfigurieren.
- Informationen zur Integration in Ihre Apps mithilfe der Vault-API, der CLI oder der SDKs finden Sie unter Integration in Ihre Apps.
- Einen Überblick über die Funktionen der Vault-API und der CLI finden Sie in der API- und CLI-Referenzübersicht.