BCRYPT_MLKEM_KEY_BLOB Struktur

Die BCRYPT_MLKEM_KEY_BLOB-Struktur wird als Header für einen ML-KEM öffentlichen Schlüssel (Byte-codierter Kapselschlüssel) oder privateSchlüssel-BLOB im Arbeitsspeicher verwendet.

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

Das dwMagic-Feld ist ein 4-Byte-Wert, der das Format des verwendeten Schlüssels angibt. Die folgenden Werte sind definiert:

cbParameterSet

Die Länge des PufferparameterSets in Byte direkt nach der Struktur. Dieser Puffer enthält eine mit Null beendete Unicode-Zeichenfolge, die den Parametersatz des Schlüssels identifiziert. Die folgenden Werte werden derzeit unterstützt:

cbKey

Die Länge des Pufferschlüssels in Bytes direkt nach parameterSet. Diese Größe ist statisch und hängt vom verwendeten Schlüsselformat und vom verwendeten Parameter ab.

Remarks

BCRYPT_MLKEM_PRIVATE_BLOB (auch als BCRYPT_MLKEM_DECAPSULATION_BLOB bezeichnet) unterstützt den Import und Export von Standardbyte-codierten ML-KEM Entkapselungsschlüsseln pro FIPS 203. Das Blob hat dwMagic-WertBCRYPT_MLKEM_PRIVATE_MAGIC, und das Schlüsselfeld enthält den bytecodierten Schlüssel.

BCRYPT_MLKEM_PUBLIC_BLOB (auch als BCRYPT_MLKEM_ENCAPSULATION_BLOB bezeichnet) unterstützt den Import und Export von Standardbyte-codierten ML-KEM Kapselschlüsseln pro FIPS 203. Das Blob hat dwMagic-WertBCRYPT_MLKEM_PUBLIC_MAGIC, und das Schlüsselfeld enthält den bytecodierten Schlüssel.

BCRYPT_MLKEM_PRIVATE_SEED_BLOB unterstützt den Import und Export von ML-KEM Samen. Das Blob hat dwMagic-WertBCRYPT_MLKEM_PRIVATE_SEED_MAGIC, und das Schlüsselfeld enthält den KEM-Seed (definiert als 64-Byte-Verkettung pro d || zFIPS 203), sodass cbKey derzeit immer 64ist.

Die Bytegrößen der bytecodierten Schlüssel finden Sie in FIPS 203 Abschnitt 8 Tabelle 3. Viele Aufrufer können stattdessen die erforderlichen Blobgrößen mithilfe von BCryptExportKey mit NULLpbOutput dynamisch abfragen.

BCRYPT_COMPOSITE_MLKEM_PRIVATE_BLOB unterstützt den Import und Export von Standardbyte-codierten Composite-ML-KEM privaten Schlüsseln pro PQ Composite ML-KEM. Das Blob hat dwMagic-WertBCRYPT_COMPOSITE_MLKEM_PRIVATE_MAGIC, und das Schlüsselfeld enthält den bytecodierten Schlüssel.

BCRYPT_COMPOSITE_MLKEM_PUBLIC_BLOB unterstützt den Import und Export von Standardbyte-codierten Composite-ML-KEM öffentlichen Schlüsseln pro PQ Composite ML-KEM. Das Blob hat dwMagic-WertBCRYPT_COMPOSITE_MLKEM_PUBLIC_MAGIC, und das Schlüsselfeld enthält den bytecodierten Schlüssel.

BCRYPT_COMPOSITE_MLKEM_PRIVATE_IRTF_SEED_BLOB unterstützt den Import und Export von Composite-ML-KEM Samen. Der Blob hat dwMagic-WertBCRYPT_COMPOSITE_MLKEM_PRIVATE_IRTF_SEED_MAGIC und das Schlüsselfeld enthält den 32-Byte IRTF Composite-ML-KEM Seed pro CFRG Concrete Hybrid KEMs, sodass cbKey derzeit immer 32ist.

Requirements

Siehe auch

BCryptGenerateKeyPair

BCryptImportKeyPair

BCryptFinalizeKeyPair

BCryptExportKey

BCryptGetProperty

BCryptSetProperty

BCryptEncapsulate

BCryptDecapsulate