Java JCA (SunEC, JDK 25)

Fakten und die Prüfungen dahinter

Nichts im Folgenden ist aus einer Dokumentation abgeschrieben. Das Prüfskript content/libraries/verify/java-jca/run.sh hat Java JCA (SunEC, JDK 25) 25.0.4.1 unter Eclipse Adoptium 25.0.4.1+1-LTS am 20. Oktober 2026 im Container-Image maven:3.9.16-eclipse-temurin-25 ausgeführt; die Seite muss mit seiner Ausgabe übereinstimmen, und jeder Fakt führt die zugehörigen Zeilen auf.

• Kodierung von ECDSA-Signaturen

  der

  SHA256withECDSA liefert ASN.1-DER; SHA256withECDSAinP1363Format liefert 64 Byte rohes r‖s.

  Von der Prüfung aufgezeichnet

  fact ecdsa-signature-encoding = der
  evidence ecdsa-signature-encoding: SHA256withECDSAinP1363Format output is 64 bytes

• ECDSA-Nonce

  random

  Zufällige Nonce: Der Testschlüssel aus RFC 6979 signierte dieselbe Nachricht zweimal mit unterschiedlichem Ergebnis.

  Von der Prüfung aufgezeichnet

  fact ecdsa-nonce = random

• Low-S beim Signieren

  either

  s wird nicht normalisiert: Unter 64 Signaturen traten High-S-Werte auf.

  Von der Prüfung aufgezeichnet

  fact ecdsa-low-s-sign = either

• High-S bei der Prüfung

  accepts-high-s

  Eine DER-Signatur, in der s durch n − s ersetzt war, bestand die Prüfung.

  Von der Prüfung aufgezeichnet

  fact ecdsa-low-s-verify = accepts-high-s

• Was der Signaturaufruf hasht

  hashes-message-or-digest

  SHA256withECDSA hasht die Daten; NONEwithECDSA signiert einen vorab berechneten Digest, und diese Signatur bestand mit SHA256withECDSA die Prüfung gegen die Nachricht.

  Von der Prüfung aufgezeichnet

  fact ecdsa-prehash = hashes-message-or-digest

• An die Kurve gebundener Hash

  none

  Der Hash im Algorithmusnamen ist nicht an die Kurve gebunden: Signieren und Prüfen mit SHA256withECDSA funktionierten mit einem P-384-Schlüssel.

  Von der Prüfung aufgezeichnet

  fact ecdsa-hash-curve-binding = none

• Fehlerhafte ECDSA-Signatur

  throws

  Eine rohe Signatur und ein 3-Byte-Blob, an SHA256withECDSA übergeben, lösen SignatureException aus; eine DER-Signatur, an die P1363-Variante übergeben, gibt false zurück.

  Von der Prüfung aufgezeichnet

  fact ecdsa-malformed-signature = throws
  evidence ecdsa-malformed-signature: raw r||s to SHA256withECDSA: throws SignatureException; DER to the P1363 algorithm: false; 3 bytes: throws SignatureException

• ECDSA-Kurven

  P-256P-384P-521

  secp256r1, secp384r1 und secp521r1; secp224r1, secp256k1 und brainpoolP256r1 waren nicht verfügbar.

  Von der Prüfung aufgezeichnet

  fact ecdsa-curves = P-256, P-384, P-521
  evidence ecdsa-curves: P-224 (secp224r1) not available
  evidence ecdsa-curves: secp256k1 (secp256k1) not available
  evidence ecdsa-curves: brainpoolP256r1 (brainpoolP256r1) not available

• EdDSA

  Ed25519Ed448

  Ed25519 und Ed448 über KeyPairGenerator und Signature mit genau diesen Namen.

  Von der Prüfung aufgezeichnet

  fact eddsa = Ed25519, Ed448

• Post-Quanten-Algorithmen

  ML-KEMML-DSA

  ML-KEM-512/768/1024 über javax.crypto.KEM und ML-DSA-44/65/87 über Signature funktionierten; einen KeyPairGenerator für SLH-DSA gibt es nicht.

  Von der Prüfung aufgezeichnet

  fact pqc = ML-KEM, ML-DSA
  evidence pqc: SLH-DSA KeyPairGenerator available: false

• Formate öffentlicher Schlüssel

  spki-der

  Öffentliche Schlüssel werden aus X.509-SPKI in DER geladen; getEncoded() liefert dieselbe Form.

  Von der Prüfung aufgezeichnet

  fact public-key-formats = spki-der
  evidence public-key-formats: getEncoded() of 256-bit key returns X.509 SPKI DER; format X.509

• Formate privater Schlüssel

  pkcs8-derraw-scalar

  Private Schlüssel werden aus PKCS#8 in DER und mit ECPrivateKeySpec aus dem rohen Skalar geladen.

  Von der Prüfung aufgezeichnet

  fact private-key-formats = pkcs8-der, raw-scalar

• PEM-API

  preview

  java.security.PEMDecoder existiert als Preview-API (JEP 470) und dekodierte einen öffentlichen Schlüssel im PEM-Format nur mit --enable-preview.

  Von der Prüfung aufgezeichnet

  fact pem-api = preview
  evidence pem-api: java.security.PEMDecoder present: true (JEP 470, preview in JDK 25; needs --enable-preview)
  evidence pem-api: PEMDecoder.of().decode(PEM text) with --enable-preview: true

Verwendung

import java.nio.charset.StandardCharsets;
import java.security.KeyPair;
import java.security.KeyPairGenerator;
import java.security.Signature;
import java.security.spec.ECGenParameterSpec;

public class Usage {
    public static void main(String[] args) throws Exception {
        KeyPairGenerator generator = KeyPairGenerator.getInstance("EC");
        generator.initialize(new ECGenParameterSpec("secp256r1"));
        KeyPair pair = generator.generateKeyPair();
        byte[] message = "order #1042 approved".getBytes(StandardCharsets.UTF_8);

        // The algorithm name picks the hash AND the encoding:
        // SHA256withECDSA = DER, SHA256withECDSAinP1363Format = raw r||s (JWS, WebCrypto).
        Signature signer = Signature.getInstance("SHA256withECDSAinP1363Format");
        signer.initSign(pair.getPrivate());
        signer.update(message);
        byte[] raw = signer.sign();

        Signature verifier = Signature.getInstance("SHA256withECDSAinP1363Format");
        verifier.initVerify(pair.getPublic());
        verifier.update(message);
        System.out.println("raw bytes: " + raw.length + ", verified: " + verifier.verify(raw));
    }
}