Error: Unsupported state or unable to authenticate data
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
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()]);
}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()
const date = c.update(text, "utf8");
const tag = c.getAuthTag(); // prea devreme
c.final();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
salvat.date[0] ^= 1; // un octet schimbat (corupere, atac)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ă 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.
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));Card **** 4242, expira 09/28
Indiciu
Adaugă iv în obiectul întors de cripteaza și citește salvat.iv în decripteaza.
Reparația
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 { iv, date, tag: c.getAuthTag() };
}
function decripteaza(salvat) {
const d = crypto.createDecipheriv("aes-256-gcm", cheie, salvat.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));De ce merge
La GCM, tag-ul depinde de cheie, IV și date. Cu un IV nou la decriptare, tag-ul calculat nu se potrivește cu cel salvat, iar final() refuză datele. IV-ul nu e secret, deci se salvează lângă date și tag. Folosind același IV, verificarea trece și textul e întors.
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 setError: Attempting to get auth tag in unsupported stateError: Invalid authentication tag length: 8
Cum o eviți pe viitor
- Salvează împreună, în același obiect sau text:
iv,tagșidate(de exempluiv:tag:dateîn base64). - Ia tag-ul doar după
final()și setează-l cusetAuthTagînainte definal()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
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. 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). Error [ERR_CRYPTO_HASH_FINALIZED]: Digest already called Ai apelat digest() de două ori pe același obiect Hash sau Hmac, sau ai făcut update() după digest(). Un hash se poate finaliza o singură dată: salvează rezultatul lui digest() într-o variabilă și creează un hash nou pentru fiecare text. Î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.
