HashVérifieFichier (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions Hash

Disponibilité des algorithmes

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

HashVérifieFichier (Fonction)

En anglais : HashCheckFile

Vérifie le Hash d'un fichier pour un type d'algorithme défini. Il est possible de vérifier :

un hash simple.
un hash avec authentification de message.
un hash obtenu par un algorithme de dérivation de clé qui prend en paramètre un sel (PBKDF2).
Non disponible.

Rappel : Le hachage permet de réaliser un résumé condensé d'un fichier ou d'une chaîne de caractères. Ce résumé est appelé Hash.

Exemple

// Calcul du Hash du fichier "C:\Temp\Fichier.txt"
HashMonFichier est une chaîne
HashMonFichier = HashFichier(HA_MD5_128, "C:\Temp\Fichier.txt")

// Traitement sur le fichier
// ...

// Test si le fichier a été modifié
SI HashVérifieFichier(HA_MD5_128, "C:\Temp\Fichier.txt", ...
HashMonFichier) = Faux ALORS
Info("Le fichier a été modifié.")
FIN

Syntaxe

Vérifier un hash simple Masquer les détails

<Résultat> = HashVérifieFichier(<Type d'algorithme> , <Chemin du fichier> , <Hash>)

<Résultat> : Booléen

Vrai si le résultat du hachage du fichier <Chemin du fichier> par l'algorithme <Type d'algorithme> correspond au paramètre <Hash>,
Faux dans le cas contraire.

<Type d'algorithme> : Constante de type Entier

Indique le type d'algorithme utilisé lors du hachage du fichier <Chemin du fichier> :
Famille MD4 HA_MD4

Famille MD5 HA_MD5_128
Attention : ce type d'algorithme est actuellement déprécié.
Famille MURMUR
HA_MURMUR_1 : Algorithme Murmur version 1 : hash résultat sur 32 bits
HA_MURMUR_2 : Algorithme Murmur version 2 : hash résultat sur 32 bits
HA_MURMUR_2_64A : Algorithme Murmur version 2 : hash résultat sur 64 bits optimisé pour processeurs 64 bits
HA_MURMUR_2_64B : Algorithme Murmur version 2 : hash résultat sur 64 bits optimisé pour processeurs 32 bits
HA_MURMUR_2_A : Algorithme Murmur version 2 incrémentiel : hash résultat sur 32 bits
HA_MURMUR_2_BIG_ENDIAN : Algorithme Murmur version 2 pour machine big-endian: hash résultat sur 32 bits
HA_MURMUR_2_ALIGNE : Algorithme Murmur version 2 pour machine alignée : hash résultat sur 32 bits
HA_MURMUR_3_32 : Algorithme Murmur version 3 : hash résultat sur 32 bits
HA_MURMUR_3_128_X86 : Algorithme Murmur version 3 : hash résultat sur 128 bits optimisé pour processeur 32 bits
HA_MURMUR_3_128_X64 : Algorithme Murmur version 3 : hash résultat sur 128 bits optimisé pour processeur 64 bits
Les constantes de cette famille ne sont pas disponibles.
Famille RIPEMD
HA_RIPEMD_128
HA_RIPEMD_160
Les constantes de cette famille ne sont pas disponibles.
Famille SHA
HA_SHA_160 (aussi appelé SHA-1)
HA_SHA_256 (spécifications FIPS PUB 198)
HA_SHA_256_DOUBLE
HA_SHA_384
HA_SHA_512
Famille SHA-3
HA_SHA3_224
HA_SHA3_256
HA_SHA3_384
HA_SHA3_512
Famille TIGER
HA_TIGER_128
HA_TIGER_160
HA_TIGER_192
Les constantes de cette famille ne sont pas disponibles.
Famille WHIRLPOOL HA_WHIRLPOOL
Non disponible.
Famille CKSUM
HA_CKSUM_8
HA_CKSUM_16
HA_CKSUM_32
HA_CKSUM_64
Les constantes de cette famille ne sont pas disponibles.
Algorithmes MD4 / MD5 / SHA / RIPEMD : fonctions de hachage cryptographiques classiques.
Algorithmes TIGER / WHIRLPOOL : fonctions de hachage ayant de très bonnes propriétés cryptographiques optimisées pour le 64 bits (mais leur utilisation est possible en 32 bits).
Algorithmes CKSUM : fonctions de hachage ne possédant pas de propriété cryptographique, à n'utiliser que pour des contrôles minimaux ou des tables de hachage.
Algorithme MURMUR : fonctions de hachage très rapides et ne possédant pas de propriétés cryptographiques. C'est l'algorithme utilisé pour le "bloom filter" des portefeuilles bitcoin.

<Chemin du fichier> : Chaîne de caractères

Chemin du fichier pour lequel le Hash doit être vérifié.

<Hash> : Chaîne de caractères

Hash du fichier à contrôler. Ce Hash doit être le résultat de la fonction HashFichier précédemment appelée pour le fichier <Chemin du fichier> sur l'algorithme <Type d'algorithme>.

Vérifier un hash avec authentification de message (algorithme HMAC/algorithme MURMUR) Masquer les détails

<Résultat> = HashVérifieFichier(<Type d'algorithme> , <Chemin du fichier> , <Hash> , <Clé secrète>)

<Résultat> : Booléen

Vrai si le résultat du hachage du fichier <Chemin du fichier> par l'algorithme <Type d'algorithme> correspond au paramètre <Hash>,
Faux dans le cas contraire.

<Type d'algorithme> : Constante de type Entier

Indique le type d'algorithme HMAC utilisé lors du hachage du fichier <Chemin du fichier> :
Famille MD4 HA_HMAC_MD4

Famille MD5 HA_HMAC_MD5_128
Attention : ce type d'algorithme est actuellement déprécié.
Famille MURMUR
HA_MURMUR_1 : Algorithme Murmur version 1 : hash résultat sur 32 bits
HA_MURMUR_2 : Algorithme Murmur version 2 : hash résultat sur 32 bits
HA_MURMUR_2_64A : Algorithme Murmur version 2 : hash résultat sur 64 bits optimisé pour processeurs 64 bits
HA_MURMUR_2_64B : Algorithme Murmur version 2 : hash résultat sur 64 bits optimisé pour processeurs 32 bits
HA_MURMUR_2_A : Algorithme Murmur version 2 incrémentiel : hash résultat sur 32 bits
HA_MURMUR_2_BIG_ENDIAN : Algorithme Murmur version 2 pour machine big-endian: hash résultat sur 32 bits
HA_MURMUR_2_ALIGNE : Algorithme Murmur version 2 pour machine alignée : hash résultat sur 32 bits
HA_MURMUR_3_32 : Algorithme Murmur version 3 : hash résultat sur 32 bits
HA_MURMUR_3_128_X86 : Algorithme Murmur version 3 : hash résultat sur 128 bits optimisé pour processeur 32 bits
HA_MURMUR_3_128_X64 : Algorithme Murmur version 3 : hash résultat sur 128 bits optimisé pour processeur 64 bits
Les constantes de cette famille ne sont pas disponibles.
Famille RIPEMD
HA_HMAC_RIPEMD_128
HA_HMAC_RIPEMD_160
Les constantes de cette famille ne sont pas disponibles.
Famille SHA
HA_HMAC_SHA_160
HA_HMAC_SHA_256
HA_HMAC_SHA_256_DOUBLE
HA_HMAC_SHA_384
HA_HMAC_SHA_512
Famille SHA-3
HA_HMAC_SHA3_224
HA_HMAC_SHA3_256
HA_HMAC_SHA3_384
HA_HMAC_SHA3_512
Famille TIGER
HA_HMAC_TIGER_128
HA_HMAC_TIGER_160
HA_HMAC_TIGER_192
Les constantes de cette famille ne sont pas disponibles.
Famille WHIRLPOOL HA_HMAC_WHIRLPOOL
Non disponible.
Algorithmes MD4 / MD5 / SHA / RIPEMD : fonctions de hachage cryptographiques classiques.
Algorithmes TIGER / WHIRLPOOL : fonctions de hachage ayant de très bonnes propriétés cryptographiques optimisées pour le 64 bits (mais leur utilisation est possible en 32 bits).
Algorithme MURMUR : fonctions de hachage très rapides et ne possédant pas de propriétés cryptographiques. C'est l'algorithme utilisé pour le "bloom filter" des portefeuilles bitcoin.

<Chemin du fichier> : Chaîne de caractères

Chemin du fichier pour lequel le Hash doit être vérifié.

<Hash> : Chaîne de caractères

Hash du fichier à contrôler. Ce Hash doit être le résultat de la fonction HashFichier précédemment appelée pour le fichier <Chemin du fichier> sur l'algorithme <Type d'algorithme>.

<Clé secrète> : Chaîne de caractères ou Entier

Clé d'authentification du message. Cette clé doit être identique à celle utilisée pour calculer le Hash.
Ce paramètre ne doit pas être une chaîne vide.

Vérifier un hash obtenu via un algorithme de dérivation de clé qui prend en paramètre un sel (PBKDF2) Masquer les détails

<Résultat> = HashFichier(<Type d'algorithme> , <Chemin du fichier> , <Hash> , <Sel> , <Itération> , <Longueur> [, <Jauge>])

<Résultat> : Buffer

Résultat du hachage du fichier <Chemin du fichier> avec l'algorithme <Type d'algorithme>.
Attention : Ce résultat peut contenir des caractères non affichables.

<Type d'algorithme> : Constante de type Entier

Indique le type d'algorithme pseudo-aléatoire utilisé par PBKDF2 lors du hachage du fichier <Chemin du fichier> :
Famille MD4 HA_PBKDF2_HMAC_MD4
Famille MD5 HA_PBKDF2_HMAC_MD5_128
Attention : ce type d'algorithme est actuellement déprécié.
Famille RIPEMD
HA_PBKDF2_HMAC_RIPEMD_128
HA_PBKDF2_HMAC_RIPEMD_160
Famille SHA
HA_PBKDF2_HMAC_SHA_160
HA_PBKDF2_HMAC_SHA_256
HA_PBKDF2_HMAC_SHA_256_DOUBLE
HA_PBKDF2_HMAC_SHA_384
HA_PBKDF2_HMAC_SHA_512
Famille SHA-3
HA_PBKDF2_HMAC_SHA3_224
HA_PBKDF2_HMAC_SHA3_256
HA_PBKDF2_HMAC_SHA3_384
HA_PBKDF2_HMAC_SHA3_512
Famille TIGER
HA_PBKDF2_HMAC_TIGER_128
HA_PBKDF2_HMAC_TIGER_160
HA_PBKDF2_HMAC_TIGER_192
Famille WHIRLPOOL HA_PBKDF2_HMAC_WHIRLPOOL
Algorithmes MD4 / MD5 / SHA / RIPEMD : fonctions de hachage cryptographiques classiques.
Algorithmes TIGER / WHIRLPOOL : fonctions de hachage ayant de très bonnes propriétés cryptographiques optimisées pour le 64 bits (mais leur utilisation est possible en 32 bits).

<Chemin du fichier> : Chaîne de caractères

Chemin du fichier pour lequel le Hash doit être vérifié.

<Hash> : Chaîne de caractères

Hash du fichier à contrôler. Ce Hash doit être le résultat de la fonction HashFichier précédemment appelée pour le fichier <Chemin du fichier> sur l'algorithme <Type d'algorithme>.

<Sel> : Chaîne de caractères