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 子集,以執行演算法支援的作業。 這些包括:
- 演算法處理: BCryptOpenAlgorithmProvider、 BCryptCloseAlgorithmProvider
- 金鑰管理: BCryptGenerateKeyPair、 BCryptImportKeyPair、 BCryptExportKey、 BCryptDestroyKey、 BCryptFinalizeKeyPair
- 簽名產生/驗證: BCryptSignHash、 BCryptVerifySignature
- 更新/查詢屬性: BCryptGetProperty、 BCryptSetProperty
Requirements
| Requirement | Value |
|---|---|
| 最低支援的用戶端 | Windows 11 24H2: ML-DSA 支援開始。 [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2025: ML-DSA 開始支持。 [僅限傳統型應用程式] |
| Header | bcrypt.h |