...
Eroare Node.js · Buffer, crypto și assert

TypeError: Invalid initialization vector

Pe scurt

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 un split(":") 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

Greșit
JavaScript
crypto.createCipheriv("aes-256-cbc", cheie, "1234567890");
Corect
JavaScript
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

Greșit
JavaScript
const [ivHex, date] = salvat.split(":");
crypto.createDecipheriv("aes-256-cbc", cheie, Buffer.from(ivHex));
Corect
JavaScript
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

Greșit
JavaScript
const [ivHex, date] = salvat.split("|"); // dar s-a salvat cu ":"
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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")));
După reparație, programul afișează
Lungime IV: 16
Str. Lalelelor 4, Cluj
Indiciu

crypto.randomBytes(16) dă un IV de lungimea potrivită pentru CBC.

Alte forme ale mesajului

  • TypeError [ERR_CRYPTO_INVALID_IV]: Invalid initialization vector
  • TypeError: Invalid initialization vector at Decipheriv.createCipherBase (node:internal/crypto/cipher:121:19)
  • Error: Invalid IV length
  • code: 'ERR_CRYPTO_INVALID_IV'

Cum o eviți pe viitor

  • Generează un IV nou la fiecare criptare: crypto.randomBytes(16) (CBC) sau crypto.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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.