トライアルプランとスタンダードプラン

「 [Trial」および「Standard] 」の{: tag-blue} プランは、以下の地域でご利用いただけます。

Vault 専用プラン

Vault Dedicated は、以下のリージョンでご利用いただけます。

「Vault Dedicated」プランは現在、パブリックベータ版として提供されています。 ベータ版機能は、評価およびテストを目的として提供されており、一般に利用可能な機能に比べて制限があります。

トライアルプランおよびスタンダードプランのサービスエンドポイント

Secrets Manager のリソースを管理する必要がある場合は、以下の表を参照して、 Secrets Manager APIに接続する際に使用するAPIエンドポイントを特定してください。

プライベート・エンドポイントを使用するために Secrets Manager インスタンスを構成する方法は、Secrets Manager への接続の保護を参照してください。

API を試す準備はできましたか。 ブラウザーから Swagger UI と対話するには、サービス・エンドポイント URL にapi/v2/swagger-uiを追加します。 例えば、https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui です。

Vault Dedicated プランのサービスエンドポイント

Vault Dedicatedの プランでは、インスタンスごとに2つのプライベートエンドポイントURLが提供されます。1つはVault API用、もう1つはVault UI用です。 どちらもVPEゲートウェイ経由でのみアクセス可能です。このプランでは、クラウドサービスエンドポイント（CSE）はサポートされていません。

{instance_ID} を自分のインスタンスの UUID に、 {region} をリージョンの略称（例： us-south や eu-de など）に置き換えてください。

インスタンスが「 プライベート専用 」のエンドポイントで構成されている場合、以下のアクセス要件が適用されます

• API アクセス ：Vault Dedicated インスタンスを対象とする VPE ゲートウェイが必要です。 設定手順については、「 サービスエンドポイントを使用して Secrets Manager にプライベート接続する 」を参照してください。
• Vault UI へのアクセス ：トラフィックを VPE 経由でルーティングするクライアントからサイトへの VPN が必要です。 IBM Cloud のプライベートネットワーク外からは、ブラウザでプライベートVault UI（ URL ）に直接アクセスすることはできません。 設定手順については、「 クライアントからサイトへのVPNを使用して Secrets Manager にプライベート接続する 」を参照してください。

インスタンスがパブリックおよびプライベートエンドポイントで構成されている場合、VPE や VPN を使用しなくても、パブリックインターネット経由で Vault API および Vault UI にアクセスできます。 プライベートエンドポイントのURLも利用可能ですが、これらを使用するには、前述の「プライベート専用インスタンス」の場合と同様に、VPEゲートウェイ（およびVault UIへのアクセスにはクライアントからサイトへのVPN）が必要です。

インスタンスの正確なエンドポイントURLは、 Secrets Manager のUIにある「 エンドポイント 」ページから、 またはインスタンス詳細API を呼び出すことで取得できます。

エンドポイント URL の表示

サービス・エンドポイント URL は、Secrets Manager UI の**「エンドポイント」**ページで見つけることができます。

プライベートコントロールプレーンのエンドポイントは、VPEゲートウェイを通してアクセスできる。 詳しくは、サービス・エンドポイントを使用した Secrets Manager へのプライベート接続を参照してください。 サービス・エンドポイント URL をプログラムでリトリーブする必要がある場合は、以下の API を呼び出して、ご使用の Secrets Manager インスタンス固有の値を取得することもできます。

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"

次の表に従って、例の要求内の変数を置き換えてください。

要求が成功すると、指定したリージョンとサービス・インスタンス CRN に関連付けられているエンドポイント URL が返されます。 次の JSON スニペットは、応答の例を示しています。

{
    "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"
    }
}

制御プレーン・エンドポイント

コントロール・プレーンAPIを呼び出すには、以下のコントロール・プレーン・エンドポイントを使用する。

プライベートコントロールプレーンのエンドポイントは、VPEゲートウェイを通してアクセスできる。 詳しくは、サービス・エンドポイントを使用した Secrets Manager へのプライベート接続を参照してください。

このAPIを試すために、ブラウザーからSwagger UIhttps://{region}.secrets-manager.cloud.ibm.com/swagger-uiと対話できます。

**「プライベートのみ」**オプションをインスタンスに構成した場合は、private_endpoints オブジェクトのみがこの API から応答として返されます。