SYNOPSIS
#include <openssl/evp.h>
int EVP_BytesToKey(const EVP_CIPHER *type,const EVP_MD *md,
const unsigned char *salt,
const unsigned char *data, int datal, int count,
unsigned char *key,unsigned char *iv);
DESCRIPTION
EVP_BytesToKey() dérive (fournit) une clef et un vecteur d'initialisation à partir de plusieurs paramètres. type est l'algorithme de chiffrement pour dériver la clef et le vecteur d'initialisation. md est l'algorithme de signature de message à utiliser. Le paramètre salt est utilisé comme sel dans la dérivation : il devrait pointer vers un tampon de 8 octets ou NULL s'il ne faut pas utiliser de sel. data est un tampon contenant datal octets utilisé pour dériver les données de clef. count est le nombre d'itérations à utiliser. La clef et le vecteur d'initialisation dérivés seront respectivement écrits dans key et iv.NOTES
Une application typique de cette fonction est de dériver du matériel de clef pour un algorithme de chiffrement à partir d'un mot de passe dans le paramètre data.Augmenter le paramètre count ralentit l'algorithme, ce qui rend plus difficile pour un attaquant de réaliser une attaque par force brute utilisant un grand nombre de mots de passe candidats.
Si la taille totale de la clef et du vecteur d'initialisation est inférieure à la taille de l'algorithme de signature est que MD5 est utilisé, alors l'algorithme de dérivation est compatible avec PKCS#5 v1.5, sinon une extension non normalisée est utilisée pour fournir les données supplémentaires.
Les applications les plus récentes devraient utiliser un algorithme plus moderne comme PBKDF2 tel qu’il est défini dans PKCS#5 v2.1 et fourni par PKCS5_PBKDF2_HMAC.
ALGORITHME DE DÉRIVATION DE CLEF
La clef et le vecteur d'initialisation sont dérivés en concaténant D_1, D_2, etc., jusqu'à ce que suffisamment de données soient disponibles pour la clef et le vecteur d'initialisation. D_i est défini comme :
D_i = HASH^count(D_(i-1) || data || salt)
où || indique la concaténation, D_0 est vide, HASH est l'algorithme de signature utilisé, HASH^1(data) est simplement HASH(data), HASH^2(data) est HASH(HASH(data)) et ainsi de suite.
Les octets initiaux sont utilisés pour la clef et les octets suivants pour le vecteur d'initialisation.
VALEURS DE RETOUR
Si data est NULL, alors EVP_BytesToKey() renvoie le nombre d’octets nécessaires pour enregistrer la clef dérivée. Autrement, EVP_BytesToKey() renvoie la taille de la clef en octets, ou 0 en cas d’erreur.HISTORIQUE
TRADUCTION
La traduction de cette page de manuel est maintenue par les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.