Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
- Manipulowanie uchwytem algorytmu: BCryptOpenAlgorithmProvider, BCryptCloseAlgorithmProvider
- Zarządzanie kluczami: BCryptGenerateKeyPair, BCryptImportKeyPair, BCryptExportKey, BCryptDestroyKey, BCryptFinalizeKeyPair
- Generowanie/weryfikacja podpisu: BCryptSignHash, BCryptVerifySignature
- Aktualizowanie/wykonywanie zapytań właściwości: BCryptGetProperty, BCryptSetProperty
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 |