RangeError [ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH]: Input buffers must have the same byte length
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
const ok = crypto.timingSafeEqual(Buffer.from(primita, "hex"), Buffer.from(corecta, "hex"));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
crypto.timingSafeEqual(tokenPrimit, tokenSalvat);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)
const a = Buffer.from(semnaturaHex);
const b = Buffer.from(semnaturaBase64);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ă 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.
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"}`);
}comanda:101: valid comanda:102: invalid comanda:103: invalid
Indiciu
a.length === b.length && crypto.timingSafeEqual(a, b).
Reparația
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 primita.length === corecta.length && 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"}`);
}De ce merge
Semnătura trunchiată are 16 octeți, iar cea corectă 32, iar timingSafeEqual refuză buffere de lungimi diferite cu RangeError. Cu verificarea primita.length === corecta.length înainte, o semnătură de altă lungime e pur și simplu invalidă, iar timingSafeEqual rulează doar când are sens. A doua semnătură are lungimea corectă, dar conținut diferit, și e respinsă de comparația propriu-zisă.
Alte forme ale mesajului
RangeError: Input buffers must have the same byte lengthTypeError [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
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. Error [ERR_CRYPTO_HASH_FINALIZED]: Digest already called Ai apelat digest() de două ori pe același obiect Hash sau Hmac, sau ai făcut update() după digest(). Un hash se poate finaliza o singură dată: salvează rezultatul lui digest() într-o variabilă și creează un hash nou pentru fiecare text. TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. Î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.
