Test- und Standard-Tarife

Die [Test- und Standard] -Tarife{: tag-blue} sind in den folgenden Regionen verfügbar.

Vault Dedicated-Tarif

Vault Dedicated ist in den folgenden Regionen verfügbar.

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.

Service-Endpunkte für die Tarife Trial und Standard

Wenn Sie Ihre Secrets Manager-Ressourcen verwalten möchten, entnehmen Sie der folgenden Tabelle die API-Endpunkte, die Sie bei der Verbindung mit der Secrets Manager-API verwenden müssen.

Wenn Sie erfahren möchten, wie Sie Ihre Secrets Manager-Instanz für die Verwendung privater Endpunkte konfigurieren, lesen Sie die Informationen im Abschnitt Verbindung zu Secrets Manager schützen.

Sind Sie bereit, die APIs auszuprobieren? Für die Interaktion mit einer Swagger-Benutzerschnittstelle über Ihren Browser fügen Sie api/v2/swagger-ui zur Serviceendpunkt-URL hinzu. Beispiel: https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui.

Service-Endpunkte für den Vault Dedicated-Tarif

Der [Vault Dedicated] -Tarif{: tag-green} stellt pro Instanz zwei private Endpunkt-URLs bereit: eine für die Vault-API und eine für die Vault-Benutzeroberfläche. Beide sind ausschließlich über ein VPE-Gateway zugänglich – Cloud Service Endpoints (CSE) werden für diesen Tarif nicht unterstützt.

Ersetzen Sie {instance_ID} durch die UUID Ihrer Instanz und {region} durch die Abkürzung der Region, zum Beispiel us-south oder eu-de.

Wenn Ihre Instanz mit ausschließlich privaten Endpunkten konfiguriert ist, gelten die folgenden Zugriffsanforderungen:

• API-Zugriff: Erfordert ein VPE-Gateway, das auf Ihre Vault Dedicated-Instanz ausgerichtet ist. Anweisungen zur Einrichtung finden Sie unter Verwendung von Service-Endpunkten für eine private Verbindung zu Secrets Manager.
• Zugriff auf die Vault-Benutzeroberfläche: Erfordert ein Client-to-Site-VPN, das den Datenverkehr über die VPE leitet. Ein Browser kann die private Vault-Benutzeroberfläche URL nicht direkt von außerhalb des privaten Netzwerks IBM Cloud aufrufen. Anweisungen zur Einrichtung finden Sie unter Verwenden eines Client-to-Site-VPN für eine private Verbindung zu Secrets Manager.

Wenn Ihre Instanz mit öffentlichen und privaten Endpunkten konfiguriert ist, sind die Vault-API und die Vault-Benutzeroberfläche über das öffentliche Internet ohne VPE oder VPN erreichbar. Die URLs der privaten Endpunkte sind ebenfalls verfügbar, ihre Nutzung erfordert jedoch nach wie vor ein VPE-Gateway (sowie ein Client-to-Site-VPN für den Zugriff auf die Vault-Benutzeroberfläche), genau wie oben für rein private Instanzen beschrieben.

Die genauen Endpunkt-URLs für Ihre Instanz können Sie auf der Seite Endpunkte der Benutzeroberfläche von Secrets Manager abrufen oder durch Aufruf der API für Instanzdetails ermitteln.

Endpunkt-URLs anzeigen

Ihre Serviceendpunkt-URLs finden Sie auf der Seite Endpunkte der Secrets Manager-Benutzerschnittstelle.

Der Endpunkt der privaten Steuerungsebene ist über ein VPE-Gateway zugänglich. Weitere Informationen finden Sie im Abschnitt zur Verwendung von Serviceendpunkten zum Herstellen einer privaten Verbindung zu Secrets Manager. Wenn Sie Ihre Serviceendpunkt-URLs über das Programm abrufen müssen, können Sie auch die folgende API aufrufen, um die Werte abzurufen, die für Ihre Secrets Manager-Instanz spezifisch sind.

curl -X GET  
    -H "Accept: application/json" \
    -H "Authorization: Bearer {IAM_token}"
"https://{region}.secrets-manager.cloud.ibm.com/api/v1/instances/{url_encoded_instance_CRN}/endpoints"

Ersetzen Sie die Variablen in der Beispielanforderung entsprechend der folgenden Tabelle.

Eine erfolgreiche Anforderung gibt die Endpunkt-URLs zurück, die der Region und dem Serviceinstanz-CRN zugeordnet sind, die Sie angeben. Das folgende JSON-Snippet zeigt eine Beispielantwort.

{
    "plan": "standard",
    "public_endpoints": {
        "service_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.us-south.secrets-manager.appdomain.cloud/api",
        "vault_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.us-south.secrets-manager.appdomain.cloud"
    },
    "private_endpoints": {
        "service_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc1234.private.us-south.secrets-manager.appdomain.cloud/api",
        "vault_api": "https://927fb8ae-1ddd-4483-a21f-7d3c0fc81234.private.us-south.secrets-manager.appdomain.cloud"
    },
    "encryption": {
      "provider_managed_encryption": "key_protect",  
      "encryption_key_crn": "crn:v1:staging:public:kms:us-south:a/791f5fb10986423e97aa8512f181234:31639268-42e8-4420-9872-590a6ee21234:key:b4af8f76-e6ea-4dc5-89cc-5f1b9bb1234"
    }
}

Endpunkte der Steuerungsebene

Verwenden Sie die folgenden Steuerebenen-Endpunkte, um APIs der Steuerebene aufzurufen.

Der Endpunkt der privaten Steuerungsebene ist über ein VPE-Gateway zugänglich. Weitere Informationen finden Sie im Abschnitt zur Verwendung von Serviceendpunkten zum Herstellen einer privaten Verbindung zu Secrets Manager.

Zum Testen dieser API können Sie über Ihren Browser mit der folgenden Swagger-Benutzerschnittstelle interagieren: https://{region}.secrets-manager.cloud.ibm.com/swagger-ui.

Wenn Ihre Instanz mit der Option Nur privat konfiguriert ist, gibt diese API in der Antwort nur das Objekt private_endpoints zurück.