

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Vérifier une signature signée à l'aide du mécanisme ECDSA dans la CLI CloudHSM
<a name="cloudhsm_cli-crypto-verify-ecdsa"></a>

Utilisez la **crypto verify ecdsa** commande de l'interface de ligne de commande CloudHSM pour effectuer les opérations suivantes :
+ Vérifiez qu'un fichier a été signé dans le HSM par une clé publique donnée.
+ Vérifiez que la signature a été générée à l'aide du mécanisme de signature ECDSA.
+ Comparez un fichier signé à un fichier source et déterminez si les deux sont liés cryptographiquement en fonction d'une clé publique ECDSA et d'un mécanisme de signature donnés. 
+  La fonction de vérification ECDSA attend la signature au format `r||s` dans lequel les composants r et s sont concaténés sous forme de données binaires brutes. 

Pour utiliser la **crypto verify ecdsa** commande, vous devez d'abord disposer d'une clé publique EC dans votre AWS CloudHSM cluster. Vous pouvez importer une clé publique EC à l'aide de la [Importer une clé au format PEM à l'aide de la CLI CloudHSM](cloudhsm_cli-key-import-pem.md) commande dont l'`verify`attribut est défini sur`true`.

**Note**  
Vous pouvez générer une signature dans l'interface de ligne de commande CloudHSM à l'aide [La catégorie des signes cryptographiques dans la CLI CloudHSM](cloudhsm_cli-crypto-sign.md) de sous-commandes.

## Type utilisateur
<a name="cloudhsm_cli-crypto-verify-ecdsa-userType"></a>

Les types d'utilisateur suivants peuvent exécuter cette commande.
+ Utilisateurs de chiffrement (CU)

## Exigences
<a name="cloudhsm_cli-crypto-verify-ecdsa-requirements"></a>
+ Pour exécuter cette commande, vous devez être connecté en tant que CU.

## Syntaxe
<a name="cloudhsm_cli-crypto-verify-ecdsa-syntax"></a>

```
aws-cloudhsm > help crypto verify ecdsa
Verify with the ECDSA mechanism

Usage: crypto verify ecdsa --key-filter [{{<KEY_FILTER>}}...] --hash-function {{<HASH_FUNCTION>}} <--data-path {{<DATA_PATH>}}|--data {{<DATA>}}> <--signature-path {{<SIGNATURE_PATH>}}|--signature {{<SIGNATURE>}}>

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 verified
      --data {{<DATA>}}
          Base64 encoded data to be verified
      --signature-path {{<SIGNATURE_PATH>}}
          The path to where the signature is located
      --signature {{<SIGNATURE>}}
          Base64 encoded signature to be verified
      --data-type {{<DATA_TYPE>}}
          The type of data passed in, either raw or digest [possible values: raw, digest]
  -h, --help
          Print help
```

## Exemple
<a name="cloudhsm_cli-crypto-verify-ecdsa-examples"></a>

Ces exemples montrent comment vérifier une signature générée **crypto verify ecdsa** à l'aide du mécanisme de signature ECDSA et de la fonction de `SHA256` hachage. Cette commande utilise une clé publique dans le HSM.

**Example Exemple : vérifier une signature codée en Base64 avec des données codées en Base64**  

```
aws-cloudhsm > crypto verify ecdsa \
    --hash-function sha256 \
    --key-filter attr.label=ec-public \
    --data YWJjMTIz \
    --signature 4zki+FzjhP7Z/KqoQvh4ueMAxQQVp7FQguZ2wOS3Q5bzk+Hc5irV5iTkuxQbropPttVFZ8V6FgR2fz+sPegwCw==
{
  "error_code": 0,
  "data": {
    "message": "Signature verified successfully"
  }
}
```

**Example Exemple : vérifier un fichier de signature à l'aide d'un fichier de données**  

```
aws-cloudhsm > crypto verify ecdsa \
    --hash-function sha256 \
    --key-filter attr.label=ec-public \
    --data-path data.txt \
    --signature-path signature-file
{
  "error_code": 0,
  "data": {
    "message": "Signature verified successfully"
  }
}
```

**Example Exemple : prouver une fausse relation de signature**  
Cette commande vérifie si les données situées dans ont `/home/data` été signées par une clé publique portant l'étiquette `ecdsa-public` en utilisant le mécanisme de signature ECDSA pour produire la signature qui se trouve dans. `/home/signature` Étant donné que les arguments donnés ne constituent pas une véritable relation de signature, la commande renvoie un message d'erreur.  

```
aws-cloudhsm > crypto verify ecdsa \
    --hash-function sha256 \
    --key-filter attr.label=ec-public \
    --data aW52YWxpZA== \
    --signature +ogk7M7S3iTqFg3SndJfd91dZFr5Qo6YixJl8JwcvqqVgsVuO6o+VKvTRjz0/V05kf3JJbBLr87Q+wLWcMAJfA==
{
  "error_code": 1,
  "data": "Signature verification failed"
}
```

## Arguments
<a name="cloudhsm_cli-crypto-verify-ecdsa-arguments"></a>

**{{<CLUSTER\_ID>}}**  
L'ID du cluster sur lequel exécuter cette opération.  
Obligatoire : si plusieurs clusters ont été [ configurés. ](cloudhsm_cli-configs-multi-cluster.md)

**{{<DATA>}}**  
Données codées en Base64 à signer.  
Obligatoire : Oui (sauf si fourni via le chemin de données)

**{{<DATA\_PATH>}}**  
Spécifie l'emplacement des données à signer.  
Obligatoire : Oui (sauf si fourni via le chemin de données)

**{{<HASH\_FUNCTION>}}**  
Spécifie la fonction de hachage.   
Valeurs valides :  
+ sha1
+ sha224
+ sha256
+ sha384
+ sha512
Obligatoire : oui

**{{<KEY\_FILTER>}}**  
Référence de clé (par exemple`key-reference=0xabc`) ou liste d'attributs clés séparés par des espaces sous la forme de `attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE` pour sélectionner une clé correspondante.  
Pour obtenir la liste des attributs de clé de la CLI CloudHSM pris en charge, consultez la section Attributs clés de la CLI CloudHSM.  
Obligatoire : oui

**{{<SIGNATURE>}}**  
Signature codée en Base64.  
Obligatoire : Oui (sauf si fourni via le chemin de signature)

**{{<SIGNATURE\_PATH>}}**  
Spécifie l'emplacement de la signature.  
Obligatoire : Oui (sauf si fourni via le chemin de signature)

**{{<DATA\_TYPE>}}**  
 Spécifie si la valeur du paramètre de données doit être hachée dans le cadre de l'algorithme de signature. `raw`À utiliser pour les données non hachées ; à utiliser `digest` pour les résumés, qui sont déjà hachés.   
Valeurs valides :  
+ raw
+ digérer

## Rubriques associées
<a name="cloudhsm_cli-crypto-verify-ecdsa-seealso"></a>
+ [La catégorie des signes cryptographiques dans la CLI CloudHSM](cloudhsm_cli-crypto-sign.md)
+ [La catégorie Crypto Verify dans la CLI CloudHSM](cloudhsm_cli-crypto-verify.md)