Error: error:1E08010C:DECODER routines::unsupported
OpenSSL nu a putut citi cheia dată (createPrivateKey, createSign, jwt.sign cu RS256): textul nu e un PEM valid. De obicei cheia din .env are \n scrise ca text în loc de rânduri noi sau i-au fost tăiate liniile BEGIN / END. Refă rândurile noi cu .replace(/\\n/g, "\n").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
DECODER routines::unsupported (codul ERR_OSSL_UNSUPPORTED) vine din OpenSSL 3 când îi dai o cheie pe care nu o poate decoda în niciun format cunoscut. Apare la crypto.createPrivateKey, crypto.createSign().sign(cheie), crypto.privateDecrypt și în biblioteci ca jsonwebtoken (algoritmii RS256 / ES256).
O cheie PEM arată așa: o linie -----BEGIN PRIVATE KEY-----, câteva rânduri de base64 și o linie -----END PRIVATE KEY-----, separate prin rânduri noi reale. Problemele tipice:
- cheia a fost pusă pe un singur rând într-o variabilă de mediu, iar
\nau rămas ca două caractere (backslash șin); - lipsesc liniile
BEGIN/ENDsau au fost modificate; - ai dat cheia publică acolo unde trebuia cea privată, ori un secret simplu (
"cheie-secreta") unde se aștepta o cheie RSA / EC; - cheia e criptată cu parolă și nu ai dat
passphrase.
Afișează JSON.stringify(cheie.slice(0, 40)) ca să vezi dacă apar \\n literali.
De ce apare: cauzele frecvente
1Cheia din .env are \n ca text
// .env: PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nMIGHAgEA...\n-----END PRIVATE KEY-----
crypto.createPrivateKey(process.env.PRIVATE_KEY);const pem = process.env.PRIVATE_KEY.replace(/\\n/g, "\n");
crypto.createPrivateKey(pem);replace(/\\n/g, "\n") transformă secvențele text \n în rânduri noi reale, așa cum cere formatul PEM.
2Secret simplu în loc de cheie RSA/EC
jwt.sign(date, "cheie-secreta", { algorithm: "RS256" });jwt.sign(date, "cheie-secreta", { algorithm: "HS256" });
// sau RS256 cu o cheie privată PEM realăRS256 / ES256 au nevoie de o pereche de chei. Un secret text merge doar cu algoritmii HMAC (HS256).
3Liniile BEGIN / END lipsesc
const pem = "MIGHAgEAMBMGByqGSM49AgEGCCqGSM49...";const pem = fs.readFileSync("cheie-privata.pem", "utf8");Citit din fișierul original, PEM-ul are toate liniile exact cum au fost generate.
Repară eroarea, direct în pagină
Cheia privată a aplicației vine din secrete.json, unde a fost lipită pe un singur rând, cu \n scrise ca text. crypto.createPrivateKey nu o poate citi și aruncă DECODER routines::unsupported. Refă rândurile noi înainte de a crea cheia, ca programul să semneze comanda și să afișeze rezultatul verificării.
const fs = require("fs");
const crypto = require("crypto");
const secrete = JSON.parse(fs.readFileSync("secrete.json", "utf8"));
const cheiePrivata = crypto.createPrivateKey(secrete.privateKey);
const cheiePublica = crypto.createPublicKey(cheiePrivata);
const comanda = JSON.stringify({ id: 314, total: 250 });
const semnatura = crypto.sign("sha256", Buffer.from(comanda), cheiePrivata);
console.log(`Tip cheie: ${cheiePrivata.asymmetricKeyType}`);
console.log(`Semnatura valida: ${crypto.verify("sha256", Buffer.from(comanda), cheiePublica, semnatura)}`);Tip cheie: ec Semnatura valida: true
Indiciu
secrete.privateKey.replace(/\\n/g, "\n") înlocuiește textul \n cu rânduri noi reale.
Reparația
const fs = require("fs");
const crypto = require("crypto");
const secrete = JSON.parse(fs.readFileSync("secrete.json", "utf8"));
const pem = secrete.privateKey.replace(/\\n/g, "\n");
const cheiePrivata = crypto.createPrivateKey(pem);
const cheiePublica = crypto.createPublicKey(cheiePrivata);
const comanda = JSON.stringify({ id: 314, total: 250 });
const semnatura = crypto.sign("sha256", Buffer.from(comanda), cheiePrivata);
console.log(`Tip cheie: ${cheiePrivata.asymmetricKeyType}`);
console.log(`Semnatura valida: ${crypto.verify("sha256", Buffer.from(comanda), cheiePublica, semnatura)}`);De ce merge
Formatul PEM cere rânduri noi reale între BEGIN, liniile de base64 și END. În secrete.json, cheia conținea secvențele text \n (backslash și n), deci OpenSSL nu recunoștea niciun format. replace(/\\n/g, "\n") le transformă în rânduri noi, cheia EC se încarcă, iar semnătura făcută cu ea se verifică cu cheia publică derivată.
Alte forme ale mesajului
Error: error:1E08010C:DECODER routines::unsupported at createPrivateKey (node:internal/crypto/keys:1043:10)Error: error:0909006C:PEM routines:get_name:no start lineError: error:1E08010C:DECODER routines::unsupported library: 'DECODER routines', reason: 'unsupported', code: 'ERR_OSSL_UNSUPPORTED'Error: secretOrPrivateKey must be an asymmetric key when using RS256
Cum o eviți pe viitor
- Păstrează cheile în fișiere
.pemși citește-le cufs.readFileSync, dacă poți. - Dacă trebuie să stea într-o variabilă de mediu, pune-le în base64 (
base64 -w0 cheie.pem) și decodează cuBuffer.from(env, "base64").toString(), sau refă rândurile cureplace. - Verifică la pornire că cheia începe cu
-----BEGINși conține rânduri noi reale. - Nu pune cheile private în repo.
Întrebări frecvente
De ce merge local și pe server nu?
Local cheia e citită de obicei dintr-un fișier, cu rânduri noi reale. Pe server (Docker, Heroku, GitHub Actions) e pusă într-o variabilă de mediu pe un rând, iar \n rămân text. Repară cu replace sau cu base64.
Mesajul vechi era PEM routines:get_name:no start line. E același lucru?
Da, e varianta din OpenSSL 1.1 (Node 16 și mai vechi). Cauza e aceeași: textul nu e un PEM valid.
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: 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". Error: error:1C800064:Provider routines::bad decrypt Decriptarea a eșuat la final(): cheia sau IV-ul folosite la decriptare nu sunt aceleași cu cele de la criptare (sau datele s-au stricat), așa că padding-ul nu iese corect. Folosește exact aceeași cheie, același algoritm și același IV ca la criptare. Î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.
