Planos de teste e padrão

Os planos “ Versão de Avaliação e Padrão ” estão disponíveis nas seguintes regiões.

Plano Dedicado do Vault

O serviço “{: tag-green} ” [do Vault Dedicated] está disponível nas seguintes regiões.

O plano Vault Dedicated está disponível atualmente em versão beta pública. Os recursos em versão beta são fornecidos para fins de avaliação e teste e apresentam limitações em comparação com os recursos disponíveis ao público em geral.

Pontos de conexão do serviço para os planos de Avaliação e Padrão

Se você precisar gerenciar seus recursos do Secrets Manager, consulte a tabela a seguir para determinar os endpoints da API a serem usados ao se conectar à API do Secrets Manager.

Para saber como configurar sua instância do Secrets Manager para usar terminais privados, consulte Protegendo sua conexão com o Secrets Manager.

Pronto para tentar as APIs? Para interagir com uma IU do Swagger por meio do seu navegador, inclua api/v2/swagger-ui na URL de seu terminal em serviço. Por exemplo, https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/swagger-ui.

Pontos de conexão do serviço para o plano Vault Dedicated

O plano “{: tag-green} ” [do Vault Dedicated] disponibiliza dois URLs de endpoint privados por instância: um para a API do Vault e outro para a interface do usuário do Vault. Ambos são acessíveis apenas por meio de um gateway VPE — os Cloud Service Endpoints (CSE) não são compatíveis com este plano.

Substitua {instance_ID} pelo UUID da sua instância e {region} pela abreviação da região, por exemplo, us-south ou eu-de.

Se sua instância estiver configurada com endpoints exclusivamente privados, aplicam-se os seguintes requisitos de acesso:

• Acesso à API: Requer um gateway VPE direcionado à sua instância do Vault Dedicated. Para obter instruções de configuração, consulte “Usando pontos de conexão de serviço para se conectar de forma privada a Secrets Manager ”.
• Acesso à interface do usuário do Vault: Requer uma VPN do tipo Cliente para Site que encaminhe o tráfego pelo VPE. Um navegador não consegue acessar a interface de usuário privada do Vault URL diretamente de fora da rede privada IBM Cloud. Para obter instruções de configuração, consulte “Usando a VPN cliente-para-site para se conectar de forma privada a Secrets Manager ”.

Se sua instância estiver configurada com endpoints públicos e privados, a API do Vault e a interface do usuário do Vault podem ser acessadas pela Internet pública sem a necessidade de um VPE ou VPN. As URLs dos endpoints privados também estão disponíveis, mas o uso delas ainda requer um gateway VPE (e uma VPN do tipo Cliente para Site para acesso à interface do usuário do Vault), exatamente como descrito acima para instâncias exclusivamente privadas.

Você pode obter as URLs exatas dos endpoints da sua instância na página “Endpoints” da interface do usuário do Secrets Manager ou chamando a API de detalhes da instância.

Visualizando suas URLs de terminal

É possível localizar suas URLs de terminal em serviço na página Terminais da IU do Secrets Manager.

O endpoint do plano de controle privado é acessível por meio de um gateway VPE. Para obter mais informações, consulte Usando terminais de serviço para conectar-se privadamente ao Secrets Manager. Caso você precise recuperar suas URLs de terminal em serviço programaticamente, também é possível chamar a API a seguir para recuperar os valores que são específicos para sua instância do 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"

Substitua as variáveis na solicitação de exemplo de acordo com a tabela a seguir.

Uma solicitação bem-sucedida retorna as URLs de terminal associadas à região e ao CRN da instância de serviço especificada. O fragmento JSON a seguir mostra uma resposta de exemplo.

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

Pontos finais do plano de controle

Use os seguintes pontos de extremidade do plano de controle para chamar as APIs do plano de controle.

O endpoint do plano de controle privado é acessível por meio de um gateway VPE. Para obter mais informações, consulte Usando terminais de serviço para conectar-se privadamente ao Secrets Manager.

Para experimentar esta API, é possível interagir com a IU do Swagger a seguir a partir do seu navegador: https://{region}.secrets-manager.cloud.ibm.com/swagger-ui.

Se sua instância estiver configurada com a opção Somente privado, essa API retornará apenas o objeto private_endpoints na resposta.