TypeError: crypto.createCipher is not a function
crypto.createCipher și crypto.createDecipher au fost eliminate în Node 22, după ani de depreciere (DEP0106), pentru că derivau cheia din parolă într-un mod nesigur. Folosește crypto.createCipheriv cu o cheie de 32 de octeți (de exemplu din crypto.scryptSync) și un IV aleator salvat lângă date.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul pare o greșeală de scriere, dar e de fapt o funcție eliminată. createCipher(algoritm, parola) primea o parolă și deriva singur cheia și IV-ul cu o metodă veche (MD5, fără sare), deci același text dădea mereu același rezultat și parola se putea sparge ușor. A fost depreciată din Node 10 (DEP0106) și scoasă complet în Node 22.
Codul vechi, scris pentru Node 14-20, mergea cu un avertisment. După actualizarea la Node 22 sau 24, crypto.createCipher e undefined, iar apelul dă is not a function.
Înlocuirea e createCipheriv(algoritm, cheie, iv): cheia are lungimea exactă cerută de algoritm, iar IV-ul se generează aleator la fiecare criptare și se salvează împreună cu datele.
Atenție: datele criptate vechi cu createCipher nu se pot decripta direct cu createCipheriv și o cheie nouă. Ai nevoie de o migrare care reface cheia veche (EVP_BytesToKey).
De ce apare: cauzele frecvente
1Cod vechi de criptare
const c = crypto.createCipher("aes-256-cbc", parola);
const criptat = c.update(text, "utf8", "hex") + c.final("hex");const cheie = crypto.scryptSync(parola, "sare-aplicatie", 32);
const iv = crypto.randomBytes(16);
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
const criptat = iv.toString("hex") + ":" + c.update(text, "utf8", "hex") + c.final("hex");Cheia derivată cu scryptSync și IV-ul aleator, salvat în față, înlocuiesc derivarea veche și nesigură.
2Decriptarea veche
const d = crypto.createDecipher("aes-256-cbc", parola);const [ivHex, date] = criptat.split(":");
const d = crypto.createDecipheriv("aes-256-cbc", cheie, Buffer.from(ivHex, "hex"));createDecipher a dispărut odată cu createCipher. Decriptarea nouă folosește aceeași cheie și IV-ul salvat.
3Pachet vechi care folosește createCipher
"dependencies": { "cryptr": "^4.0.0" }"dependencies": { "cryptr": "^6.3.0" }Pachetele întreținute au trecut demult pe createCipheriv; actualizează-le înainte de a urca versiunea de Node.
Repară eroarea, direct în pagină
Modulul de criptare a fost scris pentru o versiune veche de Node și folosește crypto.createCipher / crypto.createDecipher, care nu mai există în Node 24. Rescrie cele două funcții cu createCipheriv / createDecipheriv, cu o cheie derivată din parolă și un IV aleator salvat în format iv:date, ca programul să afișeze textul decriptat.
import crypto from "node:crypto";
const PAROLA = "Parola-Aplicatie";
function cripteaza(text) {
const c = crypto.createCipher("aes-256-cbc", PAROLA);
return c.update(text, "utf8", "hex") + c.final("hex");
}
function decripteaza(hex) {
const d = crypto.createDecipher("aes-256-cbc", PAROLA);
return d.update(hex, "hex", "utf8") + d.final("utf8");
}
console.log(decripteaza(cripteaza("IBAN RO49 AAAA 1B31 0075 9384 0000")));IBAN RO49 AAAA 1B31 0075 9384 0000
Indiciu
CHEIE = crypto.scryptSync(PAROLA, "sare-app", 32) și iv = crypto.randomBytes(16), iar IV-ul îl pui în fața datelor, în hex.
Reparația
import crypto from "node:crypto";
const PAROLA = "Parola-Aplicatie";
const CHEIE = crypto.scryptSync(PAROLA, "sare-app", 32);
function cripteaza(text) {
const iv = crypto.randomBytes(16);
const c = crypto.createCipheriv("aes-256-cbc", CHEIE, iv);
return iv.toString("hex") + ":" + c.update(text, "utf8", "hex") + c.final("hex");
}
function decripteaza(salvat) {
const [ivHex, hex] = salvat.split(":");
const d = crypto.createDecipheriv("aes-256-cbc", CHEIE, Buffer.from(ivHex, "hex"));
return d.update(hex, "hex", "utf8") + d.final("utf8");
}
console.log(decripteaza(cripteaza("IBAN RO49 AAAA 1B31 0075 9384 0000")));De ce merge
createCipher și createDecipher au fost eliminate în Node 22, deci sunt undefined. createCipheriv cere explicit cheia (32 de octeți, derivați din parolă cu scryptSync) și un IV de 16 octeți. IV-ul e aleator la fiecare criptare și e salvat în fața datelor, așa că decripteaza îl poate recupera cu split(":") și decodarea din hex.
Alte forme ale mesajului
TypeError: crypto.createDecipher is not a function(node:4120) [DEP0106] DeprecationWarning: crypto.createCipher is deprecated.TypeError: (0 , crypto_1.createCipher) is not a functionTypeError: crypto.createCredentials is not a function
Cum o eviți pe viitor
- Când urci versiunea de Node, citește lista de API-uri eliminate (în „Breaking changes” la fiecare versiune majoră).
- Rulează proiectul cu avertismentele vizibile:
DEP0106apărea de ani buni înainte de eliminare. - Pentru criptare nouă, preferă
aes-256-gcm, care verifică și integritatea datelor. - Păstrează parametrii (algoritm, sare, IV) într-un format versionat, ca să poți migra datele mai târziu.
Întrebări frecvente
Pot reveni la Node 20 ca să meargă?
Temporar, da, dar Node 20 nu mai e întreținut pe termen lung. E mai bine să treci la createCipheriv și să migrezi datele vechi o singură dată.
Cum decriptez datele criptate cu createCipher?
Trebuie refăcută cheia veche: createCipher folosea EVP_BytesToKey cu MD5 pe parolă. Există implementări mici (de exemplu pachetul evp_bytestokey) cu care obții cheia și IV-ul vechi, decriptezi cu createDecipheriv și recriptezi cu metoda nouă.
Erori înrudite
RangeError: Invalid key length 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. TypeError: Invalid initialization vector 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). TypeError: util.isString is not a function Funcțiile vechi util.isString, util.isNumber, util.isFunction, util.isObject, util.isDate, util.isError, util.log și altele au fost eliminate în Node 23. Înlocuiește-le cu verificările standard: typeof x === "string", typeof x === "number", x instanceof Date, console.log. Dacă eroarea vine dintr-un pachet, actualizează-l. Î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.
