BCRYPT_PQDSA_KEY_BLOB structure

Essa estrutura é usada para importar e exportar chaves para algoritmos de Assinatura Digital (PQDSA) do Post-Quantum. 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. Os seguintes valores são definidos:

cbParameterSet

O comprimento, em bytes, do buffer parameterSet seguindo diretamente o struct. Esse buffer contém uma cadeia de caracteres Unicode terminada em nulo que identifica o conjunto de parâmetros da chave. No momento, há suporte para os seguintes valores:

cbKey

The length, in bytes, of the buffer key directly following parameterSet. Esse tamanho é estático e depende do formato de chave e do conjunto de parâmetros em uso.

Remarks

Os consumidores de algoritmos de Assinatura Digital Do Post-Quantum usarão o mesmo subconjunto da API BCrypt que os Algoritmos de Assinatura Digital (não Pós-Quantum) existentes com suporte do CNG para executar as operações que os algoritmos dão suporte. 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