KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

MessageDigest — hashes berekenen en vergelijken

MessageDigest berekent eenrichtingshashes van gegevens. Leer hoe je SHA-256 kiest, bytes verwerkt, de reset na digest begrijpt en resultaten vergelijkt met isEqual.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);

MessageDigest uit java.security berekent een eenrichtingshash van bytes in plaats van gegevens te versleutelen. SHA-256 levert 256 bits, oftewel 32 bytes. Hexadecimale tekst is alleen een weergave van het resultaat; kies bij het omzetten van tekst naar bytes expliciet een tekencodering zoals StandardCharsets.UTF_8.

MessageDigest.getInstance("SHA-256") haalt een implementatie op bij een cryptografische serviceprovider. Als het gevraagde algoritme niet wordt ondersteund, treedt NoSuchAlgorithmException op; Java SE 21 vereist ondersteuning voor SHA-256.

De aanroep md.digest(input) op een instantie van MessageDigest voegt input toe aan de al verzamelde gegevens en voltooit de berekening. Verwerk je gegevens in delen, roep dan eerst update(...) en daarna digest() aan. Na voltooiing keert het object terug naar de begintoestand: de volgende aanroep gaat niet verder met het vorige bericht.

MessageDigest.isEqual(a, b) vergelijkt de lengte en inhoud van de hashes. Vervang deze methode niet door ==, dat arrayverwijzingen vergelijkt. Beschouw de methode niet als een onvoorwaardelijke garantie voor constante tijd bij alle argumenten en in alle omgevingen. Een hash alleen authenticeert de afzender niet en is geen versleuteling.

Deze documentatie gaat over Java SE 21, de runtime van de repository. De runtime in productie is niet bevestigd.

Voorbeelden

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));
    }
}

Resultaat

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen