Visualizando os recursos protegidos em sua instância

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. Selecione o link Associated resources no menu lateral esquerdo.

5. Na página Recursos associados, use a tabela Recursos associados para procurar os registros em seu serviço.

6. Clique no ícone ^ na coluna Details para visualizar uma lista de detalhes para um registro específico.

7. Clique no botão Filter para filtrar os recursos por ID de chave, nome de recurso em nuvem (CRN) e política de retenção.

Visualizando os recursos protegidos associados à sua 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. Na página de detalhes do aplicativo, use a tabela de Chaves para procurar as chaves em seu serviço.

5. Clique no ícone ⋯ para abrir uma lista de opções para a chave.

6. No menu de opções, clique em Recursos associados à chave para visualizar os registros associados à chave.

Listando registros para uma chave raiz específica

É 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://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/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://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/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.

Quando bem-sucedida, a solicitação GET api/v2/keys/<keyID_or_alias>/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": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "12e8c9c2-a162-472d-b7d6-8b9a86b815a6",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        },
        {
            "keyId": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
            "resourceCrn": "crn:v1:bluemix:public:cloud-object-storage:global:a/<account-id>:<service-instance>:bucket:<other-bucket-name>",
            "createdBy": "IBMid-25555555",
            "creationDate": "2010-01-12T05:23:19+0000",
            "updatedBy": "IBMid-25555555",
            "lastUpdated": "2010-01-12T05:23:19+0000",
            "description": "A description of the registration",
            "preventKeyDeletion": true,
            "keyVersion": {
                "id": "2291e4ae-a14c-4af9-88f0-27c0cb2739e2",
                "creationDate": "2010-01-12T05:23:19+0000"
            }
        }
    ]
}

O valor resourceCrn representa o identificador exclusivo do recurso em nuvem que é criptografado por keyId. Os metadados que estão associados ao registro, como a sua 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.

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

Listando registros para qualquer chave raiz

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://<region>.kms.cloud.ibm.com/api/v2/keys/registrations

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

2. Visualize os registros que correspondem a uma consulta de CRN especificada executando o comando curl a seguir.

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/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.

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?preventKeyDeletion=<true|false>&urlEncodedResourceCRNQuery=<url_encoded_CRN>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

$ curl -X GET \
    "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations?offset=<offset>&limit=<limit>" \
    -H "accept: application/vnd.ibm.collection+json" \
    -H "authorization: Bearer <IAM_token>" \
    -H "bluemix-instance: <instance_ID>"

Exemplos de consulta de CRN

Use consultas de CRN codificadas por URL para filtrar os recursos por instância do Key Protect, tipo de recurso ou nome de recurso. Para saber mais sobre os segmentos e o formato do CRN, consulte Nomes de recursos na nuvem.

Os Serviços de nuvem que usam o Key Protect para fazer a associação entre chaves e recursos em nome do usuário, podem visualizar ou consultar apenas utilizando CRNs que correspondam aos primeiros oito segmentos do CRN de serviço.

• Para procurar a existência de um registro até um segmento de CRN específico, use dois-pontos seguidos por um asterisco (*).

  crn:v1:bluemix:public:databases-for-redis:us-south:a/
  274074dce64e9c423ffc238516c755e1:29caf0e7-120f-4da8-9551-3abf57ebcfc7:*:*
  

  Esta consulta retorna os registros de Bancos de dados do Redis que estão associados a todos os tipos e nomes de recursos para o ID de implementação_29caf0e7-120f-4da8-9551-3abf57ebcfc7_.

• Para procurar um registro até um determinado segmento de CRN prefixado por <string>, use um caractere de dois pontos, seguido por <string>* no último segmento da consulta de CRN.

  crn:v1:bluemix:public:cloud-object-storage:global:a/e1bb63d6a20dc57c87501ac4c4c99dcb:*:bucket:prod*
  

  Esta consulta retorna todos os registros de depósitos de Cloud Object Storage dentro de uma conta e1bb63d6a20dc57c87501ac4c4c99dcb que são prefixados por prod.

Ao listar registros associados a qualquer chave raiz, sua consulta CRN não deve conter um asterisco (*) nos oito primeiros segmentos.

As tabelas a seguir fornecem uma lista de exemplos de consulta de CRN antes e após a codificação de URL. Para visualizar os valores codificados por URL, clique na guia Codificado por URL.