Criando e editando aliases de chave com o console

Os aliases de chave podem ser incluídos em uma chave durante o processo de criação ou importação de uma chave.

• Para obter mais informações sobre como criar uma chave raiz ou uma chave padrão, confira Criando chaves raiz ou Criando chaves padrão.
• Para obter mais informações sobre como importar uma chave raiz ou uma chave padrão, confira Importando chaves raiz ou Importando chaves padrão.

Para editar um alias de tecla, clique em ⋯ e selecione “Editar aliases ”. Na guia, você verá todos os aliases existentes designados à chave e será capaz de excluí-los e de incluir mais aliases. Uma chave pode ter até cinco aliases.

Criando aliases de chave com a API

Crie um alias de chave fazendo uma chamada POST para o terminal a seguir.

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

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

   Para criar um alias de chave, deve-se ser designado a uma função de acesso de serviço de Gerenciador ou Gravador. Para saber como as funções do IAM mapeiam para ações de serviços do Key Protect, consulte Funções de acesso de serviços.

2. Crie um alias de chave executando o comando curl a seguir.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/aliases/<key_alias>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -H "correlation-id: <correlation_ID>"
   

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

Para proteger a confidencialidade de seus dados pessoais, evite inserir informações pessoais identificáveis (PII), como seu nome ou localização, quando criar um alias de chave. Para mais exemplos de PII, consulte a seção 2.2 da Publicação Especial 800-122 do NIST.

Uma resposta POST api/v2/keys/<keyID_or_alias>/aliases/<key_alias> bem-sucedida retorna o alias para sua chave, juntamente com outros metadados. O alias é um nome exclusivo que é designado à sua chave e pode ser usado para para recuperar mais informações sobre a chave associada.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "keyId": "02fd6835-6001-4482-a892-13bd2085f75d",
            "alias": "test-alias",
            "creationDate": "2020-03-12T03:37:32Z",
            "createdBy": "..."
        }
    ]
}

Para obter uma descrição detalhada dos parâmetros de resposta, consulte o Key Protect Documento de referência da API REST.

Cada chave pode ter até cinco aliases. Há um limite de 1.000 aliases por instância.

Excluindo aliases de chave com a API

Exclua um alias de chave fazendo uma chamada DELETE para o terminal a seguir.

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

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

2. Exclua um alias de chave executando o comando curl a seguir.

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/aliases/<key_alias>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -H "correlation-id: <correlation_ID>"
   

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

Uma solicitação de DELETE api/v2/keys/<keyID_or_alias>/aliases/<key_alias> bem-sucedida retorna uma resposta HTTP 204 No Content, que indica que o alias associado à sua chave foi excluído.

Leva até cinco minutos para que um alias seja completamente excluído do serviço.

APIs que usam alias de chave

A tabela a seguir lista as APIs que podem ser usadas para criar e usar um alias de chave.