Benutzertyp Voraussetzungen Syntax Beispiel Argumente Verwandte Themen

Generieren Sie eine Signatur mit dem ECDSA-Mechanismus in CloudHSM CLI

Verwenden Sie den crypto sign ecdsa Befehl in der CloudHSM CLI, um eine Signatur mithilfe eines privaten EC-Schlüssels und des ECDSA-Signaturmechanismus zu generieren.

Um den crypto sign ecdsa Befehl verwenden zu können, benötigen Sie zunächst einen privaten EC-Schlüssel in Ihrem Cluster. AWS CloudHSM Sie können einen privaten EC-Schlüssel generieren, indem Sie den Generieren Sie ein asymmetrisches EC-Schlüsselpaar mit CloudHSM CLI Befehl verwenden, bei dem das sign Attribut auf gesetzt isttrue.

Die resultierende ECDSA-Signatur wird in dem Format generiertr||s, in dem die R- und S-Komponenten als rohe Binärdaten verkettet und im Base64-kodierten Format zurückgegeben werden.

Anmerkung

Signaturen können mit Unterbefehlen verifiziert werden. AWS CloudHSM Die Krypto-Verifizierungskategorie in CloudHSM CLI

Benutzertyp

Die folgenden Benutzertypen können diesen Befehl ausführen.

Crypto-Benutzer (CUs)

Voraussetzungen

Um diesen Befehl auszuführen, müssen Sie als CU angemeldet sein.

Syntax


aws-cloudhsm > help crypto sign ecdsa
Sign with the ECDSA mechanism

Usage: crypto sign ecdsa --key-filter [<KEY_FILTER>>...] --hash-function <HASH_FUNCTION> <--data-path <DATA_PATH>|--data <DATA>>

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
      --key-filter [<KEY_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 matching key
      --hash-function <HASH_FUNCTION>
          [possible values: sha1, sha224, sha256, sha384, sha512]
      --data-path <DATA_PATH>
          The path to the file containing the data to be signed
      --data <DATA>
          Base64 Encoded data to be signed
      --approval <APPROVAL>
          Filepath of signed quorum token file to approve operation
      --data-type <DATA_TYPE>
          The type of data passed in, either raw or digest [possible values: raw, digest]
  -h, --help
          Print help

Beispiel

Diese Beispiele zeigen, wie eine Signatur mithilfe des ECDSA-Signaturmechanismus und SHA256 der Hash-Funktion generiert wird. crypto sign ecdsa Dieser Befehl verwendet einen privaten Schlüssel im HSM.

Beispiel Beispiel: Generieren Sie eine Signatur für Base-64-kodierte Daten


aws-cloudhsm > crypto sign ecdsa \
    --key-filter attr.label=ec-private \
    --hash-function sha256 \
    --data YWJjMTIz
{
  "error_code": 0,
  "data": {
    "key-reference": "0x00000000007808dd",
    "signature": "4zki+FzjhP7Z/KqoQvh4ueMAxQQVp7FQguZ2wOS3Q5bzk+Hc5irV5iTkuxQbropPttVFZ8V6FgR2fz+sPegwCw=="
  }
}

Beispiel Beispiel: Generieren Sie eine Signatur für eine Datendatei


aws-cloudhsm > crypto sign ecdsa \
    --key-filter attr.label=ec-private \
    --hash-function sha256 \
    --data-path data.txt
{
  "error_code": 0,
  "data": {
    "key-reference": "0x00000000007808dd",
    "signature": "4zki+FzjhP7Z/KqoQvh4ueMAxQQVp7FQguZ2wOS3Q5bzk+Hc5irV5iTkuxQbropPttVFZ8V6FgR2fz+sPegwCw=="
  }
}

Argumente

<CLUSTER_ID>

Die ID des Clusters, auf dem dieser Vorgang ausgeführt werden soll.

Erforderlich: Wenn mehrere Cluster konfiguriert wurden.

<DATA>

Base64-kodierte Daten, die signiert werden sollen.

Erforderlich: Ja (sofern nicht über den Datenpfad angegeben)

<DATA_PATH>

Gibt den Speicherort der Daten an, die signiert werden sollen.

Erforderlich: Ja (sofern nicht über den Datenpfad angegeben)

<HASH_FUNCTION>

Gibt die Hash-Funktion an.

Zulässige Werte:

sha1
sha224
sha256
sha384
sha512

Erforderlich: Ja

<KEY_FILTER>

Schlüsselreferenz (z. B.key-reference=0xabc) oder durch Leerzeichen getrennte Liste von Schlüsselattributen in Form von attr.key_attribute_name=KEY_ATTRIBUTE_VALUE, um einen passenden Schlüssel auszuwählen.

Eine Liste der unterstützten CloudHSM-CLI-Schlüsselattribute finden Sie unter Schlüsselattribute für die CloudHSM-CLI.

Erforderlich: Ja

<APPROVAL>

Gibt den Dateipfad zu einer signierten Quorum-Token-Datei an, um den Vorgang zu genehmigen. Nur erforderlich, wenn der Quorumwert des privaten Schlüssels für den Key Usage Service größer als 1 ist.

<DATA_TYPE>

Gibt an, ob der Wert des Datenparameters als Teil des Signaturalgorithmus gehasht werden soll. Wird raw für Daten ohne Hashing verwendet; wird digest für Digests verwendet, die bereits gehasht sind.

Zulässige Werte:

RAW
Digest