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

Error: Unsupported state or unable to authenticate data

Pe scurt

La AES-GCM, verificarea autenticității a eșuat la final(): tag-ul, IV-ul sau cheia nu sunt cele de la criptare ori textul criptat a fost modificat. Salvează IV-ul și tag-ul (getAuthTag după final) lângă date și folosește-le neschimbate la decriptare, cu setAuthTag înainte de final().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Modul GCM (aes-256-gcm) nu doar criptează, ci și semnează datele: după cipher.final(), cipher.getAuthTag() îți dă un tag de 16 octeți. La decriptare, dai tag-ul cu decipher.setAuthTag(tag), iar decipher.final() verifică dacă datele, IV-ul și cheia produc exact acel tag.

Dacă nu se potrivesc, Node aruncă Unsupported state or unable to authenticate data. Mesajul e vag intenționat: nu spune ce anume e greșit, ca să nu ajute un atacator. Practic înseamnă una dintre:

  • IV-ul de la decriptare e altul (de exemplu generat din nou cu randomBytes);
  • tag-ul e altul, trunchiat sau citit cu altă codificare;
  • cheia e alta;
  • textul criptat sau datele suplimentare (setAAD) au fost modificate.

Dacă uiți complet setAuthTag, Node 24 dă un mesaj diferit: error:1C800077:Provider routines::tag not set.

De ce apare: cauzele frecvente

1IV nou generat la decriptare

Greșit
JavaScript
function decripteaza(date, tag) {
  const iv = crypto.randomBytes(12);
  const d = crypto.createDecipheriv("aes-256-gcm", cheie, iv);
  d.setAuthTag(tag);
  return Buffer.concat([d.update(date), d.final()]);
}
Corect
JavaScript
function decripteaza({ iv, date, tag }) {
  const d = crypto.createDecipheriv("aes-256-gcm", cheie, iv);
  d.setAuthTag(tag);
  return Buffer.concat([d.update(date), d.final()]);
}

Decriptarea are nevoie de același IV folosit la criptare, deci IV-ul se salvează împreună cu datele.

2Tag luat înainte de final()

Greșit
JavaScript
const date = c.update(text, "utf8");
const tag = c.getAuthTag(); // prea devreme
c.final();
Corect
JavaScript
const date = Buffer.concat([c.update(text, "utf8"), c.final()]);
const tag = c.getAuthTag();

Tag-ul se calculează abia la final(). Luat înainte, Node aruncă Attempting to get auth tag in unsupported state.

3Date modificate între timp

Greșit
JavaScript
salvat.date[0] ^= 1; // un octet schimbat (corupere, atac)
Corect
JavaScript
try {
  decripteaza(salvat);
} catch {
  console.log("Datele au fost modificate: le respingem");
}

Aici eroarea e chiar comportamentul dorit: GCM detectează modificarea. Tratează-o ca date invalide.

Repară tu

Repară eroarea, direct în pagină

Datele de card sunt criptate cu aes-256-gcm, iar cripteaza întoarce textul criptat și tag-ul. decripteaza își generează însă un IV nou, așa că final() aruncă Unsupported state or unable to authenticate data. Salvează IV-ul de la criptare în obiectul întors și folosește-l la decriptare, ca programul să afișeze textul original.

Codul care dă eroarea
JavaScript
import crypto from "node:crypto";

const cheie = crypto.scryptSync("Parola-Plati", "sare-plati", 32);

function cripteaza(text) {
  const iv = crypto.randomBytes(12);
  const c = crypto.createCipheriv("aes-256-gcm", cheie, iv);
  const date = Buffer.concat([c.update(text, "utf8"), c.final()]);
  return { date, tag: c.getAuthTag() };
}

function decripteaza(salvat) {
  const iv = crypto.randomBytes(12);
  const d = crypto.createDecipheriv("aes-256-gcm", cheie, iv);
  d.setAuthTag(salvat.tag);
  return Buffer.concat([d.update(salvat.date), d.final()]).toString("utf8");
}

const salvat = cripteaza("Card **** 4242, expira 09/28");
console.log(decripteaza(salvat));
După reparație, programul afișează
Card **** 4242, expira 09/28
Indiciu

Adaugă iv în obiectul întors de cripteaza și citește salvat.iv în decripteaza.

Alte forme ale mesajului

  • Error: Unsupported state or unable to authenticate data at Decipheriv.final (node:internal/crypto/cipher:193:29)
  • Error: error:1C800077:Provider routines::tag not set
  • Error: Attempting to get auth tag in unsupported state
  • Error: Invalid authentication tag length: 8

Cum o eviți pe viitor

  • Salvează împreună, în același obiect sau text: iv, tag și date (de exemplu iv:tag:date în base64).
  • Ia tag-ul doar după final() și setează-l cu setAuthTag înainte de final() la decriptare.
  • Generează un IV nou de 12 octeți la fiecare criptare, nu la decriptare.
  • Tratează eroarea ca „date invalide sau modificate”, nu încerca să le folosești oricum.

Întrebări frecvente

De ce mesajul nu spune exact ce e greșit?

Pentru că verificarea compară un singur tag. Orice diferență (cheie, IV, date, tag) dă același rezultat: tag-ul nu se potrivește. Așa e gândit GCM.

Pot ignora eroarea și folosi textul din update()?

Nu. Textul obținut înainte de final() nu e verificat și poate fi modificat de un atacator. Folosește datele doar dacă final() trece.

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.