Identificateurs de propriété primitive de chiffrement

Cet article explique les identificateurs de propriété primitive de chiffrement utilisés avec les fonctions BCryptGetProperty et BCryptSetProperty . Découvrez comment ces valeurs permettent d’identifier les propriétés dans les algorithmes de chiffrement.

BCRYPT_ALGORITHM_NAME

L"AlgorithmName »

Chaîne Unicode terminée par null qui contient le nom de l’algorithme.

BCRYPT_AUTH_TAG_LENGTH

L"AuthTagLength »

Longueurs de balise d’authentification prises en charge par l’algorithme. Cette propriété est une structure BCRYPT_AUTH_TAG_LENGTHS_STRUCT . Cette propriété s’applique uniquement aux algorithmes.

BCRYPT_BLOCK_LENGTH

L"BlockLength »

Taille, en octets, d’un bloc de chiffrement pour l’algorithme. Cette propriété s’applique uniquement aux algorithmes de chiffrement de bloc. Ce type de données est un DWORD.

BCRYPT_BLOCK_SIZE_LIST

L"BlockSizeList »

Liste des longueurs de bloc prises en charge par un algorithme de chiffrement. Ce type de données est un tableau de DWORDs. Le nombre d’éléments du tableau peut être déterminé en divisant le nombre d’octets récupérés par la taille d’un seul DWORD.

BCRYPT_CHAINING_MODE

L"ChainingMode »

Pointeur vers une chaîne Unicode terminée par null qui représente le mode chaînage de l’algorithme de chiffrement. Cette propriété peut être définie sur un handle d’algorithme ou un handle de clé sur l’une des valeurs suivantes.

Identificateur	Valeur	Descriptif
BCRYPT_CHAIN_MODE_CBC	L"ChainingModeCBC »	Définit le mode chaînage de l’algorithme sur le chaînage de blocs de chiffrement.
BCRYPT_CHAIN_MODE_CCM	L"ChainingModeCCM »	Définit le mode chaînage de l’algorithme sur compteur avec CBC-MAC mode (CCM). Prend en charge les longueurs de clé de 128, 192 et 256 bits. Note: Cette valeur est prise en charge à partir de Windows Vista avec SP1.
BCRYPT_CHAIN_MODE_CFB	L"ChainingModeCFB »	Définit le mode chaînage de l’algorithme pour chiffrer les commentaires.
BCRYPT_CHAIN_MODE_ECB	L"ChainingModeECB »	Définit le mode chaînage de l’algorithme sur le codebook électronique.
BCRYPT_CHAIN_MODE_GCM	L"ChainingModeGCM »	Définit le mode chaînage de l’algorithme sur Galois/counter mode (GCM). Prend en charge les longueurs de clé de 128, 192 et 256 bits. Note: Cette valeur est prise en charge à partir de Windows Vista avec SP1.
BCRYPT_CHAIN_MODE_NA	L"ChainingModeN/A »	L’algorithme ne prend pas en charge le chaînage.

BCRYPT_DH_PARAMETERS

L"DHParameters »

Spécifie les paramètres à utiliser avec une clé Diffie-Hellman. Ce type de données est un pointeur vers une structure BCRYPT_DH_PARAMETER_HEADER . Cette propriété ne peut être définie que et doit être définie pour la clé avant la fin de la clé.

BCRYPT_DSA_PARAMETERS

L"DSAParameters »

Spécifie les paramètres à utiliser avec une clé DSA. Cette propriété est une structure BCRYPT_DSA_PARAMETER_HEADER ou BCRYPT_DSA_PARAMETER_HEADER_V2 . Cette propriété ne peut être définie que et doit être définie pour la clé avant la fin de la clé.

Windows 8 : À compter de Windows 8, cette propriété peut être une structure BCRYPT_DSA_PARAMETER_HEADER_V2 . Utilisez cette structure si la taille de clé dépasse 1024 bits et est inférieure ou égale à 3072 bits. Si la taille de la clé est supérieure ou égale à 512, mais inférieure ou égale à 1 024 bits, utilisez la structure BCRYPT_DSA_PARAMETER_HEADER .

BCRYPT_EFFECTIVE_KEY_LENGTH

L"EffectiveKeyLength »

Taille, en bits, de la longueur effective d’une clé RC2. Ce type de données est un DWORD.

BCRYPT_HASH_BLOCK_LENGTH

L"HashBlockLength »

Taille, en octets, du bloc pour un hachage. Cette propriété s’applique uniquement aux algorithmes de hachage. Ce type de données est un DWORD.

BCRYPT_HASH_LENGTH

L"HashDigestLength »

Taille, en octets, de la valeur de hachage d’un fournisseur de hachage. Ce type de données est un DWORD.

BCRYPT_HASH_OID_LIST

L"HashOIDList »

Liste des identificateurs d’objet de hachage codés en DER (OID). Cette propriété est une structure BCRYPT_OID_LIST . Cette propriété ne peut être lue que.

BCRYPT_INITIALIZATION_VECTOR

L"IV »

Contient le vecteur d’initialisation (IV) pour une clé. Cette propriété s’applique uniquement aux clés.

BCRYPT_KEM_SHARED_SECRET_LENGTH

L"BCRYPT_KEM_SHARED_SECRET_LENGTH »

Taille, en octets, du secret partagé pour une clé de mécanisme d’encapsulation de clé (KEM). Ce type de données est un DWORD.

