다음을 통해 공유


BCRYPT_PQDSA_KEY_BLOB structure

Note

일부 정보는 상용 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 이 항목에 설명된 기능은 Windows Insider Preview시험판 버전에서 사용할 수 있습니다.

이 구조는 PQDSA(Post-Quantum Digital Signature Algorithms)에 대한 키를 가져오고 내보내는 데 사용됩니다. 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로 끝나는 유니코드 문자열이 포함되어 있습니다. 현재 지원되는 값은 다음과 같습니다.

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:

Requirements

Requirement Value
지원되는 최소 클라이언트 Windows 참가자(빌드 27843): ML-DSA 대한 지원이 시작됩니다. [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 참가자(빌드 27843): ML-DSA 대한 지원이 시작됩니다. [데스크톱 앱만 해당]
Header bcrypt.h