BCRYPT_PQDSA_KEY_BLOB structure

Cette structure est utilisée pour importer et exporter des clés pour les algorithmes de signature numérique post-quantique (PQDSA). The BCRYPT_PQDSA_KEY_BLOB structure is used as a header for a Post-Quantum Digital Signature algorithm (PQDSA) public key (byte-encoded encapsulation key) or private keyBLOB in memory.

Syntax

typedef struct _BCRYPT_PQDSA_KEY_BLOB {
  ULONG dwMagic;
  ULONG cbParameterSet;                                   // Byte size of parameterSet[]
  ULONG cbKey;                                            // Byte size of key[]
  // WCHAR parameterSet[cbParameterSet / sizeof(WCHAR)];  // Including \0 terminator
  // BYTE key[cbKey];                                     // Key material
} BCRYPT_PQDSA_KEY_BLOB, *PBCRYPT_PQDSA_KEY_BLOB;

Fields

dwMagic

The dwMagic field is a 4-byte value that indicates the format of the key being used. Les valeurs suivantes sont définies :

cbParameterSet

Longueur, en octets, de la mémoire tampon parameterSet directement après le struct. Cette mémoire tampon contient une chaîne Unicode terminée par null qui identifie le jeu de paramètres de la clé. Les valeurs suivantes sont actuellement prises en charge :

cbKey

The length, in bytes, of the buffer key directly following parameterSet. Cette taille est statique et dépend du format de clé et du jeu de paramètres en cours d’utilisation.

Remarks

Les consommateurs d’algorithmes Post-Quantum Digital Signature utilisent le même sous-ensemble de l’API BCrypt que les algorithmes de signature numérique existants (non post-quantiques) pris en charge par CNG afin d’effectuer les opérations prises en charge par les algorithmes. These are:

• Algorithm handle manipulation: BCryptOpenAlgorithmProvider, BCryptCloseAlgorithmProvider
• Key management: BCryptGenerateKeyPair, BCryptImportKeyPair, BCryptExportKey, BCryptDestroyKey, BCryptFinalizeKeyPair
• Signature generation/verification: BCryptSignHash, BCryptVerifySignature
• Updating/Querying properties: BCryptGetProperty, BCryptSetProperty

Requirements