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

RangeError [ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH]: Input buffers must have the same byte length

Pe scurt

crypto.timingSafeEqual(a, b) compară doar buffere de aceeași lungime și aruncă dacă lungimile diferă, de exemplu când semnătura primită e trunchiată sau lipsește. Verifică întâi a.length === b.length și tratează diferența ca „invalid”.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

crypto.timingSafeEqual compară două secvențe de octeți într-un timp care nu depinde de unde apare prima diferență. O folosești la verificarea semnăturilor HMAC, a token-urilor sau a hash-urilor de parole, ca un atacator să nu poată ghici valoarea corectă măsurând cât durează comparația.

Funcția cere ca ambele buffere să aibă exact aceeași lungime; altfel aruncă RangeError cu codul ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH. În practică, lungimile diferă când valoarea primită din afară e invalidă: semnătură trunchiată, token fără partea de semnătură, text în alt format (Base64 în loc de hex).

Asta nu e un bug de securitate, dar dacă nu tratezi cazul, o cerere cu semnătură greșită îți oprește serverul în loc să primească un simplu „invalid”.

De ce apare: cauzele frecvente

1Semnătură primită cu altă lungime

Greșit
JavaScript
const ok = crypto.timingSafeEqual(Buffer.from(primita, "hex"), Buffer.from(corecta, "hex"));
Corect
JavaScript
const a = Buffer.from(primita, "hex");
const b = Buffer.from(corecta, "hex");
const ok = a.length === b.length && crypto.timingSafeEqual(a, b);

Verificarea lungimii nu dezvăluie nimic util (lungimea semnăturii e publică), iar comparația rămâne sigură.

2Texte în loc de buffere

Greșit
JavaScript
crypto.timingSafeEqual(tokenPrimit, tokenSalvat);
Corect
JavaScript
const a = Buffer.from(tokenPrimit);
const b = Buffer.from(tokenSalvat);
const ok = a.length === b.length && crypto.timingSafeEqual(a, b);

Funcția primește doar buffere sau TypedArray; textele dau ERR_INVALID_ARG_TYPE.

3Formate diferite (hex și Base64)

Greșit
JavaScript
const a = Buffer.from(semnaturaHex);
const b = Buffer.from(semnaturaBase64);
Corect
JavaScript
const a = Buffer.from(semnaturaHex, "hex");
const b = Buffer.from(semnaturaCalculata, "hex");

Transformă ambele valori din același format, ca să compari aceiași octeți.

Repară tu

Repară eroarea, direct în pagină

Funcția verifica compară semnăturile HMAC primite cu cele corecte folosind crypto.timingSafeEqual, dar a treia semnătură e trunchiată și programul se oprește cu RangeError [ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH]: Input buffers must have the same byte length. Tratează semnăturile de altă lungime ca invalide, ca programul să afișeze rezultatul pentru toate cele trei mesaje.

Codul care dă eroarea
JavaScript
const crypto = require("crypto");

const SECRET = "cheie-de-test";
const semneaza = (mesaj) => crypto.createHmac("sha256", SECRET).update(mesaj).digest("hex");

function verifica(mesaj, semnatura) {
  const primita = Buffer.from(semnatura, "hex");
  const corecta = Buffer.from(semneaza(mesaj), "hex");
  return crypto.timingSafeEqual(primita, corecta);
}

const primite = [
  { mesaj: "comanda:101", semnatura: semneaza("comanda:101") },
  { mesaj: "comanda:102", semnatura: semneaza("comanda:999") },
  { mesaj: "comanda:103", semnatura: semneaza("comanda:103").slice(0, 32) },
];

for (const p of primite) {
  console.log(`${p.mesaj}: ${verifica(p.mesaj, p.semnatura) ? "valid" : "invalid"}`);
}
După reparație, programul afișează
comanda:101: valid
comanda:102: invalid
comanda:103: invalid
Indiciu

a.length === b.length && crypto.timingSafeEqual(a, b).

Alte forme ale mesajului

  • RangeError: Input buffers must have the same byte length
  • TypeError [ERR_INVALID_ARG_TYPE]: The "buf1" argument must be an instance of ArrayBuffer, Buffer, TypedArray, or DataView. Received type string ('abc')

Cum o eviți pe viitor

  • Scrie o funcție mică egaleSigur(a, b) care verifică lungimea și apoi apelează timingSafeEqual, și folosește-o peste tot.
  • Transformă valorile primite din același format ca cele calculate ("hex" cu "hex").
  • Tratează orice valoare primită din afară ca posibil invalidă: întoarce „invalid”, nu lăsa excepția să oprească serverul.
  • Nu compara semnături cu ===: diferența de timp poate fi exploatată.

Întrebări frecvente

E sigur să verific întâi lungimea?

Da. Lungimea unei semnături HMAC-SHA256 e mereu aceeași (32 de octeți) și e cunoscută de oricine. Ce trebuie protejat e conținutul, iar comparația lui rămâne în timp constant.

De ce nu pot folosi ===?

=== se oprește la primul caracter diferit, deci răspunde puțin mai repede pentru valori greșite de la început. Cu destule măsurători, un atacator poate ghici semnătura caracter cu caracter.

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.