Encapsular uma chave com o AES-ZERO-PAD usando a CLI do CloudHSM

Use o comando key wrap aes-zero-pad na CLI do CloudHSM para encapsular uma chave de carga útil usando uma chave AES no módulo de segurança de hardware (HSM) e o mecanismo de encapsulamento AES-ZERO-PAD. O atributo extractable da chave de carga útil deve ser definido como true.

Somente o proprietário de uma chave, ou seja, o usuário de criptografia que a criou, pode encapsulá-la. Os usuários que compartilham a chave podem usá-la em operações criptográficas.

Para usar o comando key wrap aes-zero-pad, primeiro você deve ter uma chave AES em seu cluster do AWS CloudHSM. Você pode gerar uma chave AES para encapsular usando o comando Gerar uma chave AES simétrica com a CLI do CloudHSM com o atributo wrap definido como true.

Tipo de usuário

Os seguintes tipos de usuários podem executar este comando.

Requisitos

Sintaxe

aws-cloudhsm > help key wrap aes-zero-pad
Usage: key wrap aes-zero-pad [OPTIONS] --payload-filter [<PAYLOAD_FILTER>...] --wrapping-filter [<WRAPPING_FILTER>...]

Options:
      --cluster-id <CLUSTER_ID>
          Unique Id to choose which of the clusters in the config file to run the operation against. If not provided, will fall back to the value provided when interactive mode was started, or error
      --payload-filter [<PAYLOAD_FILTER>...]
          Key reference (e.g. key-reference=0xabc) or space separated list of key attributes in the form of attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE to select a payload key
      --wrapping-filter [<WRAPPING_FILTER>...]
          Key reference (e.g. key-reference=0xabc) or space separated list of key attributes in the form of attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE to select a wrapping key
      --path <PATH>
          Path to the binary file where the wrapped key data will be saved
  -h, --help
          Print help

Exemplo

Este exemplo mostra como usar o comando key wrap aes-zero-pad usando uma chave AES com o valor do atributo wrap definido como true.

aws-cloudhsm > key wrap aes-zero-pad --payload-filter attr.label=payload-key --wrapping-filter attr.label=aes-example
{
  "error_code": 0,
  "data": {
    "payload_key_reference": "0x00000000001c08f1",
    "wrapping_key_reference": "0x00000000001c08ea",
    "wrapped_key_data": "L1wVlL/YeBNVAw6Mpk3owFJZXBzDLONt"
  }
}

Argumentos

Tópicos relacionados