試用方案與標準方案

試用版與標準版 方案可在以下地區使用。

Vault 專用方案

Vault 專用 服務可在以下區域使用。

「Vault Dedicated」方案目前正處於公開測試階段。 Beta 功能係為評估與測試之目的而提供，與一般可用的功能相比，其功能尚有某些限制。

試用版與標準版方案的服務端點

若需管理您的 Secrets Manager 資源，請參閱下表，以確定連線至 Secrets Manager API 時應使用的 API 端點。

若要瞭解如何設定您的 Secrets Manager 範例以使用私人端點，請參閱 保護您與 Secrets Manager 的連線。

準備好試用 API 了嗎? 若要從瀏覽器與 Swagger UI 互動，請將 api/v2/swagger-ui 加入您的服務端點 URL。 例如，https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui。

Vault Dedicated 方案的服務端點

Vault 專用 方案會為每個實例提供兩個私有端點 URL：一個用於 Vault API，另一個用於 Vault UI。 兩者均只能透過 VPE 閘道存取 —— 此方案不支援雲端服務端點 (CSE)。

請將 {instance_ID} 替換為您的實例 UUID，並將 {region} 替換為區域縮寫，例如 us-south 或 eu-de``。

若您的執行個體已設定為僅限私有端點，則適用以下存取要求：

• API 存取：需使用一個指向您的 Vault Dedicated 實例的 VPE 閘道。 有關設定說明，請參閱《 使用服務端點私密連線至 Secrets Manager 》。
• 存取 Vault 使用者介面：需透過 VPE 路由流量的「客戶端至站點」VPN。 瀏覽器無法直接從 IBM Cloud 私有網路外部存取私有 Vault UI URL。 有關設定說明，請參閱《 使用「客戶端至站點」VPN 透過私有連線連線至 Secrets Manager 》。

若您的實例已設定為同時具備公開與私有端點，則無需透過 VPE 或 VPN，即可透過公開網際網路存取 Vault API 和 Vault UI。 私人端點的 URL 亦可使用，但使用這些 URL 仍需透過 VPE 閘道器（以及用於存取 Vault 使用者介面的「客戶端至站點」VPN），這與上文所述的「僅限私人」實例的情況完全相同。

您可以從 Secrets Manager 使用者介面的 「端點」 頁面，或透過呼叫 實例詳細資訊 API， 取得您實例的確切端點 URL。

檢視端點 URL

您可以在 Secrets Manager 使用者介面的 端點 頁面中找到服務端點 URL。

私有控制平面端點可透過 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 使用者介面互動: https://{region}.secrets-manager.cloud.ibm.com/swagger-ui。

如果使用 僅限專用 選項來配置實例，則此 API 只會在回應中傳回 private_endpoints 物件。