Visualizando recursos protegidos associados à sua chave raiz

1. Efetue login na IU.

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 Hyper Protect Crypto Services.

4. Na página Chaves KMS, use a tabela Chaves para procurar as chaves em seu serviço.

5. Para visualizar os recursos protegidos de uma chave raiz específica, clique no ícone Ações para abrir uma lista de opções para a chave e selecione Visualizar recursos associados para procurar todos os recursos protegidos pela chave.

   Tabela 2. Descreve a tabela de visualização de recursos associados

   Coluna	Descrição
   Resource name	O nome do recurso em nuvem, como um depósito do Cloud Object Storage, que está associado com a chave.
   Service name	O nome da instância de serviço da IBM Cloud na qual o recurso reside.
   Retention policy	Indica se o recurso em nuvem tem uma política de retenção. Se o valor for True, uma política de retenção será ativada para o recurso em nuvem e a chave que está associada ao recurso em nuvem não poderá ser excluída. Se o valor for False, a política de retenção não será ativada.

6. Para visualizar detalhes de cada recurso, expanda os detalhes do recurso clicando no ícone de acento circunflexo (^) na coluna Resource name.

   A tabela a seguir descreve os detalhes de registro.

   Tabela 3. Descreve as propriedades que estão associadas a um recurso

   Campo	Descrição
   Created	A data e a hora em que o recurso foi associado pela primeira vez com a chave.
   Last updated	A data e a hora em que o registro foi atualizado.
   Description	A descrição do registro.
   Key version ID	A versão da chave raiz que está protegendo o recurso em nuvem.
   Key version date	A data e a hora em que a versão da chave raiz foi atualizada.
   Cloud resource name	Representa o recurso em nuvem que está associado à chave, incluindo o Cloud Resource Name (CRN), version, cname, ctype e assim por diante.

É possível usar o campo de procura para procurar quaisquer recursos associados à chave raiz com o nome do recurso ou o ID da versão da chave.

Visualizando recursos em sua instância

1. Efetue login na IU.

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 Hyper Protect Crypto Services.

4. Na página Recursos associados do KMS, use a tabela Recursos associados do serviço de gerenciamento de chaves para procurar os registros em seu serviço.

   Tabela 4. Descreve a tabela de recursos associados

   Coluna	Descrição
   Resource name	O nome do recurso em nuvem, como um depósito do Cloud Object Storage, que está associado com a chave.
   Key name	O nome legível que identifica a chave raiz que está associada ao recurso em nuvem especificado.
   Key ID	O ID que identifica a chave raiz que está associada ao recurso em nuvem especificado.
   Service name	O nome da instância de serviço da IBM Cloud na qual o recurso reside.
   Retention policy	Indica se o recurso em nuvem pode ser apagado. Se o valor estiver Enabled, o recurso em nuvem não pode ser apagado e a chave que está associada ao recurso em nuvem não pode ser excluída. Se o valor estiver Disabled, o recurso em nuvem pode ser apagado. Será possível excluir a chave associada ao recurso em nuvem, se necessário.

5. Clique no ícone de acento circunflexo (^) na coluna Resource name para visualizar uma lista de detalhes para um registro específico.

   A tabela a seguir descreve os detalhes de registro.

   Tabela 5. Descreve as propriedades que estão associadas a um recurso

   Campo	Descrição
   Created	A data e a hora em que o recurso foi associado pela primeira vez com a chave.
   Last updated	A data e a hora em que o registro foi atualizado.
   Description	A descrição do registro.
   Key version ID	A versão da chave raiz que está protegendo o recurso em nuvem.
   Key version date	A data e a hora em que a versão da chave raiz foi atualizada.
   Cloud resource name	Representa o recurso em nuvem que está associado à chave, incluindo o Cloud Resource Name (CRN), version, cname, ctype e assim por diante.

Além de procurar um recurso, é possível também procurar recursos por Nome do recurso, ID de chave e política de retenção. Para isso, clique no botão Filter, selecione as opções de filtro da lista e clique em Aplicar.

Listando registros para uma chave raiz específica com a API

