Note
某些資訊與一款尚未正式發行的產品有關,該產品在正式推出之前可能會進行大幅修改。 Microsoft 對於此處提供的資訊,不做任何明確或隱含的保證。 本主題所述的功能可在 Windows Insider Preview發行前版本取得。
此結構可用來匯入和匯出后量子數位簽名演算法的金鑰(PQDSA)。 The BCRYPT_PQDSA_KEY_BLOB structure is used as a header for a Post-Quantum Digital Signature algorithm (PQDSA) public key (byte-encoded encapsulation key) or private keyBLOB in memory.
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
The dwMagic field is a 4-byte value that indicates the format of the key being used. 定義下列值:
| Value | Meaning |
|---|---|
BCRYPT_MLDSA_PUBLIC_MAGIC0x4B505344 |
結構代表公鑰。 |
BCRYPT_MLDSA_PRIVATE_MAGIC0x4B535344 |
結構代表展開的私鑰。 |
BCRYPT_MLDSA_PRIVATE_SEED_MAGIC0x53535344 |
結構代表私用種子。 |
cbParameterSet
緩衝區 parameterSet 的長度,以位元組為單位,緊接在 結構之後。 這個緩衝區包含 Null 終止的 Unicode 字串,可識別索引鍵的參數集。 目前支援以下值:
| parameterSet | cbParameterSet | Meaning |
|---|---|---|
BCRYPT_MLDSA_PARAMETER_SET_44L"44" |
6 | ML-DSA-44,安全性類別 2。 |
BCRYPT_MLDSA_PARAMETER_SET_65L"65" |
6 | ML-DSA-65,安全性類別 3。 |
BCRYPT_MLDSA_PARAMETER_SET_87L"87" |
6 | ML-DSA-87,安全性類別 5。 |
cbKey
The length, in bytes, of the buffer key directly following parameterSet. 此大小是靜態的,視使用中的金鑰格式和參數而定。
Remarks
Post-Quantum 數位簽名演算法的取用者會使用與 CNG 支援的現有(非後量子)數位簽名演算法相同的 BCrypt API 子集,以執行演算法支援的作業。 These are:
- Algorithm handle manipulation: BCryptOpenAlgorithmProvider, BCryptCloseAlgorithmProvider
- Key management: BCryptGenerateKeyPair, BCryptImportKeyPair, BCryptExportKey, BCryptDestroyKey, BCryptFinalizeKeyPair
- Signature generation/verification: BCryptSignHash, BCryptVerifySignature
- Updating/Querying properties: BCryptGetProperty, BCryptSetProperty
Requirements
| Requirement | Value |
|---|---|
| 最低支援的用戶端 | Windows 測試人員 (組建 27843): 開始支援 ML-DSA。 [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 測試人員 (組建 27843): 開始支援 ML-DSA。 [僅限傳統型應用程式] |
| Header | bcrypt.h |