Criando conjuntos de chaves com a UI

É necessário ter a função de serviço de "Gravador" ou "Gerenciador" para criar um conjunto de chaves.

Para criar um conjunto de chaves:

1. Clique em Conjuntos de chaves na navegação esquerda.
2. No painel Conjuntos de chaves, clique no botão Criar.
3. Na guia Criar um conjunto de chaves, dê um nome ao seu novo conjunto de chaves, seguindo as instruções sobre caracteres permitidos. Em seguida, clique em Criar.

Depois de criado, seu novo conjunto de chaves aparecerá na lista de conjuntos de chaves e será possível transferir ou criar chaves para ele.

Se você gerencia chaveiros de forma consistente em vários ambientes, pode automatizar o layout de chaveiros e chaves com o Key Protect Módulo de chaveiro ou o Key Protect Módulo com tudo incluído mais amplo. Consulte Sobre os módulos do Terraform IBM para obter contexto.

Criando conjuntos de chaves com a API

Crie um conjunto de chaves fazendo uma chamada POST para o terminal a seguir.

https://<region>.kms.cloud.ibm.com/api/v2/keys

1. Recupere as suas credenciais de autenticação para trabalhar com chaves no serviço.

2. Crie um conjunto de chaves executando o comando curl a seguir.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

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

Uma solicitação POST api/v2/key_rings bem-sucedida retorna um HTTP 201 Created resposta, que indica que o anel de chaves foi criado e agora está disponível para armazenar chaves padrão e chaves raiz.

Concedendo acesso a um conjunto de chaves

É possível conceder acesso a um chaveiro em uma instância do Key Protect usando o console do IBM Cloud, a API do IAM ou a CLI{ :external}.

Revise funções e permissões para saber como as funções do IBM Cloud IAM são mapeadas para as ações do Key Protect.

Para designar o acesso a um conjunto de chaves com o console:

1. Na barra de menus, clique em Gerenciar > Acesso (IAM) e selecione Usuários para procurar pelos usuários existentes em sua conta.

2. Selecione uma linha da tabela e clique no ícone ⋯ para abrir uma lista de opções para esse usuário.

3. No menu de opções, clique em Designar acesso.

4. Clique em Designar acesso adicional de usuários.

5. Clique no botão Serviços do IAM.

6. Na lista de serviços, selecione Key Protect.

7. Selecione Serviços baseados em atributos.

8. Selecione o atributo ID da instância e selecione a instância na qual o conjunto de chaves reside.

9. Selecione o atributo ID do conjunto de chaves e insira o ID associado ao conjunto de chaves.

10. Escolha uma combinação de funções de acesso de plataforma e de serviço para designar acesso ao usuário.

11. Clique em Incluir.

12. Continue a incluir funções de plataforma e de acesso de serviço conforme necessário e quando terminar clique em Designar. Observe que o usuário deve ter pelo menos acesso de Leitor para toda a instância para poder listar, criar e excluir conjuntos de chaves nessa instância.

Listando conjuntos de chaves com a API

Para uma visualização de alto nível, é possível navegar pelos conjuntos de chaves que são gerenciados em sua instância fornecida do Key Protect fazendo uma chamada GET para o terminal a seguir.

https://<region>.kms.cloud.ibm.com/api/v2/keys_rings

1. Recupere as suas credenciais de autenticação para trabalhar com chaves no serviço.

2. Veja as características gerais dos seus anéis de chaves executando o seguinte curl a seguir.

   $ curl -X GET \ "https://<region>.kms.cloud.ibm.com/api/v2/key_rings?totalCount=<show_total>&offset=<offset_value>&limit=<offset_limit>" \
       -H "accept: application/vnd.ibm.kms.key_ring+json" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "correlation-id: <correlation_ID>"
   

   Os parâmetros de consulta após o ponto de interrogação ? são opcionais, mas estão incluídos aqui para que seu uso seja documentado. (: :nota)

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

Quando bem-sucedida, a solicitação GET api/v2/key_rings retorna uma coleção dos conjuntos de chaves que estão disponíveis na instância de serviço do Key Protect.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key_ring+json",
        "collectionTotal": 2
    },
    "resources": [
        {
            "id": "default"
        },
        {
            "id": "Sample Key Ring 2",
            "creationDate": "2020-03-12T11:00:06Z",
            "createdBy": "..."
        }
    ]
}

Excluindo conjuntos de chaves com a API

É possível excluir um conjunto de chaves fazendo uma chamada DELETE para o terminal a seguir.

https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>

Essa ação não será bem sucedida se o conjunto de chaves contiver pelo menos uma chave em um estado diferente do estado Destruído Se as únicas chaves no conjunto de chaves estiverem no estado Destruído , o conjunto de chave poderá ser excluído se force=true for incluído no comando de exclusão As chaves nesse estado são transferidas automaticamente para o conjunto de chaves default

1. Recupere as suas credenciais de autenticação para trabalhar com chaves no serviço.

2. Recupere o ID do conjunto de chaves que você deseja excluir.

   Para obter o ID do conjunto de chaves na instância do Key Protect, é possível recuperar uma lista de seus conjuntos de chaves.

3. Execute o comando curl a seguir para excluir o conjunto de chaves. Observe a presença de force=true, que forçará a exclusão do conjunto de chaves no caso de ele conter chaves no estado Destruído

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/key_rings/<key_ring_id>?force=true" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "prefer: <return_preference>"
   

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

Uma solicitação bem-sucedida retorna uma resposta de HTTP 204 No Content, que indica que o conjunto de chaves foi excluído com sucesso.