CKTIS / Java
MessageDigest — calculer et comparer des condensats
MessageDigest calcule des condensats à sens unique de données. Découvrez comment choisir SHA-256, traiter des octets, comprendre la réinitialisation après digest et comparer les résultats avec isEqual.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest de java.security calcule un condensat à sens unique d’octets au lieu de chiffrer les données. SHA-256 renvoie 256 bits, soit 32 octets. Le texte hexadécimal n’est qu’une représentation du résultat ; lors de la conversion de texte en octets, choisissez explicitement un encodage comme StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") obtient une implémentation auprès d’un fournisseur de services cryptographiques. Si l’algorithme demandé n’est pas pris en charge, une NoSuchAlgorithmException est levée ; Java SE 21 exige la prise en charge de SHA-256.
L’appel md.digest(input) sur une instance de MessageDigest ajoute input aux données déjà accumulées et termine le calcul. Pour traiter les données par blocs, appelez update(...), puis digest(). Une fois le calcul terminé, l’objet revient à son état initial : l’appel suivant ne poursuit pas le message précédent.
MessageDigest.isEqual(a, b) compare la longueur et le contenu des condensats. Ne la remplacez pas par ==, qui compare les références des tableaux. Ne considérez pas cette méthode comme une garantie absolue de temps constant pour tous les arguments et tous les environnements. Un condensat seul n’authentifie pas l’expéditeur et ne constitue pas un chiffrement.
Cette documentation porte sur Java SE 21, l’environnement d’exécution du dépôt. L’environnement d’exécution en production n’a pas été attesté.
Exemples
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HexFormat;
public class DigestExample {
public static void main(String[] args) throws NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] actual = md.digest("abc".getBytes(StandardCharsets.UTF_8));
byte[] expected = HexFormat.of().parseHex(
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad");
System.out.println(HexFormat.of().formatHex(actual));
System.out.println(MessageDigest.isEqual(actual, expected));
}
}Résultat
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.