É possível recuperar os detalhes de registro que estão associados a uma chave raiz específica fazendo uma chamada GET para o terminal a seguir.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations

1. Recupere as suas credenciais de autenticação para trabalhar com a API.

2. Visualize os registros que estão associados a uma chave raiz executando o comando cURL a seguir.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/<key_ID>/registrations \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   Tabela 7. Descreve as variáveis necessárias para listar todos os registros associados a uma chave raiz

   Variável	Descrição
   region	Obrigatório. A abreviação da região, como us-south ou eu-de, que representa a área geográfica na qual sua instância do Hyper Protect Crypto Services reside. Para obter mais informações, consulte Terminais de serviços regionais.
   port	Obrigatório. O número da porta do terminal da API.
   IAM_token	Obrigatório. Seu token de acesso do IBM Cloud. Inclua o conteúdo integral do token IAM, incluindo valor Bearer, na solicitação cURL. Para obter mais informações, consulte Recuperando um token de acesso.
   instance_ID	Obrigatório. O identificador exclusivo que é designado para sua instância de serviço Hyper Protect Crypto Services. Para obter mais informações, consulte Recuperando um ID da instância.

   Quando bem-sucedida, a solicitação GET api/v2/keys/<key_ID>/registrations retorna uma coleção dos registros que estão mapeados para o ID de chave especificado.

   {
     "metadata": {
         "collectionType": "application/vnd.ibm.kms.registration+json",
         "collectionTotal": 2
     },
     "resources": [
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       },
       {
         "keyId": "string",
         "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
         "createdBy": "string",
         "creationDate": "2010-01-12T05:23:19+0000",
         "updatedBy": "string",
         "lastUpdated": "2010-01-12T05:23:19+0000",
         "description": "string",
         "preventKeyDeletion": true,
         "keyVersion": {
             "id": "string",
             "creationDate": "2010-01-12T05:23:19+0000"
         }
       }
     ]
   }
   

   O valor resourceCrn representa o identificador exclusivo do recurso em nuvem que é criptografado por keyId. Os metadados associados ao registro, como a data de criação, também são retornados no corpo de resposta.

   Por padrão, GET api/v2/keys/registrations retorna os primeiros 200 registros, mas é possível ajustar esse limite usando o parâmetro limit no momento da consulta.

Listando registros para quaisquer chaves raiz com a API

Também é possível recuperar uma lista de registros que estão associados a qualquer recurso em nuvem fazendo uma chamada GET para o terminal a seguir.

https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query>

1. Recupere as suas credenciais de autenticação para trabalhar com a API.

2. Visualize os registros que correspondem a uma consulta de CRN que você especifica executando o comando cURL a seguir.

   curl -X GET \
   https://<instance_ID>.api.<region>.hs-crypto.appdomain.cloud/api/v2/keys/registrations?urlEncodedResourceCRNQuery=<url_encoded_CRN_query> \
   -H 'authorization: Bearer <IAM_token>' \
   -H 'bluemix-instance: <instance_ID>'
   

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

   Tabela 8. Descreve as variáveis necessárias para listar as registrações por consulta de CRN.

   Variável	Descrição
   region	Obrigatório. A abreviação da região, como us-south ou eu-de, que representa a área geográfica na qual sua instância do Hyper Protect Crypto Services reside. Para obter mais informações, consulte Terminais de serviços regionais.
   port	Obrigatório. O número da porta do terminal da API.
   url_encoded_CRN_query	Filtros para recursos associados a um Cloud Resource Name(CRN) especificado usando caracteres curinga codificados por URL (*). O parâmetro precisa conter todos os segmentos de CRN e deve ser codificado por URL Para visualizar exemplos, consulte Exemplos de consulta de CRN.
   IAM_token	Obrigatório. Seu token de acesso do IBM Cloud. Inclua o conteúdo integral do token IAM, incluindo valor Bearer, na solicitação cURL. Para obter mais informações, consulte Recuperando um token de acesso.
   instance_ID	Obrigatório. O identificador exclusivo que é designado para sua instância de serviço Hyper Protect Crypto Services. Para obter mais informações, consulte Recuperando um ID da instância.