Création et modification d'alias de clé à l'aide de la console

Des alias de clé peuvent être ajoutés à une clé lors du processus de création ou d'importation d'une clé.

• Pour plus d'informations sur la création d'une clé racine ou d'une clé standard, voir Création de clés racine ou Création de clés standard.
• Pour plus d'informations sur l'importation d'une clé racine ou d'une clé standard, voir Importation de clés racine ou Importation de clés standard.

Pour modifier un alias de touche, cliquez sur ⋯ puis sélectionnez « Modifier les alias ». Dans l'onglet, vous pouvez voir tous les alias existants affectés à la clé (et les supprimer) et en ajouter d'autres. Une clé peut avoir jusqu'à 5 alias.

Création d'un alias de clé avec l'API

Pour créer un alias de clé, vous devez effectuer un appel POST au noeud final suivant.

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

1. Extrayez vos données d'authentification afin d'utiliser les clés dans le service.

   Pour créer un alias de clé, vous devez avoir un rôle d'accès au service de Gestionnaire ou Éditeur. Pour savoir comment les rôles IAM sont mappés les actions de maintenance Key Protect, consultez Rôles d'accès au service.

2. Créez un alias de clé en exécutant la commande curl suivante.

   $ curl -X POST \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/aliases/<key_alias>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -H "correlation-id: <correlation_ID>"
   

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

Pour garantir la confidentialité de vos données personnelles, évitez de saisir des informations personnelles (PII), telles que votre nom ou votre emplacement, lorsque vous créez un alias de clé. Pour plus d'exemples d'informations à caractère personnel, consultez la section 2.2 de la publication spéciale 800-122 du NIST.

Une réponse POST api/v2/keys/<keyID_or_alias>/aliases/<key_alias> réussie renvoie l'alias de votre clé, ainsi que d'autres métadonnées. L'alias est un nom unique qui est affecté à votre clé et qui peut être utilisé pour extraire plus d'informations sur la clé associée.

{
    "metadata": {
        "collectionType": "application/vnd.ibm.kms.key+json",
        "collectionTotal": 1
    },
    "resources": [
        {
            "keyId": "02fd6835-6001-4482-a892-13bd2085f75d",
            "alias": "test-alias",
            "creationDate": "2020-03-12T03:37:32Z",
            "createdBy": "..."
        }
    ]
}

Pour obtenir une description détaillée des paramètres de réponse, voir Key Protect Document de référence de l'API REST.

Chaque clé peut avoir jusqu'à cinq alias. Il existe une limite de 1 000 alias par instance.

Suppression d'un alias de clé avec l'API

Pour supprimer un alias de clé, effectuez un appel DELETE au noeud final suivant.

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

1. Extrayez vos données d'authentification afin d'utiliser les clés dans le service.

2. Supprimez un alias de clé en exécutant la commande curl suivante.

   $ curl -X DELETE \
       "https://<region>.kms.cloud.ibm.com/api/v2/keys/<keyID_or_alias>/aliases/<key_alias>" \
       -H "authorization: Bearer <IAM_token>" \
       -H "bluemix-instance: <instance_ID>" \
       -H "content-type: application/vnd.ibm.kms.key+json" \
       -H "correlation-id: <correlation_ID>"
   

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

Une demande DELETE api/v2/keys/<keyID_or_alias>/aliases/<key_alias> réussie renvoie une réponse HTTP 204 No Content, ce qui indique que l'alias associé à votre clé a été supprimé.

Il faut jusqu'à cinq minutes pour qu'un alias soit complètement supprimé du service.

API utilisant un alias de clé

Le tableau suivant répertorie les API que vous pouvez utiliser pour créer et utiliser un alias de clé.