BCRYPT_PQDSA_KEY_BLOB結構

Note

某些資訊與一款尚未正式發行的產品有關,該產品在正式推出之前可能會進行大幅修改。 Microsoft 對於此處提供的資訊,不做任何明確或隱含的保證。 本主題中描述的綜合功能可在 Windows Insider Preview 的預發布版本中取得。

此結構可用來匯入和匯出后量子數位簽名演算法的金鑰(PQDSA)。 BCRYPT_PQDSA_KEY_BLOB結構用作後量子數位簽章演算法(PQDSA)公鑰(位元組編碼封裝金鑰)或私鑰BLOB 記憶體的標頭。

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

dwMagic 欄位是一個 4 位元組的值,表示所使用的金鑰格式。 定義下列值:

Value Meaning
BCRYPT_MLDSA_PUBLIC_MAGIC0x4B505344 結構代表公鑰。
BCRYPT_MLDSA_PRIVATE_MAGIC0x4B535344 結構代表展開的私鑰。
BCRYPT_MLDSA_PRIVATE_SEED_MAGIC0x53535344 結構代表私用種子。
BCRYPT_COMPOSITE_MLDSA_PUBLIC_MAGIC0x4B504D43 結構代表公鑰。
BCRYPT_COMPOSITE_MLDSA_PRIVATE_MAGIC0x4B534D43 該結構代表私鑰。

cbParameterSet

緩衝區 parameterSet 的長度,以位元組為單位,緊接在 結構之後。 這個緩衝區包含 Null 終止的 Unicode 字串,可識別索引鍵的參數集。 目前支援以下值:

parameterSet Meaning
BCRYPT_MLDSA_PARAMETER_SET_44L"44" ML-DSA-44,安全性類別 2。
BCRYPT_MLDSA_PARAMETER_SET_65L"65" ML-DSA-65,安全性類別 3。
BCRYPT_MLDSA_PARAMETER_SET_87L"87" ML-DSA-87,安全性類別 5。
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_44_ECDSA_P256_SHA256L"44-ECDSA-P256-SHA256" 複合 ML-DSA-44 與 ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P256_SHA512L"65-ECDSA-P256-SHA512" 複合 ML-DSA-65 與 ECDSA P256
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_65_ECDSA_P384_SHA512L"65-ECDSA-P384-SHA512" 複合 ML-DSA-65 與 ECDSA P384
BCRYPT_COMPOSITE_MLDSA_PARAMETER_SET_87_ECDSA_P384_SHA512L"87-ECDSA-P384-SHA512" 複合 ML-DSA-87 與 ECDSA P384

cbKey

ParameterSet 之後緩衝區鍵的長度(以位元組為單位)。 此大小是靜態的,視使用中的金鑰格式和參數而定。

Remarks

Post-Quantum 數位簽名演算法的取用者會使用與 CNG 支援的現有(非後量子)數位簽名演算法相同的 BCrypt API 子集,以執行演算法支援的作業。 這些包括:

Requirements

Requirement Value
最低支援的用戶端 Windows 11 24H2: ML-DSA 支援開始。 [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2025: ML-DSA 開始支持。 [僅限傳統型應用程式]
Header bcrypt.h