Aller au contenu principal
Version: 20 R7 BETA

Generate digest

Generate digest ( param ; algorithme {; *} ) -> Résultat

ParamètreTypeDescription
paramBlob, TextBlob ou texte pour lequel obtenir une clé digest
algorithmeIntegerAlgorithme utilisé pour retourner la clé : 0 = Digest MD5, 1 = Digest SHA1, 2 = Digest 4D, 3 = Digest SHA-256, 4 = Digest SHA-512
*OpérateurCrypter digest en Base64URL
RésultatTextValeur de la clé digest

Description

La commande Generate digest retourne la clé digest d’un BLOB ou d’un texte après application d’un algorithme de cryptage.

Passez dans le paramètre algorithme une valeur désignant la fonction de hachage à employer. Vous pouvez utiliser l’une des constantes suivantes, placées dans le thème Type digest :

ConstanteTypeValeurComment
_o_4D REST digestEntier long2*** Constante obsolète ***
MD5 digestEntier long0Algorithme Message Digest 5. Séquence de 128 bits retournée en tant que chaîne de 32 caractères hexadécimaux.
SHA1 digestEntier long1Algorithme Secure Hash 1. Séquence de 160 bits retournée en tant que chaîne de 40 caractères hexadécimaux.
SHA256 digestEntier long3Famille SHA-2. Séquence de 256 bits retournée en tant que chaîne de 64 caractères hexadécimaux.
SHA512 digestEntier long4Famille SHA-2. Séquence de 512 bits retournée en tant que chaîne de 128 caractères hexadécimaux.

Note : Il est fortement déconseillé d'utiliser les algorithmes MD5 ou SHA pour gérer les mots de passe ; si vous souhaitez vérifier des mots de passe, nous recommandons l'utilisation des commandes Generate password hash et Verify password hash.

Par défaut, si le paramètre * est omis, la digest retournée est cyptée en hexadécimal. Passez le paramètre * si vous souhaitez qu'elle soit chiffrée en Base64URL.

La valeur retournée pour un même objet sera identique sur toutes les plates-formes (macOS/Windows). Le calcul est effectué à partir de la représentation en UTF8 du texte passé en paramètre.

Note : Si vous utilisez la commande avec un texte/BLOB vide, elle ne retournera pas void mais une chaîne (par exemple "d41d8cd98f00b204e9800998ecf8427e" pour le MD5.

Exemple 1

Cet exemple vous permet de comparer deux images à l’aide de l’algorithme MD5 :

 var $vPict1;$vPict2 : Picture
 var $FirstBlob;$SecondBlob : Blob
 READ PICTURE FILE("c:\\myPhotos\\photo1.png")
 If(OK=1)
    READ PICTURE FILE("c:\\myPhotos\\photo2.png")
    If(OK=1)
       PICTURE TO BLOB($vPict1;$FirstBlob;".png")
       PICTURE TO BLOB($vPict2;$SecondBlob;".png")
 
       $MD5_1:=Generate digest($FirstBlob;MD5 digest)
       $MD5_2:=Generate digest($SecondBlob;MD5 digest)
 
       If($MD5_1#$MD5_2)
          ALERT("Ces deux images sont différentes.")
       Else
          ALERT("Ces deux images sont identiques.")
       End if
    End if
 End if

Exemple 2

Ces exemples illustrent comment récupérer la clé digest d’un texte :

 $key1:=Generate digest("The quick brown fox jumps over the lazy dog.";MD5 digest)
  // $key1 vaut "e4d909c290d0fb1ca068ffaddf22cbd0"
 $key2:=Generate digest("The quick brown fox jumps over the lazy dog.";SHA1 digest)
  // $key2 vaut "408d94384216f890ff7a0c3528e8bed1e0b01621"

Voir aussi

BASE64 DECODE
BASE64 ENCODE
Generate password hash
Protocole sécurisé
WEB Validate digest