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

Error: error:1E08010C:DECODER routines::unsupported

Pe scurt

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 \n au rămas ca două caractere (backslash și n);
  • lipsesc liniile BEGIN / END sau 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

Greșit
JavaScript
// .env: PRIVATE_KEY=-----BEGIN PRIVATE KEY-----\nMIGHAgEA...\n-----END PRIVATE KEY-----
crypto.createPrivateKey(process.env.PRIVATE_KEY);
Corect
JavaScript
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

Greșit
JavaScript
jwt.sign(date, "cheie-secreta", { algorithm: "RS256" });
Corect
JavaScript
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

Greșit
JavaScript
const pem = "MIGHAgEAMBMGByqGSM49AgEGCCqGSM49...";
Corect
JavaScript
const pem = fs.readFileSync("cheie-privata.pem", "utf8");

Citit din fișierul original, PEM-ul are toate liniile exact cum au fost generate.

Repară tu

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.

Codul care dă eroarea
JavaScript
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)}`);
După reparație, programul afișează
Tip cheie: ec
Semnatura valida: true
Indiciu

secrete.privateKey.replace(/\\n/g, "\n") înlocuiește textul \n cu rânduri noi reale.

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 line
  • Error: 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 cu fs.readFileSync, dacă poți.
  • Dacă trebuie să stea într-o variabilă de mediu, pune-le în base64 (base64 -w0 cheie.pem) și decodează cu Buffer.from(env, "base64").toString(), sau refă rândurile cu replace.
  • 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

← 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.