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

RangeError: Invalid key length

Pe scurt

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

Greșit
JavaScript
const iv = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-cbc", "cheie-secreta", iv);
Corect
JavaScript
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

Greșit
JavaScript
const cheie = Buffer.from(process.env.CHEIE_HEX); // 64 de octeți
Corect
JavaScript
const cheie = Buffer.from(process.env.CHEIE_HEX, "hex"); // 32 de octeți

64 de caractere hex înseamnă 32 de octeți, dar numai dacă le decodezi ca hex.

3Algoritm diferit de lungimea cheii

Greșit
JavaScript
const cheie = crypto.randomBytes(16);
crypto.createCipheriv("aes-256-gcm", cheie, iv);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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")));
După reparație, programul afișează
Lungime cheie: 32
0722 123 456
Indiciu

crypto.scryptSync(PAROLA, "sare-magazin", 32) întoarce un Buffer de 32 de octeți.

Alte forme ale mesajului

  • RangeError [ERR_CRYPTO_INVALID_KEYLEN]: Invalid key length
  • RangeError: 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 cu Buffer.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

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