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:

Eine Instanz des Vault Dedicated-Tarifs bereitstellen

Erstellen Sie eine Vault Dedicated Plan-Instanz aus dem Katalog IBM Cloud.

  1. Wechseln Sie in der IBM Cloud-Konsole zum Katalog.

  2. Wählen Sie Secrets Manager aus.

  3. Wählen Sie den Vault Dedicated-Tarif.

  4. 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:

    Wenn Sie vorhaben, sowohl als auch Standard Vault Dedicated Plan-Instanzen zu verwenden, sollten Sie eine Namenskonvention wählen, die den Instanztyp leicht erkennbar macht, beispielsweise durch Einfügen von -standard oder in -vault dedicated den Instanznamen.

  5. 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

  1. Klicken Sie im Dashboard Ihrer Secrets Manager-Instanz im Abschnitt Neues Admin-Token erstellen auf Token erstellen.
  2. 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.

  1. Klicken Sie im Dashboard der Secrets Manager-Instanz auf Web-UI starten, um auf die native Benutzeroberfläche von Vault zuzugreifen.
  2. 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

  1. Klicken Sie im Dashboard Ihrer Secrets Manager-Instanz im Abschnitt Alle Admin-Token widerrufen auf Widerrufen.
  2. 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.