BCRYPT_KEM_CIPHERTEXT_LENGTH

L"BCRYPT_KEM_CIPHERTEXT_LENGTH »

Taille, en octets, du texte chiffré pour une clé de mécanisme d’encapsulation de clé (KEM). Ce type de données est un DWORD.

BCRYPT_KEY_LENGTH

L"KeyLength »

Taille, en bits, de la valeur de clé d’un fournisseur de clés symétrique. Ce type de données est un DWORD.

BCRYPT_KEY_LENGTHS

L"KeyLengths »

Longueurs de clé prises en charge par l’algorithme. Cette propriété est une structure BCRYPT_KEY_LENGTHS_STRUCT . Cette propriété s’applique uniquement aux algorithmes.

BCRYPT_KEY_OBJECT_LENGTH

L"KeyObjectLength »

Cette propriété n’est pas utilisée. La propriété BCRYPT_OBJECT_LENGTH est utilisée pour obtenir ces informations.

BCRYPT_KEY_STRENGTH

L"KeyStrength »

Nombre de bits dans la clé. Ce type de données est un DWORD. Cette propriété s’applique uniquement aux clés.

BCRYPT_MESSAGE_BLOCK_LENGTH

L"MessageBlockLength »

Cela peut être défini sur n’importe quel handle de clé dont le mode chaînage de la CFB est défini. Par défaut, cette propriété est définie sur 1 pour la base de données 8 bits. La définition de la taille de bloc en octets entraîne l’utilisation de la base de données de bloc complet. Pour les clés XTS, il est utilisé pour définir la taille, en octets, de l’unité de données XTS (généralement 512 ou 4096).

BCRYPT_MULTI_OBJECT_LENGTH

L"MultiObjectLength »

Cette propriété retourne un BCRYPT_MULTI_OBJECT_LENGTH_STRUCT, qui contient des informations nécessaires pour calculer la taille d’une mémoire tampon d’objet. Cette propriété est uniquement prise en charge sur les versions du système d’exploitation qui prennent en charge la fonction BCryptCreateMultiHash .

BCRYPT_OBJECT_LENGTH

L"ObjectLength »

Taille, en octets, du sous-objet d’un fournisseur. Ce type de données est un DWORD. Actuellement, les fournisseurs d’algorithmes de hachage et de chiffrement symétrique utilisent des mémoires tampons allouées par l’appelant pour stocker leurs sous-objets. Par exemple, le fournisseur de hachage vous oblige à allouer de la mémoire pour l’objet de hachage obtenu avec la fonction BCryptCreateHash . Cette propriété fournit la taille de mémoire tampon de l’objet d’un fournisseur afin de pouvoir allouer de la mémoire pour l’objet créé par le fournisseur.

BCRYPT_PADDING_SCHEMES

L"PaddingSchemes »

Représente le schéma de remplissage du fournisseur d’algorithmes RSA. Ce type de données est un DWORD. Il peut s’agir de l’une des valeurs suivantes :

Identificateur	Valeur	Descriptif
BCRYPT_SUPPORTED_PAD_ROUTER	0x00000001	Le fournisseur prend en charge le remplissage ajouté par le routeur.
BCRYPT_SUPPORTED_PAD_PKCS1_ENC	0x00000002	Le fournisseur prend en charge le schéma de remplissage de chiffrement PKCS1.
BCRYPT_SUPPORTED_PAD_PKCS1_SIG	0x00000004	Le fournisseur prend en charge le schéma de remplissage de signature PKCS1.
BCRYPT_SUPPORTED_PAD_OAEP	0x00000008	Le fournisseur prend en charge le schéma de remplissage OAEP.
BCRYPT_SUPPORTED_PAD_PSS	0x00000010	Le fournisseur prend en charge le schéma de remplissage PSS.

BCRYPT_PARAMETER_SET_NAME

L"ParameterSetName »

Cet identificateur doit être défini sur BCrypt ML-DSA et ML-KEM clés avant de pouvoir être finalisées. La propriété peut être définie sur l’une des valeurs suivantes.

PQ-DSA valeurs de propriété pour BCRYPT_PARAMETER_SET_NAME :

Identificateur	Valeur
BCRYPT_MLDSA_PARAMETER_SET_44	L"44"
BCRYPT_MLDSA_PARAMETER_SET_65	L"65"
BCRYPT_MLDSA_PARAMETER_SET_87	L"87"

ML-KEM valeurs de propriété pour BCRYPT_PARAMETER_SET_NAME :

Identificateur	Valeur
BCRYPT_MLKEM_PARAMETER_SET_512	L"512"
BCRYPT_MLKEM_PARAMETER_SET_768	L"768"
BCRYPT_MLKEM_PARAMETER_SET_1024	L"1024"

BCRYPT_PROVIDER_HANDLE

L"ProviderHandle »

Handle du fournisseur CNG qui a créé l’objet passé dans le paramètre hObject . Ce type de données est un BCRYPT_ALG_HANDLE. Cette propriété ne peut être récupérée que ; il ne peut pas être défini.

BCRYPT_SIGNATURE_LENGTH

L"SignatureLength »

Taille, en octets, de la longueur d’une signature pour une clé. Ce type de données est un DWORD. Cette propriété s’applique uniquement aux clés. Cette propriété ne peut être récupérée que ; il ne peut pas être défini.

Spécifications

Contenu connexe

Pseudo-handles d’algorithme CNG

Identificateurs d’algorithme CNG