Excluir um repositório de chaves do AWS CloudHSM - AWS Key Management Service

Excluir um repositório de chaves do AWS CloudHSM

Ao excluir um armazenamento de chaves do AWS CloudHSM, o AWS KMS exclui do KMS todos os metadados sobre o armazenamento de chaves do AWS CloudHSM, inclusive informações sobre sua associação a um cluster do AWS CloudHSM. Essa operação não afeta o cluster do AWS CloudHSM, seus HSMs, nem seus usuários. Você pode criar um novo armazenamento de chaves do AWS CloudHSM associado ao cluster do AWS CloudHSM, mas não é possível desfazer a operação de exclusão.

Você pode excluir um armazenamento de chaves do AWS CloudHSM que esteja desconectado do cluster do AWS CloudHSM e que não contenha AWS KMS keys. Antes de excluir um armazenamento de chaves personalizado, faça o seguinte.

Em vez de excluir o armazenamento de chaves do AWS CloudHSM, considere desconectá-lo do cluster do AWS CloudHSM associado. Enquanto o armazenamento de chaves do AWS CloudHSM está desconectado, é possível gerenciar o armazenamento de chaves do AWS CloudHSM e suas AWS KMS keys. No entanto, não é possível criar nem usar chaves do KMS no armazenamento de chaves do AWS CloudHSM. Você pode reconectar o armazenamento de chaves do AWS CloudHSM a qualquer momento.

Excluir seu repositório de chaves do AWS CloudHSM

É possível excluir seu repositório de chaves do AWS CloudHSM no console do AWS KMS ou usando a operação DeleteCustomKeyStore.

Para excluir um armazenamento de chaves do AWS CloudHSM do Console de gerenciamento da AWS, comece selecionando o armazenamento de chaves do AWS CloudHSM na página Custom key stores (Armazenamentos de chaves personalizados).

  1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Key Management Service (AWS KMS) em https://console.aws.amazon.com/kms.

  2. Para alterar a Região da AWS, use o seletor de regiões no canto superior direito da página.

  3. No painel de navegação, selecione Custom key stores (Repositórios de chaves personalizados), AWS CloudHSM key stores (Repositórios de chaves do ).

  4. Encontre a linha que representa o armazenamento de chaves do AWS CloudHSM que você deseja excluir. Se o Estado de conexão do repositório de chaves do AWS CloudHSM não for Desconectado, você deverá desconectar o repositório de chaves do AWS CloudHSM antes de excluí-lo.

  5. No menu Key store actions (Ações de armazenamento de chaves), escolha Delete (Excluir).

Quando a operação for concluída, uma mensagem de êxito será exibida, e o armazenamento de chaves do AWS CloudHSM não será mais exibido na lista de armazenamentos de chaves. Se a operação não for bem-sucedida, será exibida uma mensagem de erro descrevendo o problema e fornecendo ajuda para corrigi-lo. Se precisar de ajuda adicional, consulte Solucionar problemas de um armazenamento de chaves personalizado.

Para excluir um armazenamento de chaves do AWS CloudHSM, use a operação DeleteCustomKeyStore. Se a operação tiver êxito, o AWS KMS retornará uma resposta HTTP 200 e um objeto JSON sem propriedades.

Para começar, verifique se o armazenamento de chaves do AWS CloudHSM não contém AWS KMS keys. Não é possível excluir um armazenamento de chaves personalizado que contém chaves do KMS. O primeiro exemplo de comando usa ListKeys e DescribeKey para pesquisar AWS KMS keys no repositório de chaves do AWS CloudHSM com o ID do repositório de chaves personalizado cks-1234567890abcdef0 do exemplo. Nesse caso, o comando não retorna chaves do KMS. Se retornar, use a operação ScheduleKeyDeletion para programar a exclusão de cada uma das chaves do KMS.

Bash
for key in $(aws kms list-keys --query 'Keys[*].KeyId' --output text) ; do aws kms describe-key --key-id $key | grep '"CustomKeyStoreId": "cks-1234567890abcdef0"' --context 100; done
PowerShell
PS C:\> Get-KMSKeyList | Get-KMSKey | where CustomKeyStoreId -eq 'cks-1234567890abcdef0'

Em seguida, desconecte o armazenamento de chaves do AWS CloudHSM. Este exemplo de comando usa a operação DisconnectCustomKeyStore para desconectar o armazenamento de chaves do AWS CloudHSM do cluster do AWS CloudHSM. Antes de executar um comando como esse, substitua o ID de exemplo do armazenamento de chaves personalizado por um válido.

Bash
$ aws kms disconnect-custom-key-store --custom-key-store-id cks-1234567890abcdef0
PowerShell
PS C:\> Disconnect-KMSCustomKeyStore -CustomKeyStoreId cks-1234567890abcdef0

Após o armazenamento de chaves personalizado ser desconectado, você pode usar a operação DeleteCustomKeyStore para excluí-lo.

Bash
$ aws kms delete-custom-key-store --custom-key-store-id cks-1234567890abcdef0
PowerShell
PS C:\> Remove-KMSCustomKeyStore -CustomKeyStoreId cks-1234567890abcdef0