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 Digital Signature アルゴリズムのコンシューマーは、アルゴリズムでサポートされる操作を実行するために、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 Insider (ビルド 27843): ML-DSA のサポートが開始されます。 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Insider (ビルド 27843): ML-DSA のサポートが開始されます。 [デスクトップ アプリのみ] |
| Header | bcrypt.h |