BCRYPT_MLKEM_KEY_BLOB estrutura

A estrutura BCRYPT_MLKEM_KEY_BLOB é usada como cabeçalho para uma chave pública ML-KEM (chave de encapsulamento codificada em bytes) ou BLOB de chave privada na memória.

Syntax

typedef struct _BCRYPT_MLKEM_KEY_BLOB {
  ULONG dwMagic;
  ULONG cbParameterSet;             // Byte size of parameterSet[]
  ULONG cbKey;                      // Byte size of key[]
  // WCHAR parameterSet[cbParameterSet / sizeof(WCHAR)];  // Including \0-terminated
  // BYTE key[cbKey];                                     // Key material
} BCRYPT_MLKEM_KEY_BLOB, *PBCRYPT_MLKEM_KEY_BLOB;

typedef struct _BCRYPT_COMPOSITE_MLKEM_KEY_BLOB {
  ULONG dwMagic;
  ULONG cbParameterSet;             // Byte size of parameterSet[]
  ULONG cbKey;                      // Byte size of key[]
  // WCHAR parameterSet[cbParameterSet / sizeof(WCHAR)];  // Including \0-terminated
  // BYTE key[cbKey];                                     // Key material
} BCRYPT_COMPOSITE_MLKEM_KEY_BLOB, *PBCRYPT_COMPOSITE_MLKEM_KEY_BLOB;

Fields

dwMagic

O campo dwMagic é um valor de 4 bytes que indica o formato da chave utilizada. São definidos os seguintes valores:

cbParameterSet

O comprimento, em bytes, do parámetro buffer Define diretamente após o struct. Esse buffer contém uma cadeia de caracteres Unicode terminada em nulo que identifica o conjunto de parâmetros da chave. Atualmente são suportados os seguintes valores:

cbKey

O comprimento, em bytes, da chave de buffer imediatamente após o parámetro Set. Esse tamanho é estático e depende do formato da chave e do conjunto de parâmetros em uso.

Remarks

BCRYPT_MLKEM_PRIVATE_BLOB (também apelidado como BCRYPT_MLKEM_DECAPSULATION_BLOB) suporta a importação e exportação de chaves de decapsulação de ML-KEM codificadas em bytes padrão conforme o FIPS 203. O blob tem o valor BCRYPT_MLKEM_PRIVATE_MAGICdwMagic e o campo chave contém a chave codificada em bytes.

BCRYPT_MLKEM_PUBLIC_BLOB (também apelidado como BCRYPT_MLKEM_ENCAPSULATION_BLOB) suporta a importação e exportação de chaves de encapsulamento de ML-KEM codificadas em bytes padrão conforme o FIPS 203. O blob tem o valor BCRYPT_MLKEM_PUBLIC_MAGICdwMagic e o campo chave contém a chave codificada em bytes.

BCRYPT_MLKEM_PRIVATE_SEED_BLOB suporta a importação e exportação de sementes ML-KEM. O blob tem o valor BCRYPT_MLKEM_PRIVATE_SEED_MAGICdwMagic e o campo key contém a seed KEM (definida como a concatenação de 64 bytes de d || z por FIPS 203), por isso cbKey é atualmente sempre 64.

Os tamanhos dos bytes das chaves codificadas em bytes podem ser encontrados na Tabela 3 da Secção 8 do FIPS 203 . Muitos chamadores podem, em vez disso, consultar dinamicamente os tamanhos de blob necessários usando o BCryptExportKey com NULLpbOutput.

BCRYPT_COMPOSITE_MLKEM_PRIVATE_BLOB suporta a importação e exportação de chaves privadas Composite-ML-KEM codificadas por bytes padrão por PQ Composite ML-KEM. O blob tem o valor BCRYPT_COMPOSITE_MLKEM_PRIVATE_MAGICdwMagic e o campo chave contém a chave codificada em bytes.

BCRYPT_COMPOSITE_MLKEM_PUBLIC_BLOB suporta a importação e exportação de chaves públicas Composite-ML-KEM codificadas por bytes padrão por PQ Composite ML-KEM. O blob tem o valor BCRYPT_COMPOSITE_MLKEM_PUBLIC_MAGICdwMagic e o campo chave contém a chave codificada em bytes.

BCRYPT_COMPOSITE_MLKEM_PRIVATE_IRTF_SEED_BLOB suporta a importação e exportação de sementes compostasML-KEM. O blob tem valor BCRYPT_COMPOSITE_MLKEM_PRIVATE_IRTF_SEED_MAGICdwMagic e o campo key contém a semente IRTF Composite-ML-KEM de 32 bytes segundo os KEMs híbridos de betão CFRG, por isso cbKey está atualmente sempre 32.

Requirements

Ver também

BCryptGenerateKeyPair

BCryptImportKeyPair

BCryptFinalizeKeyPair

BCryptExportKey

BCryptGetProperty

BCryptSetProperty

BCryptEncapsulate

BCryptDecapsulate