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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Al treilea argument al lui createCipheriv(algoritm, cheie, iv) este vectorul de inițializare: o valoare aleatoare, nesecretă, care face ca același text criptat de două ori să arate diferit. Lungimea lui depinde de modul algoritmului: 16 octeți pentru CBC și CTR (cât un bloc AES), recomandat 12 octeți pentru GCM.
Invalid initialization vector (codul ERR_CRYPTO_INVALID_IV) înseamnă că IV-ul are o lungime greșită sau e gol. Cauze frecvente:
- IV scris ca text scurt (
"abc","1234567890"); - IV salvat în hex (32 de caractere), dar citit cu
Buffer.from(iv)fără"hex"(32 de octeți în loc de 16); - IV-ul și textul criptat salvate împreună (
iv:date), dar despărțite greșit la decriptare, de exemplu unsplit(":")care întoarce un șir gol.
Afișează iv.length înainte de apel ca să vezi ce primește funcția.
De ce apare: cauzele frecvente
1IV scris ca text
crypto.createCipheriv("aes-256-cbc", cheie, "1234567890");const iv = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-cbc", cheie, iv);"1234567890" are doar 10 octeți. randomBytes(16) dă exact cât cere CBC și e și aleator, cum trebuie.
2IV hex citit fără codificare
const [ivHex, date] = salvat.split(":");
crypto.createDecipheriv("aes-256-cbc", cheie, Buffer.from(ivHex));const [ivHex, date] = salvat.split(":");
crypto.createDecipheriv("aes-256-cbc", cheie, Buffer.from(ivHex, "hex"));32 de caractere hex reprezintă 16 octeți doar dacă sunt decodate ca hex.
3IV gol după despărțire
const [ivHex, date] = salvat.split("|"); // dar s-a salvat cu ":"const [ivHex, date] = salvat.split(":");Cu separatorul greșit, split întoarce tot textul într-o singură bucată, iar IV-ul ajunge greșit sau gol.
Repară eroarea, direct în pagină
Funcția cripteaza folosește ca IV textul "magazin" și primește Invalid initialization vector. Generează un IV corect pentru aes-256-cbc (16 octeți aleatori) și păstrează-l lângă textul criptat, cum face deja formatul iv:date, ca programul să afișeze lungimea IV-ului și textul decriptat.
const crypto = require("crypto");
const cheie = crypto.scryptSync("Parola-Magazin", "sare-magazin", 32);
function cripteaza(text) {
const iv = Buffer.from("magazin");
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
const date = Buffer.concat([c.update(text, "utf8"), c.final()]);
return iv.toString("hex") + ":" + date.toString("hex");
}
function decripteaza(salvat) {
const [ivHex, dateHex] = salvat.split(":");
const iv = Buffer.from(ivHex, "hex");
console.log(`Lungime IV: ${iv.length}`);
const d = crypto.createDecipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([d.update(dateHex, "hex"), d.final()]).toString("utf8");
}
console.log(decripteaza(cripteaza("Str. Lalelelor 4, Cluj")));Lungime IV: 16 Str. Lalelelor 4, Cluj
Indiciu
crypto.randomBytes(16) dă un IV de lungimea potrivită pentru CBC.
Reparația
const crypto = require("crypto");
const cheie = crypto.scryptSync("Parola-Magazin", "sare-magazin", 32);
function cripteaza(text) {
const iv = crypto.randomBytes(16);
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
const date = Buffer.concat([c.update(text, "utf8"), c.final()]);
return iv.toString("hex") + ":" + date.toString("hex");
}
function decripteaza(salvat) {
const [ivHex, dateHex] = salvat.split(":");
const iv = Buffer.from(ivHex, "hex");
console.log(`Lungime IV: ${iv.length}`);
const d = crypto.createDecipheriv("aes-256-cbc", cheie, iv);
return Buffer.concat([d.update(dateHex, "hex"), d.final()]).toString("utf8");
}
console.log(decripteaza(cripteaza("Str. Lalelelor 4, Cluj")));De ce merge
AES lucrează pe blocuri de 16 octeți, iar modul CBC cere un IV exact de mărimea unui bloc; "magazin" avea 7 octeți. crypto.randomBytes(16) dă un IV corect și diferit la fiecare criptare. Fiind salvat în față, în hex, decriptarea îl recuperează cu Buffer.from(ivHex, "hex") și obține din nou 16 octeți.
Alte forme ale mesajului
TypeError [ERR_CRYPTO_INVALID_IV]: Invalid initialization vectorTypeError: Invalid initialization vector at Decipheriv.createCipherBase (node:internal/crypto/cipher:121:19)Error: Invalid IV lengthcode: 'ERR_CRYPTO_INVALID_IV'
Cum o eviți pe viitor
- Generează un IV nou la fiecare criptare:
crypto.randomBytes(16)(CBC) saucrypto.randomBytes(12)(GCM). - Salvează IV-ul împreună cu textul criptat, de exemplu
iv.toString("hex") + ":" + date, și decodează-l cu aceeași codificare. - Nu reutiliza același IV cu aceeași cheie, mai ales la GCM.
- Verifică lungimea înainte de decriptare:
if (iv.length !== 16) throw new Error("IV invalid").
Întrebări frecvente
IV-ul trebuie ținut secret?
Nu. Secretă e doar cheia. IV-ul se salvează de obicei chiar lângă textul criptat, pentru că e necesar la decriptare.
Pot folosi un IV fix ca să iasă mereu același rezultat?
Nu în aplicații reale: un IV fix face ca textele identice să aibă criptări identice, ceea ce dă informații unui atacator. La GCM, reutilizarea IV-ului cu aceeași cheie e chiar periculoasă.
Erori înrudite
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. Error: error:1C800064:Provider routines::bad decrypt Decriptarea a eșuat la final(): cheia sau IV-ul folosite la decriptare nu sunt aceleași cu cele de la criptare (sau datele s-au stricat), așa că padding-ul nu iese corect. Folosește exact aceeași cheie, același algoritm și același IV ca la criptare. Error: Unsupported state or unable to authenticate data La AES-GCM, verificarea autenticității a eșuat la final(): tag-ul, IV-ul sau cheia nu sunt cele de la criptare ori textul criptat a fost modificat. Salvează IV-ul și tag-ul (getAuthTag după final) lângă date și folosește-le neschimbate la decriptare, cu setAuthTag înainte de final(). Î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.
