Como saber se uma chave pode ser restaurada?

Para ver se uma chave destruída pode ser restaurada:

1. Navegue para a instância do Key Protect no console do IBM Cloud.
2. Na navegação esquerda, certifique-se de estar na tela Chaves.
3. Localize a chave que deseja restaurar. Observação: somente as chaves no estado “Excluído” podem ser restauradas.
4. Sob a coluna Last updated, observe a data. Em seguida, consulte a Tabela 1, que pode ser localizada acima. Se a chave tiver sido excluída dentro dos últimos 30 dias, ela poderá ser restaurada. Se tiver sido excluída há mais de 30 dias, não será possível restaurá-la. Se tentar restaurar uma chave que não é mais elegível para ser restaurada, você receberá um erro ao tentar restaurá-la.

Restaurando uma chave excluída com o console

Se você preferir restaurar sua chave usando uma interface gráfica, será possível usar o console IBM Cloud.

Depois de importar suas chaves existentes para o serviço e excluir uma chave, conclua as seguintes etapas para restaurar a chave:

1. Efetue login no console do IBM Cloud.

2. Acesse Menu > Lista de recursos para visualizar uma lista de seus recursos.

3. Em sua lista de recursos do IBM Cloud, selecione a sua instância provisionada do Key Protect.

4. Clique em Chaves para abrir o painel de chaves e localize a chave no estado destruído que deseja restaurar. Uma maneira de fazer isso é abrir o painel de filtro e selecionar o estado “Excluído ” na lista suspensa “Estados-chave ”. Isso limitará os resultados apenas a chaves que foram excluídas.

5. Clique no ícone ⋯ para abrir uma lista de opções para a chave que você deseja restaurar. Observe que, se a chave tiver sido excluída e transferida para o estado “Destruída”, você deverá aguardar 30 segundos antes de tentar restaurá-la.

6. Clique no botão “Restaurar” para abrir o painel lateral de restauração.

7. Clique no botão “Restaurar ”.

8. Confirme se a chave foi restaurada na tabela Chaves atualizada.

Restaurando uma chave excluída com a API

Restaure uma chave importada anteriormente fazendo uma chamada POST para o terminal a seguir:

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

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

   Para restaurar uma chave, você deve ter a função de Gerenciador para a instância ou chave. Para saber como as funções do IAM são mapeadas para as ações de serviço do Key Protect, confira Funções de acesso ao serviço.

2. Recupere o ID da chave que você deseja restaurar.

   Você pode obter o ID de uma chave específica enviando uma solicitação do tipo “list keys ” ou visualizando suas chaves no painel do Key Protect. Para obter mais informações, confira Visualizando uma lista de chaves.

3. Execute o seguinte comando curl para restaurar a chave e recuperar o acesso aos seus dados associados. Observe que deve-se esperar 30 segundos após excluir uma chave antes de poder restaurá-la.

   Não é possível restaurar uma chave que tenha uma data de expiração que seja atual ou no passado.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/restore" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "x-kms-key-ring: <key_ring_ID>"
   

   Substitua as variáveis na solicitação de exemplo, de acordo com a Tabela 2.

A successful restore request returns an HTTP `201 Created` response, which indicates that the key was restored to the _Active_ key state and is now available for encrypt and decrypt operations. All attributes and policies that were previously associated with the key are also restored.

You will have access to data associated with the key as soon as the key is restored.
{: note}

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/metadata" \
    -H "accept: application/vnd.ibm.kms.key+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "type": "application/vnd.ibm.kms.key+json",
            "id": "02fd6835-6001-4482-a892-13bd2085f75d",
            "name": "...",
            "description": "...",
            "tags": [
                "..."
            ],
            "state": 1,
            "extractable": false,
            "crn": "crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:12e8c9c2-a162-472d-b7d6-8b9a86b815a6:key:02fd6835-6001-4482-a892-13bd2085f75d",
            "imported": true,
            "creationDate": "2020-03-10T20:41:27Z",
            "createdBy": "...",
            "algorithmType": "Deprecated",
            "algorithmMetadata": {
                "bitLength": "128",
                "mode": "Deprecated"
            },
            "algorithmBitSize": 128,
            "algorithmMode": "Deprecated",
            "lastUpdateDate": "2020-03-16T20:41:27Z",
            "keyVersion": {
                "id": "30372f20-d9f1-40b3-b486-a709e1932c9c",
                "creationDate": "2020-03-12T03:37:32Z"
            },
            "dualAuthDelete": {
                "enabled": false
            },
            "deleted": false
        }
    ]
}