TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received undefined
crypto.pbkdf2 / pbkdf2Sync cer ca ultim argument algoritmul de hash (de exemplu "sha512"), iar tu l-ai omis, cum se făcea în tutorialele vechi. Adaugă-l: crypto.pbkdf2Sync(parola, sare, 100000, 64, "sha512").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
crypto.pbkdf2Sync(parola, sare, iteratii, lungime, digest) derivă o cheie sau un hash de parolă. Ultimul argument, digest, spune ce funcție de hash folosește intern ("sha256", "sha512").
În versiunile foarte vechi de Node, digest era opțional și implicit sha1. Din Node 8 a devenit obligatoriu, dar multe tutoriale și răspunsuri vechi încă îl omit. Fără el, Node aruncă The "digest" argument must be of type string. Received undefined.
Aceeași eroare apare dacă argumentele sunt puse în altă ordine (de exemplu digest pus pe locul lungimii) sau dacă algoritmul e citit dintr-o configurație care lipsește. La varianta asincronă crypto.pbkdf2(..., digest, callback), dacă uiți digest, callback-ul ajunge pe locul lui și primești tot o eroare de tip.
De ce apare: cauzele frecvente
1Exemplu vechi fără algoritm
const hash = crypto.pbkdf2Sync(parola, sare, 100000, 64);const hash = crypto.pbkdf2Sync(parola, sare, 100000, 64, "sha512");Algoritmul de hash e obligatoriu în versiunile actuale de Node.
2Varianta cu callback
crypto.pbkdf2(parola, sare, 100000, 64, (err, cheie) => { ... });crypto.pbkdf2(parola, sare, 100000, 64, "sha512", (err, cheie) => { ... });Callback-ul vine după digest. Fără digest, funcția primește callback-ul în locul lui.
3Algoritm citit dintr-o configurație lipsă
crypto.pbkdf2Sync(parola, sare, 100000, 64, config.algoritm); // undefinedcrypto.pbkdf2Sync(parola, sare, 100000, 64, config.algoritm ?? "sha512");O valoare implicită clară evită undefined când lipsește setarea.
Repară eroarea, direct în pagină
Funcția hashParola, copiată dintr-un tutorial vechi, apelează crypto.pbkdf2Sync fără algoritmul de hash și primește The "digest" argument must be of type string. Adaugă algoritmul sha512, ca programul să afișeze lungimea hash-ului și rezultatul verificării celor două parole.
const crypto = require("crypto");
const SARE = "sare-utilizator-17";
function hashParola(parola) {
return crypto.pbkdf2Sync(parola, SARE, 1000, 32).toString("hex");
}
const salvat = hashParola("Primavara2024!");
console.log(`Lungime hash: ${salvat.length}`);
console.log(`Parola corecta: ${hashParola("Primavara2024!") === salvat}`);
console.log(`Parola gresita: ${hashParola("primavara2024") === salvat}`);Lungime hash: 64 Parola corecta: true Parola gresita: false
Indiciu
Algoritmul e al cincilea argument: crypto.pbkdf2Sync(parola, sare, 1000, 32, "sha512").
Reparația
const crypto = require("crypto");
const SARE = "sare-utilizator-17";
function hashParola(parola) {
return crypto.pbkdf2Sync(parola, SARE, 1000, 32, "sha512").toString("hex");
}
const salvat = hashParola("Primavara2024!");
console.log(`Lungime hash: ${salvat.length}`);
console.log(`Parola corecta: ${hashParola("Primavara2024!") === salvat}`);
console.log(`Parola gresita: ${hashParola("primavara2024") === salvat}`);De ce merge
În Node actual, pbkdf2Sync nu mai are un algoritm implicit, deci al cincilea argument e obligatoriu. Cu "sha512", funcția derivă 32 de octeți, adică 64 de caractere hex. Aceeași parolă cu aceeași sare dă același hash, iar orice diferență dă un hash complet diferit. Într-o aplicație reală, compară hash-urile cu crypto.timingSafeEqual și folosește mai multe iterații.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received type number (64)TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received functionTypeError [ERR_INVALID_ARG_TYPE]: The "keylen" argument must be of type number. Received undefinedTypeError [ERR_CRYPTO_INVALID_DIGEST]: Invalid digest: sha-512
Cum o eviți pe viitor
- Scrie apelurile complet:
pbkdf2Sync(parola, sare, iteratii, lungime, "sha512"). - Pentru parole noi poți folosi
crypto.scryptSync(parola, sare, 64), care nu cere algoritm separat. - Pune parametrii (iterații, lungime, algoritm) în constante cu nume, ca să-i folosești la fel la salvare și la verificare.
- Verifică data exemplelor pe care le copiezi: cele dinainte de Node 8 omit
digest.
Întrebări frecvente
Ce algoritm să aleg?
sha512 sau sha256 sunt alegeri standard. Important e să folosești același algoritm (și același număr de iterații) la crearea hash-ului și la verificarea parolei.
Câte iterații să pun?
Pentru parole, recomandările actuale pentru PBKDF2-SHA512 sunt de ordinul sutelor de mii. Cu cât sunt mai multe, cu atât e mai greu de spart, dar și mai lent la autentificare.
Erori înrudite
Error: Digest method not supported Numele algoritmului dat lui crypto.createHash sau createHmac nu e recunoscut, de obicei o greșeală de scriere: "sha265" în loc de "sha256" sau "SHA-256" cu cratimă. Folosește un nume valid, de exemplu "sha256", "sha512" sau "md5". 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. 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”. Î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.
