BCRYPT_PQDSA_KEY_BLOB structure

Esta estructura se usa para importar y exportar claves para algoritmos post-Quantum Digital Signature (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. Se definen los siguientes valores:

cbParameterSet

Longitud, en bytes, del búfer parameterSet directamente después de la estructura. Este búfer contiene una cadena Unicode terminada en null que identifica el conjunto de parámetros de la clave. Actualmente se admiten los siguientes valores:

cbKey

The length, in bytes, of the buffer key directly following parameterSet. Este tamaño es estático y depende del formato de clave y del parámetro establecido en uso.

Remarks

Los consumidores de algoritmos de firma digital post-quantum usarán el mismo subconjunto de la API BCrypt que los algoritmos de firma digital existentes (no post-cuánticos) admitidos por CNG para realizar las operaciones que admiten los algoritmos. 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