Criando uma instância de serviço do Secrets Manager

Criando uma instância do Secrets Manager na IU

Para criar uma instância do Secrets Manager a partir do console do IBM Cloud, conclua as etapas a seguir.

1. No console, acesse a página de detalhes da oferta “ Secrets Manager ”.

2. Na guia Criar, selecione a região que representa a área geográfica na qual você deseja provisionar sua instância.

3. Revise e selecione um plano de precificação.

   É possível criar apenas uma instância de avaliação do Secrets Manager por conta. Antes de poder criar uma nova instância de Avaliação, deve-se excluir a instância de Avaliação existente e sua recuperação.

4. Forneça um nome para sua instância.

5. Selecione um grupo de recursos.

6. Opcional: inclua tags para ajudar a organizar a instância em sua conta.

7. Determine uma opção para ativar a criptografia gerenciada pelo cliente para sua instância.

   É possível aprimorar a segurança de seus segredos em repouso, integrando-se a um serviço de gerenciamento de chave. Para obter mais informações sobre a criptografia gerenciada pelo cliente, confira Protegendo seus dados sensíveis no Secrets Manager.

   Você também pode usar o módulo Key Management Services All-Inclusive para simplificar o gerenciamento de chaves. Explore o Terraform IBM Modules para saber mais.

8. Determine uma opção para conexão com o Secrets Manager. Por padrão, as instâncias de Secrets Manager são criadas apenas com um endpoint privado.

   Selecione private-only ou public-and-private. Para obter mais informações sobre a configuração de sua conta para suportar a opção de conectividade privada, consulte Ativando o VRF e terminais em serviço.

9. Clique em Criar para criar uma instância do Secrets Manager na conta, na região e no grupo de recursos que você selecionou.

   Para atualizar seu plano de serviço após criar uma instância, consulte Atualizando seu plano de serviço.

Criando uma instância do Secrets Manager a partir da CLI

Para criar uma instância d Secrets Manager, utilizando a CLI do IBM Cloud, siga as etapas a seguir.

1. Faça login no IBM Cloud por meio da CLI do IBM Cloud.

   ibmcloud login
   

   Se o login falhar, execute o comando ibmcloud login --sso para tentar novamente. O parâmetro --sso é necessário quando você efetua login com um ID federado. Se essa opção for usada, acesse o link listado na saída da CLI para gerar uma senha descartável.

2. Selecione a conta, a região e o grupo de recursos nos quais você deseja criar uma instância de serviço do Secrets Manager.

   ibmcloud target -r REGION_NAME -g RESOURCE_GROUP_NAME
   

3. Crie uma instância do Secrets Manager nesta conta e grupo de recursos.

   ibmcloud resource service-instance-create INSTANCE_NAME secrets-manager PLAN REGION_NAME [OPTIONS]
   

   Descrição das informações necessárias para provisionar o serviço Secrets Manager usando a CLI

   Variável	Descrição
   Nome da instância (instance_name)	Um alias exclusivo para sua instância de serviço.
   Região (region)	A região na qual a instância deve ser provisionada Regiões suportadas.
   Plano de precificação (plan)	O plano de preços que você deseja usar. Acesse trial ou standard.
   Pontos de extremidade (options)	Opcional. Por padrão, as instâncias de Secrets Manager são criadas apenas com um ponto de extremidade privado (private-only). Se você precisar provisionar uma instância de Secrets Manager que também use um ponto de extremidade público, acrescente a opção --service-endpoints public-and-private ao seu comando.
   Criptografia (options)	Para provisionar uma instância do Secrets Manager que usa criptografia gerenciada pelo cliente, anexe -p '{"kms_key": "<root_key_crn>"}'. Substitua <root_key_crn> pelo valor de CRN para a chave raiz que você deseja integrar.

   É possível criar apenas uma instância de avaliação do Secrets Manager por conta. Antes de poder criar uma nova instância de Avaliação, deve-se excluir a instância de Avaliação existente e sua recuperação.

   Para atualizar seu plano de serviço após criar uma instância, consulte Atualizando seu plano de serviço.

Criando uma instância do Secrets Manager por meio da API

Para criar uma instância d Secrets Manager a por meio da API, siga as etapas a seguir.

Para suporte de linguagens de programação adicionais, consulte o Resource Controller API Docs.

1. Obtenha um token de acesso do IAM do IBM Cloud

2. Execute um comando curl para fornecer uma instância do Secrets Manager.

   curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
      "name": "<instance_name>",
      "target": "<region>",
      "resource_group": "<resource_group_id>",
      "resource_plan_id": "<plan>",
      "parameters": {"service-endpoints": "public-and-private","kms_key": "<root_key_crn>"}
   }'
   

   Descrição das informações necessárias para provisionar o serviço Secrets Manager usando a API

   Variável	Descrição
   Nome da instância (name)	Um alias exclusivo para sua instância de serviço.
   Target (region)	A região na qual a instância deve ser provisionada Regiões suportadas.
   Plano de precificação (plan)	O plano de precificação que você deseja usar, fornecido como um ID do plano. Use 869c191a-3c2a-4faf-98be-18d48f95ba1f para trial ou 7713c3a8-3be8-4a9a-81bb-ee822fcaac3d para standard..
   Terminais	Por padrão, as instâncias de Secrets Manager são criadas apenas com um endpoint privado. Se você precisar provisionar uma instância que Secrets Manager também utilize um endpoint público, adicione "service-endpoints":"public-and-private" ao parameters.
   Criptografia	Para fornecer uma instância do Secrets Manager que usa criptografia gerenciada pelo cliente, mantenha o parâmetro kms_key e substitua <root_key_crn> pelo valor de CRN para a chave raiz que você deseja integrar.

   É possível criar apenas uma instância de avaliação do Secrets Manager por conta. Antes de poder criar uma nova instância de Avaliação, deve-se excluir a instância de Avaliação existente e sua recuperação.

   Para atualizar seu plano de serviço após criar uma instância, consulte Atualizando seu plano de serviço.

Criação de uma instância do Secrets Manager usando o Terraform

Para criar uma instância de Secrets Manager usando o Terraform, inclua os seguintes parâmetros em seu recurso ibm_resource_instance para Secrets Manager.

• service: secrets-manager
• plan: Standard ou Trial. Saiba mais sobre os planos de serviço
• service_endpoints: private ou public-and-private. Caso não seja incluído, o valor padrão é private Inclua o seguinte no arquivo parameters para personalizações adicionais.
• kms_key: Chave raiz CRN de Key Protect. Se não for incluído, o padrão é a chave raiz gerenciada por Secrets Manager

Um exemplo de recurso teria a seguinte aparência.

resource "ibm_resource_instance" "sm_instance" {
  name              = "demo-sm-instance"
  service           = "secrets-manager"
  plan              = "standard"
  location          = "us-south"
  service_endpoints = "public-and-private"
}

Você também pode usar o IBM Cloud® Secrets Manager para provisionar e configurar instâncias do Secrets Manager como código. Para obter mais informações sobre os módulos do Terraform IBM, consulte Sobre os módulos do Terraform IBM.