Affichage des ressources protégées dans votre instance

1. Connectez-vous à la console IBM Cloud.

2. Accédez à Menu > Liste de ressources pour afficher la liste de vos ressources.

3. Dans la liste de ressources IBM Cloud, sélectionnez votre instance Key Protect mise à disposition.

4. Sélectionnez le lien Associated resources dans le menu de gauche.

5. Sur la page Ressources associées, utilisez le tableau Ressources associées pour parcourir les enregistrements de votre service.

6. Cliquez sur l'icône ^ sous la colonne Details pour afficher une liste des détails d'un enregistrement spécifique.

7. Cliquez sur le bouton Filter pour filtrer les ressources par ID de clé, nom de ressource de cloud et règle de conservation.

Affichage des ressources protégées associées à votre clé

1. Connectez-vous à la console IBM Cloud.

2. Accédez à Menu > Liste de ressources pour afficher la liste de vos ressources.

3. Dans la liste de ressources IBM Cloud, sélectionnez votre instance Key Protect mise à disposition.

4. Sur la page des détails de l'application, parcourez les clés de votre service dans le tableau Clés.

5. Cliquez sur l'icône ⋯ pour ouvrir une liste d'options pour la clé.

6. Dans le menu d'options, cliquez sur Ressources associées pour afficher les enregistrements associés de la clé.

Liste des enregistrements d'une clé racine spécifique

Vous pouvez extraire les détails d'enregistrement associés à une clé racine spécifique en effectuant un appel GET vers le noeud final ci-après.

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

1. Extrayez vos données d'authentification pour pouvoir utiliser l'API.

2. Affichez les enregistrements associés à une clé racine en exécutant la commande curl suivante.

   $ 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>"
   

   Remplacez les variables de l'exemple de demande conformément au tableau suivant :

Une demande GET api/v2/keys/<keyID_or_alias>/registrations réussie renvoie une collection d'enregistrements mappés à l'ID de clé spécifié.

{
    "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"
            }
        }
    ]
}

La valeur resourceCrn représente l'identificateur unique de la ressource de cloud chiffrée par keyId. Les métadonnées associées à l'enregistrement, telles que sa date de création, sont également renvoyées dans le corps de la réponse.

Par défaut, GET api/v2/keys/registrations renvoie les 200 premiers enregistrements, mais vous pouvez ajuster cette limite à l'aide du paramètre limit au moment de la demande.

$ 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>"

Liste des enregistrements de toute clé racine

Vous pouvez également extraire une liste des enregistrements associés à toute ressource de cloud en effectuant un appel GET vers le noeud final ci-après.

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

1. Extrayez vos données d'authentification pour pouvoir utiliser l'API.

2. Affichez les enregistrements correspondant à une demande CRN que vous indiquez en exécutant la commande curl suivante.

   $ curl -X GET \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/registrations" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>"
   

   Remplacez les variables de l'exemple de demande conformément au tableau suivant :

$ 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>"

Exemples de requête CRN

Utilisez les requêtes CRN encodées d'URL pour filtrer les enregistrements par instance Key Protect, type de ressource ou nom de ressource. Pour en savoir plus sur les segments et le format des CRN, consultez la section « Noms des ressources cloud ».

Services Cloud qui utilisent Key Protect pour associer des clés à des ressources en votre nom peuvent uniquement afficher ou rechercher des CRN qui correspondent aux 8 premiers segments de leur CRN de service.

• Pour rechercher l'existence d'un enregistrement jusqu'à un segment CRN spécifique, utilisez un signe deux-points suivi d'un astérisque (*).

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

  Cette requête renvoie les enregistrements Databases for Redis associés à tous les types et noms de ressource pour l'ID de déploiement 29caf0e7-120f-4da8-9551-3abf57ebcfc7.

• Pour rechercher l'existence d'un enregistrement jusqu'à un segment CRN spécifique préfixé par <string>, utilisez le signe deux-points suivi de <string>* dans le dernier segment de la requête CRN.

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

  Cette requête renvoie tous les enregistrements de compartiment Cloud Object Storage du compte e1bb63d6a20dc57c87501ac4c4c99dcb qui sont préfixés par prod.

Lorsque vous répertoriez les enregistrements associés à une clé racine, votre requête CRN ne doit pas contenir d'astérisque (*) dans les huit premiers segments.

Les tableaux suivants fournissent une liste d'exemples de requête CRN avant et après le codage en URL. Pour afficher les valeurs codées en URL, cliquez sur l'onglet Codée en URL .