java.security.InvalidKeyException: Invalid AES key length: 10 bytes
O cheie AES trebuie să aibă exact 16, 24 sau 32 de octeți, iar tu ai dat alt număr, de obicei pentru că ai folosit direct o parolă ("parola1234".getBytes()). Derivă cheia din parolă (PBKDF2 sau, în exemple simple, SHA-256) sau generează-o cu KeyGenerator.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
AES lucrează cu chei de 128, 192 sau 256 de biți, adică 16, 24 sau 32 de octeți. new SecretKeySpec(octeti, "AES") acceptă orice lungime, dar la cipher.init(...) cheia e verificată, iar dacă are altă lungime primești InvalidKeyException: Invalid AES key length: N bytes, unde N este lungimea reală.
Cauza clasică: cheia e făcută dintr-o parolă sau dintr-un text oarecare cu getBytes(). Lungimea depinde atunci de text și chiar de caracterele folosite: o literă cu diacritice ocupă 2 octeți în UTF-8.
Corect este ca o parolă să fie transformată în cheie printr-o funcție de derivare (PBKDF2WithHmacSHA256, cu sare și multe iterații) sau ca cheia să fie generată aleator cu KeyGenerator.getInstance("AES") și păstrată în siguranță (de exemplu în Base64, într-un seif de secrete).
De ce apare: cauzele frecvente
1Parola folosită direct drept cheie
SecretKeySpec cheie = new SecretKeySpec("parola1234".getBytes(), "AES");byte[] h = MessageDigest.getInstance("SHA-256")
.digest("parola1234".getBytes(StandardCharsets.UTF_8));
SecretKeySpec cheie = new SecretKeySpec(h, "AES"); // 32 octetiSHA-256 dă mereu 32 de octeți, deci o cheie AES-256 validă. În producție folosește PBKDF2 cu sare, nu un singur hash.
2Cheie generată corect
SecretKeySpec cheie = new SecretKeySpec("cheie".getBytes(), "AES");KeyGenerator g = KeyGenerator.getInstance("AES");
g.init(256);
SecretKey cheie = g.generateKey();KeyGenerator produce o cheie aleatoare, de lungimea cerută.
3Cheia păstrată ca text Base64
byte[] k = cheieText.getBytes(); // "q83vEjRWeJA=..."byte[] k = Base64.getDecoder().decode(cheieText);O cheie salvată în Base64 trebuie decodată. getBytes() dă octeții textului, nu ai cheii, deci o lungime greșită.
Repară eroarea, direct în pagină
Programul criptează și decriptează un mesaj cu AES, dar cheia e făcută direct din parolă și programul se oprește cu InvalidKeyException: Invalid AES key length: 10 bytes. Calculează cheia ca SHA-256 al parolei (32 de octeți), ca programul să afișeze Cheie: 32 octeti și Decriptat: salut.
import java.nio.charset.StandardCharsets;
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
public class Main {
public static void main(String[] args) throws Exception {
String parola = "parola1234";
byte[] octetiCheie = parola.getBytes(StandardCharsets.UTF_8);
System.out.println("Cheie: " + octetiCheie.length + " octeti");
SecretKeySpec cheie = new SecretKeySpec(octetiCheie, "AES");
Cipher c = Cipher.getInstance("AES");
c.init(Cipher.ENCRYPT_MODE, cheie);
byte[] criptat = c.doFinal("salut".getBytes(StandardCharsets.UTF_8));
c.init(Cipher.DECRYPT_MODE, cheie);
System.out.println("Decriptat: " + new String(c.doFinal(criptat), StandardCharsets.UTF_8));
}
}Cheie: 32 octeti Decriptat: salut
Indiciu
MessageDigest.getInstance("SHA-256").digest(parola.getBytes(StandardCharsets.UTF_8))
Reparația
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
public class Main {
public static void main(String[] args) throws Exception {
String parola = "parola1234";
byte[] octetiCheie = MessageDigest.getInstance("SHA-256")
.digest(parola.getBytes(StandardCharsets.UTF_8));
System.out.println("Cheie: " + octetiCheie.length + " octeti");
SecretKeySpec cheie = new SecretKeySpec(octetiCheie, "AES");
Cipher c = Cipher.getInstance("AES");
c.init(Cipher.ENCRYPT_MODE, cheie);
byte[] criptat = c.doFinal("salut".getBytes(StandardCharsets.UTF_8));
c.init(Cipher.DECRYPT_MODE, cheie);
System.out.println("Decriptat: " + new String(c.doFinal(criptat), StandardCharsets.UTF_8));
}
}De ce merge
Parola are 10 caractere, deci 10 octeți, iar AES acceptă doar chei de 16, 24 sau 32 de octeți, de aceea init refuză cheia. SHA-256 transformă orice parolă într-un rezumat de exact 32 de octeți, o cheie AES-256 validă, iar criptarea și decriptarea cu aceeași cheie redau textul inițial. Într-o aplicație reală, cheia se derivă cu PBKDF2 și sare, iar modul recomandat e AES/GCM.
Alte forme ale mesajului
java.security.InvalidKeyException: Invalid AES key length: 20 bytesjava.security.InvalidKeyException: Illegal key sizejava.lang.IllegalArgumentException: Empty key
Cum o eviți pe viitor
- Nu folosi niciodată o parolă direct drept cheie: derivă cheia cu
SecretKeyFactory.getInstance("PBKDF2WithHmacSHA256"). - Generează cheile cu
KeyGeneratorși păstrează-le în Base64 sau într-un seif de secrete, nu în cod. - Verifică lungimea cheii la pornire:
cheie.lengthtrebuie să fie 16, 24 sau 32. - Pentru criptare nouă, alege
AES/GCM/NoPaddingcu un IV aleator pentru fiecare mesaj.
Întrebări frecvente
Ce înseamnă Illegal key size?
Apare pe versiuni vechi de Java 8 care limitau cheile AES la 128 de biți, iar o cheie de 256 era refuzată. Soluția e o versiune de Java actualizată (limita a fost scoasă în 8u161).
De ce lungimea în octeți e diferită de numărul de caractere?
getBytes() codifică textul, implicit în UTF-8: literele simple ocupă un octet, iar ș, ț, ă câte doi. Numără întotdeauna octeții (octeti.length), nu caracterele.
Erori înrudite
java.security.NoSuchAlgorithmException: SHA-3 MessageDigest not available Numele algoritmului dat lui MessageDigest.getInstance (sau Cipher, KeyGenerator) nu există sub forma scrisă. Folosește numele standard exact: SHA-256, SHA-512, SHA3-256, MD5. javax.crypto.IllegalBlockSizeException: Input length must be multiple of 16 when decrypting with padded cipher Textul criptat pe care îl decriptezi nu mai are lungimea originală (multiplu de 16 octeți), de obicei pentru că octeții criptați au fost transformați în String cu new String(...) și înapoi. Păstrează-i ca octeți sau transformă-i cu Base64. javax.crypto.BadPaddingException: Given final block not properly padded. Such issues can arise if a bad key is used during decryption. Decriptarea a mers până la ultimul bloc, dar padding-ul nu are forma corectă, de obicei pentru că decriptezi cu altă cheie (sau alt IV, alt mod) decât la criptare, ori datele au fost modificate. Folosește exact aceeași cheie, același algoritm și aceleași date. java.lang.IllegalArgumentException: Illegal base64 character 2d Base64.getDecoder() a întâlnit un caracter care nu face parte din alfabetul Base64 standard; 2d e codul hexazecimal pentru -, iar 5f pentru _, adică text encodat în varianta URL-safe (ca în tokenurile JWT). Folosește Base64.getUrlDecoder() sau, pentru spații și rânduri noi, getMimeDecoder(). Învață Java de la zero, cu exerciții la fiecare lecție
Curs Java: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
