struktura BCRYPT_PQDSA_KEY_BLOB

Note

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed jego wydaniem komercyjnym. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do podanych tutaj informacji. Funkcje złożone opisane w tym temacie są dostępne w wersjach wstępnych Windows Insider Preview.

Ta struktura służy do importowania i eksportowania kluczy dla algorytmów podpisu cyfrowego Post-Quantum (PQDSA). Struktura BCRYPT_PQDSA_KEY_BLOB jest używana jako nagłówek klucza publicznego algorytmu PQDSA (Post-Quantum Digital Signature Algorithm) (klucz hermetyzacji zakodowany w bajtach) lub prywatny kluczBLOB w pamięci.

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

Pole dwMagic jest wartością 4-bajtową, która wskazuje format używanego klucza. Zdefiniowane są następujące wartości:

Value Meaning
BCRYPT_MLDSA_PUBLIC_MAGIC0x4B505344 Struktura reprezentuje klucz publiczny.
BCRYPT_MLDSA_PRIVATE_MAGIC0x4B535344 Struktura reprezentuje rozszerzony klucz prywatny.
BCRYPT_MLDSA_PRIVATE_SEED_MAGIC0x53535344 Struktura reprezentuje prywatny inicjator.
BCRYPT_COMPOSITE_MLDSA_PUBLIC_MAGIC0x4B504D43 Struktura reprezentuje klucz publiczny.
BCRYPT_COMPOSITE_MLDSA_PRIVATE_MAGIC0x4B534D43 Struktura reprezentuje klucz prywatny.

cbParameterSet

Długość buforu parameterSet w bajtach bezpośrednio po strukturę. Ten bufor zawiera ciąg Unicode o wartości null, który identyfikuje zestaw parametrów klucza. Obecnie obsługiwane są następujące wartości:

parameterSet Meaning
BCRYPT_MLDSA_PARAMETER_SET_44L"44" ML-DSA-44, kategoria zabezpieczeń 2.
BCRYPT_MLDSA_PARAMETER_SET_65L"65" ML-DSA-65, kategoria zabezpieczeń 3.
BCRYPT_MLDSA_PARAMETER_SET_87L"87" ML-DSA-87, kategoria zabezpieczeń 5.
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_44_ECDSA_P256_SHA256L"44-ECDSA-P256-SHA256" Złożone ML-DSA-44 i ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P256_SHA512L"65-ECDSA-P256-SHA512" Złożone ML-DSA-65 i ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P384_SHA512L"65-ECDSA-P384-SHA512" Złożone ML-DSA-65 i ECDSA P384
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_87_ECDSA_P384_SHA512L"87-ECDSA-P384-SHA512" Złożone ML-DSA-87 i ECDSA P384

cbKey

Długość klucza buforu w bajtach bezpośrednio po parametrzeSet. Ten rozmiar jest statyczny i zależy od formatu klucza i parametru ustawionego w użyciu.

Remarks

Konsumenci algorytmów podpisu cyfrowego Post-Quantum będą używać tego samego podzestawu interfejsu API BCrypt co istniejące algorytmy podpisów cyfrowych (innych niż kwantowe) obsługiwane przez CNG w celu wykonywania operacji obsługiwanych przez algorytmy. Są to:

Requirements

Requirement Value
Minimalny obsługiwany klient Windows 11 24H2: Rozpoczyna się obsługa ML-DSA. [Tylko aplikacje klasyczne]
Minimalna obsługiwana wersja serwera Windows Server 2025: Rozpoczyna się obsługa ML-DSA. [Tylko aplikacje klasyczne]
Header bcrypt.h