RangeError: Invalid key length
Cheia dată lui crypto.createCipheriv nu are lungimea cerută de algoritm: aes-256 vrea exact 32 de octeți, aes-128 vrea 16. Nu folosi parola ca text drept cheie: derivă cheia cu crypto.scryptSync(parola, sare, 32) sau folosește o cheie aleatoare de 32 de octeți.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Algoritmii AES au chei de lungime fixă: aes-128-* are nevoie de 16 octeți, aes-192-* de 24, iar aes-256-* de 32. createCipheriv și createDecipheriv verifică lungimea și refuză orice altceva cu RangeError: Invalid key length (codul ERR_CRYPTO_INVALID_KEYLEN).
Cel mai des, cheia e o parolă scrisă ca text ("cheie-secreta" are 13 octeți). Alte cauze: o cheie hex de 64 de caractere citită ca text simplu (Buffer.from(cheie) dă 64 de octeți, nu 32; trebuia Buffer.from(cheie, "hex")), o cheie în base64 citită fără "base64" sau o variabilă de mediu lipsă.
Verifică rapid: console.log(cheie.length) (pentru Buffer) sau Buffer.byteLength(cheie) (pentru string). Trebuie să dea exact numărul cerut de algoritm.
De ce apare: cauzele frecvente
1Parola folosită direct drept cheie
const iv = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-cbc", "cheie-secreta", iv);const cheie = crypto.scryptSync("cheie-secreta", "sare-aplicatie", 32);
const iv = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-cbc", cheie, iv);scryptSync transformă o parolă de orice lungime într-o cheie de exact 32 de octeți, greu de ghicit prin încercări.
2Cheie hex citită ca text
const cheie = Buffer.from(process.env.CHEIE_HEX); // 64 de octețiconst cheie = Buffer.from(process.env.CHEIE_HEX, "hex"); // 32 de octeți64 de caractere hex înseamnă 32 de octeți, dar numai dacă le decodezi ca hex.
3Algoritm diferit de lungimea cheii
const cheie = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-gcm", cheie, iv);const cheie = crypto.randomBytes(32);
crypto.createCipheriv("aes-256-gcm", cheie, iv);Numărul din numele algoritmului e lungimea cheii în biți: 256 de biți = 32 de octeți.
Repară eroarea, direct în pagină
Funcțiile de mai jos criptează și decriptează numărul de telefon al unui client cu aes-256-cbc, dar dau ca cheie direct parola din configurație ("Parola-Magazin"), iar createCipheriv aruncă Invalid key length. Derivă din parolă o cheie de 32 de octeți, ca programul să afișeze lungimea cheii și textul decriptat.
const crypto = require("crypto");
const PAROLA = "Parola-Magazin";
const cheie = PAROLA;
const iv = Buffer.alloc(16, 1);
function cripteaza(text) {
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([c.update(text, "utf8"), c.final()]).toString("hex");
}
function decripteaza(hex) {
const d = crypto.createDecipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([d.update(hex, "hex"), d.final()]).toString("utf8");
}
console.log(`Lungime cheie: ${Buffer.byteLength(cheie)}`);
console.log(decripteaza(cripteaza("0722 123 456")));Lungime cheie: 32 0722 123 456
Indiciu
crypto.scryptSync(PAROLA, "sare-magazin", 32) întoarce un Buffer de 32 de octeți.
Reparația
const crypto = require("crypto");
const PAROLA = "Parola-Magazin";
const cheie = crypto.scryptSync(PAROLA, "sare-magazin", 32);
const iv = Buffer.alloc(16, 1);
function cripteaza(text) {
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([c.update(text, "utf8"), c.final()]).toString("hex");
}
function decripteaza(hex) {
const d = crypto.createDecipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([d.update(hex, "hex"), d.final()]).toString("utf8");
}
console.log(`Lungime cheie: ${Buffer.byteLength(cheie)}`);
console.log(decripteaza(cripteaza("0722 123 456")));De ce merge
aes-256-cbc cere o cheie de exact 256 de biți, adică 32 de octeți, iar parola avea 14. crypto.scryptSync derivă din parolă și o sare o cheie de lungimea cerută, mereu aceeași pentru aceeași parolă, deci decriptarea folosește aceeași cheie ca criptarea. IV-ul fix e doar pentru exemplu; în aplicații reale se generează aleator la fiecare criptare.
Alte forme ale mesajului
RangeError [ERR_CRYPTO_INVALID_KEYLEN]: Invalid key lengthRangeError: Invalid key length at Cipheriv.createCipherBase (node:internal/crypto/cipher:121:19)code: 'ERR_CRYPTO_INVALID_KEYLEN'
Cum o eviți pe viitor
- Generează o cheie o singură dată cu
crypto.randomBytes(32).toString("hex"), păstreaz-o în variabile de mediu și citește-o cuBuffer.from(..., "hex"). - Dacă pornești de la o parolă, derivă cheia cu
crypto.scryptSync(parola, sare, 32). - Verifică la pornire:
if (cheie.length !== 32) throw new Error("CHEIE trebuie să aibă 32 de octeți"). - Pentru date noi, preferă
aes-256-gcm, care verifică și integritatea.
Întrebări frecvente
Pot completa cheia cu spații sau zerouri până la 32?
Tehnic merge, dar e nesigur: o parolă scurtă completată rămâne ușor de ghicit. Folosește scryptSync, care e făcut special pentru asta.
De ce mergea cu crypto.createCipher?
Vechiul createCipher deriva singur cheia din parolă, într-un mod nesigur. A fost eliminat în Node 22, iar createCipheriv cere cheia exactă.
Erori înrudite
TypeError: Invalid initialization vector IV-ul (vectorul de inițializare) dat lui createCipheriv / createDecipheriv nu are lungimea cerută: 16 octeți la aes-*-cbc și aes-*-ctr, de obicei 12 la aes-*-gcm. Generează-l cu crypto.randomBytes(16), salvează-l lângă textul criptat și citește-l cu aceeași codificare (hex sau base64). TypeError: crypto.createCipher is not a function crypto.createCipher și crypto.createDecipher au fost eliminate în Node 22, după ani de depreciere (DEP0106), pentru că derivau cheia din parolă într-un mod nesigur. Folosește crypto.createCipheriv cu o cheie de 32 de octeți (de exemplu din crypto.scryptSync) și un IV aleator salvat lângă date. TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
