Piani Trial e Standard

I piani [“Trial” e “Standard”] di{: tag-blue} sono disponibili nelle seguenti regioni.

Piano "Vault Dedicated"

Il servizio "{: tag-green} " di [Vault Dedicated] è disponibile nelle seguenti regioni.

Il piano Vault Dedicated è attualmente disponibile in versione beta pubblica. Le funzionalità beta sono fornite a scopo di valutazione e test e presentano alcune limitazioni rispetto alle funzionalità generalmente disponibili.

Endpoint di servizio per i piani Trial e Standard

Se devi gestire le tue risorse di Secrets Manager, consulta la tabella seguente per individuare gli endpoint API da utilizzare quando ti connetti all'API di Secrets Manager.

Per sapere come configurare l'istanza di Secrets Manager per utilizzare endpoint privati, vedere Protezione della connessione a Secrets Manager.

Sei pronto a provare le API? Per interagire con un'interfaccia utente Swagger dal browser, aggiungere api/v2/swagger-ui all'endpoint del servizio URL. Ad esempio, https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui.

Endpoint di servizio per il piano Vault Dedicated

Il piano "{: tag-green} " [di Vault Dedicated] mette a disposizione due URL di endpoint privati per ogni istanza: uno per l'API di Vault e uno per l'interfaccia utente di Vault. Entrambi sono accessibili solo tramite un gateway VPE: i Cloud Service Endpoints (CSE) non sono supportati per questo piano.

Sostituisci {instance_ID} con l'UUID della tua istanza e {region} con l'abbreviazione della regione, ad esempio us-south o eu-de.

Se la tua istanza è configurata con endpoint esclusivamente privati, si applicano i seguenti requisiti di accesso:

• Accesso tramite API: richiede un gateway VPE configurato per l'istanza di Vault Dedicated. Per le istruzioni di configurazione, consultare la guida “Utilizzo degli endpoint di servizio per connettersi in modo privato a Secrets Manager ”.
• Accesso all'interfaccia utente di Vault: richiede una VPN client-to-site che instradi il traffico attraverso il VPE. Un browser non può accedere all'interfaccia utente privata di Vault all'indirizzo URL direttamente dall'esterno della rete privata IBM Cloud. Per le istruzioni di configurazione, consultare la guida “Utilizzo della VPN client-to-site per connettersi in modo privato a Secrets Manager ”.

Se l'istanza è configurata con endpoint pubblici e privati, l'API di Vault e l'interfaccia utente di Vault sono raggiungibili tramite Internet pubblico senza bisogno di una VPE o di una VPN. Sono disponibili anche gli URL degli endpoint privati, ma per utilizzarli è comunque necessario un gateway VPE (e una VPN Client-to-Site per l'accesso all'interfaccia utente di Vault), esattamente come descritto sopra per le istanze esclusivamente private.

È possibile recuperare gli URL esatti degli endpoint della propria istanza dalla pagina "Endpoint " dell'interfaccia utente di Secrets Manager oppure richiamando l'API dei dettagli dell'istanza.

Visualizzazione degli URL degli endpoint

Puoi trovare i tuoi URL dell'endpoint del servizio nella pagina Endpoints dell'IU Secrets Manager.

L'endpoint del piano di controllo privato è accessibile attraverso un gateway VPE. Per ulteriori informazioni, vedere Utilizzo di endpoint di servizio per connettersi privatamente a Secrets Manager. Se devi richiamare i tuoi URL dell'endpoint del servizio in modo programmatico, puoi anche richiamare la seguente API per richiamare i valori specifici per la tua istanza 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"

Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

Una richiesta riuscita restituisce gli URL dell'endpoint associati alla regione e al CRN di istanza del servizio che specifichi. Il seguente frammento di codice JSON mostra un esempio di risposta.

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

Endpoint del piano di controllo

Utilizzare i seguenti endpoint del piano di controllo per chiamare le API del piano di controllo.

L'endpoint del piano di controllo privato è accessibile attraverso un gateway VPE. Per ulteriori informazioni, vedere Utilizzo di endpoint di servizio per connettersi privatamente a Secrets Manager.

Per provare questa API, puoi interagire con la seguente IU Swagger dal browser: https://{region}.secrets-manager.cloud.ibm.com/swagger-ui.

Se la tua istanza è configurata con l'opzione Solo privato, questa API restituisce solo l'oggetto private_endpoints nella risposta.