Creare e modificare gli alias dei tasti con la console

Gli alias delle chiavi possono essere aggiunti a una chiave durante il processo di creazione o importazione di una chiave.

• Per ulteriori informazioni sulla creazione di una chiave principale o di una chiave standard, consultare Creazione di chiavi principali o Creazione di chiavi standard.
• Per ulteriori informazioni sull'importazione di una chiave principale o di una chiave standard, consultare Importazione di chiavi principali o Importazione di chiavi standard.

Per modificare un alias di tasto, fare clic su ⋯ e selezionare “Modifica alias ”. Nella scheda verranno visualizzati gli alias esistenti assegnati alla chiave (e sarà possibile eliminarli) e sarà possibile aggiungere altri alias. Una chiave può avere fino a cinque alias.

Creazione di alias di chiavi con l'API

Crea un alias per la chiave effettuando una chiamata di tipo " POST " all'endpoint seguente.

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

1. Richiama le tue credenziali di autenticazione per lavorare con le chiavi nel servizio.

   Per creare un alias chiave, è necessario essere assegnati al ruolo di accesso al servizio Manager o Writer o Writer. Per conoscere la corrispondenza dei ruoli IAM con Key Protect azioni di servizio, controllare Ruoli di accesso al servizio.

2. Creare un alias di chiave eseguendo il seguente curl comando.

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

Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

Per tutelare la riservatezza dei tuoi dati personali, evita di inserire informazioni di identificazione personale (PII), come il tuo nome o la tua posizione, quando crei un alias per la chiave. Per ulteriori esempi di informazioni di identificazione personale (PII), consultare la sezione 2.2 della Pubblicazione speciale 800-122 del NIST.

Una risposta corretta a POST api/v2/keys/<keyID_or_alias>/aliases/<key_alias> restituisce l'alias della chiave, insieme ad altri metadati L'alias è un nome nome univoco che viene assegnato alla chiave e che può essere utilizzato per recuperare ulteriori informazioni sulla chiave associata.

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

Per una descrizione dettagliata dei parametri di risposta, si veda il file Key Protect Documento di riferimento dell'API REST.

Ogni chiave può avere fino a cinque alias. C'è un limite di 1.000 alias per istanza istanza.

Eliminazione degli alias delle chiavi con l'API

Per eliminare un alias di chiave, effettuare una chiamata di tipo “ DELETE ” all’endpoint seguente.

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

1. Richiama le tue credenziali di autenticazione per lavorare con le chiavi nel servizio.

2. Eliminare un alias chiave eseguendo il seguente curl comando.

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

Sostituisci le variabili nella richiesta di esempio in base alla seguente tabella.

Una richiesta DELETE api/v2/keys/<keyID_or_alias>/aliases/<key_alias> andata a buon fine restituisce una risposta HTTP 204 No Content, che indica che l'alias associato alla chiave è stato cancellato.

L'eliminazione completa di un alias dal servizio richiede fino a cinque minuti.

API che utilizzano alias di chiavi

La tabella seguente elenca le API che si possono utilizzare per creare e utilizzare una chiave alias.