BCRYPT_PQDSA_KEY_BLOB structuur

Note

Sommige informatie heeft betrekking op een prereleaseproduct dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt vrijgegeven. Microsoft geeft geen garanties, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt verstrekt. De samengestelde functies die in dit onderwerp worden beschreven, zijn beschikbaar in voorlopige versies van de Windows Insider Preview.

Deze structuur wordt gebruikt voor het importeren en exporteren van sleutels voor Post-Quantum Digital Signature-algoritmen (PQDSA). De BCRYPT_PQDSA_KEY_BLOB structuur wordt gebruikt als een header voor een openbare PQDSA-sleutel (PQDSA)-algoritme (byte-gecodeerde inkapselingssleutel) of persoonlijkesleutel-BLOB in het geheugen.

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

Het veld dwMagic is een 4-bytewaarde die de notatie aangeeft van de sleutel die wordt gebruikt. De volgende waarden worden gedefinieerd:

Value Meaning
BCRYPT_MLDSA_PUBLIC_MAGIC0x4B505344 De structuur vertegenwoordigt een openbare sleutel.
BCRYPT_MLDSA_PRIVATE_MAGIC0x4B535344 De structuur vertegenwoordigt een uitgebreide persoonlijke sleutel.
BCRYPT_MLDSA_PRIVATE_SEED_MAGIC0x53535344 De structuur vertegenwoordigt een privézaad.
BCRYPT_COMPOSITE_MLDSA_PUBLIC_MAGIC0x4B504D43 De structuur vertegenwoordigt een openbare sleutel.
BCRYPT_COMPOSITE_MLDSA_PRIVATE_MAGIC0x4B534D43 De structuur vertegenwoordigt een persoonlijke sleutel.

cbParameterSet

De lengte, in bytes, van de buffer parameterSet direct na de struct. Deze buffer bevat een unicode-tekenreeks met null-beëindiging waarmee de parameterset van de sleutel wordt geïdentificeerd. De volgende waarden worden momenteel ondersteund:

parameterSet Meaning
BCRYPT_MLDSA_PARAMETER_SET_44L"44" ML-DSA-44, beveiligingscategorie 2.
BCRYPT_MLDSA_PARAMETER_SET_65L"65" ML-DSA-65, beveiligingscategorie 3.
BCRYPT_MLDSA_PARAMETER_SET_87L"87" ML-DSA-87, beveiligingscategorie 5.
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_44_ECDSA_P256_SHA256L"44-ECDSA-P256-SHA256" Samengestelde ML-DSA-44 en ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P256_SHA512L"65-ECDSA-P256-SHA512" Samengestelde ML-DSA-65 en ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P384_SHA512L"65-ECDSA-P384-SHA512" Samengestelde ML-DSA-65 en ECDSA P384
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_87_ECDSA_P384_SHA512L"87-ECDSA-P384-SHA512" Samengestelde ML-DSA-87 en ECDSA P384

cbKey

De lengte, in bytes, van de buffersleutel direct na parameterSet. Deze grootte is statisch en is afhankelijk van de sleutelindeling en parameterset die in gebruik zijn.

Remarks

De consumenten van Post-Quantum Digital Signature-algoritmen gebruiken dezelfde subset van de BCrypt-API als de bestaande (niet-Post-Quantum) digitale handtekeningalgoritmen die door CNG worden ondersteund om de bewerkingen uit te voeren die door de algoritmen worden ondersteund. Dit zijn:

Requirements

Requirement Value
Minimaal ondersteunde client Windows 11 24H2: Ondersteuning voor ML-DSA begint. [alleen desktop-apps]
Minimaal ondersteunde server Windows Server 2025: Ondersteuning voor ML-DSA begint. [alleen desktop-apps]
Header bcrypt.h
  • Last updated on