cryptography.exceptions.InvalidSignature
Verificarea semnăturii a eșuat: mesajul verificat nu e exact același cu cel semnat (alt text, altă ordine a câmpurilor, alte spații) sau folosești altă cheie publică. Serializează mesajul identic la semnare și la verificare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
InvalidSignature este excepția pe care o aruncă biblioteca cryptography din Python când public_key.verify(semnatura, date, ...) nu reușește. Excepția nu are mesaj: îți spune doar că semnătura nu corespunde datelor și cheii. În cursul nostru, scris doar cu biblioteca standard, funcția de verificare aruncă o excepție cu același nume, ca să vezi aceeași situație.
Cauza e aproape mereu că bytes-urile verificate diferă de cele semnate, chiar dacă par aceleași date: dicționarul tranzacției a fost serializat în altă ordine sau cu alte spații, ai semnat textul și verifici hash-ul lui (sau invers), ai adăugat câmpul semnatura în date înainte de verificare, sau mesajul chiar a fost modificat. Mai rar: folosești cheia publică a altcuiva ori parametri diferiți (alt algoritm de hash, alt padding).
De ce apare: cauzele frecvente
1Serializare diferită la semnare și la verificare
semnatura = semneaza(json.dumps(tx, sort_keys=True))
...
verifica(json.dumps(tx), semnatura)def canonic(tx):
return json.dumps(tx, sort_keys=True, separators=(",", ":"))
semnatura = semneaza(canonic(tx))
verifica(canonic(tx), semnatura)O singură funcție de serializare garantează aceiași bytes la ambele capete.
2Semnătura inclusă în datele verificate
tx["semnatura"] = semneaza(canonic(tx))
verifica(canonic(tx), tx["semnatura"])tx["semnatura"] = semneaza(canonic(tx))
date = {k: v for k, v in tx.items() if k != "semnatura"}
verifica(canonic(date), tx["semnatura"])Ai semnat tranzacția fără semnătură, deci verifici tot fără ea.
3Mesajul chiar a fost modificat
tx["suma"] = 50 # după semnare
verifica(canonic(tx), semnatura)# orice modificare cere o semnătură nouă, făcută de proprietarul cheii
verifica(canonic(tx_original), semnatura)Aici excepția e corectă: exact asta trebuie să prindă semnătura.
Repară eroarea, direct în pagină
Codul de mai jos semnează o tranzacție cu RSA-ul de jucărie din curs, dar nodul care o primește o verifică după ce a serializat-o altfel, iar verificarea aruncă InvalidSignature. Repară funcția verifica_tx ca să serializeze exact ca la semnare și afișează Tranzacție originală: validă și Tranzacție modificată: invalidă.
import hashlib, json
n, e, d = 3233, 17, 2753
class InvalidSignature(Exception):
pass
def canonic(tx):
return json.dumps(tx, sort_keys=True, separators=(",", ":"))
def h_mod(text):
return int(hashlib.sha256(text.encode()).hexdigest(), 16) % n
def semneaza(tx):
return pow(h_mod(canonic(tx)), d, n)
def verifica_tx(tx, semnatura):
if pow(semnatura, e, n) != h_mod(json.dumps(tx)):
raise InvalidSignature()
tx = {"de_la": "ana", "catre": "bogdan", "suma": 5, "nonce": 0}
s = semneaza(tx)
primita = {"nonce": 0, "suma": 5, "catre": "bogdan", "de_la": "ana"}
falsa = dict(primita, suma=50)
for nume, t in (("originală", primita), ("modificată", falsa)):
try:
verifica_tx(t, s)
print(f"Tranzacție {nume}: validă")
except InvalidSignature:
if nume == "originală":
raise
print(f"Tranzacție {nume}: invalidă")Tranzacție originală: validă Tranzacție modificată: invalidă
Indiciu
Folosește funcția canonic și la verificare.
Reparația
import hashlib, json
n, e, d = 3233, 17, 2753
class InvalidSignature(Exception):
pass
def canonic(tx):
return json.dumps(tx, sort_keys=True, separators=(",", ":"))
def h_mod(text):
return int(hashlib.sha256(text.encode()).hexdigest(), 16) % n
def semneaza(tx):
return pow(h_mod(canonic(tx)), d, n)
def verifica_tx(tx, semnatura):
if pow(semnatura, e, n) != h_mod(canonic(tx)):
raise InvalidSignature()
tx = {"de_la": "ana", "catre": "bogdan", "suma": 5, "nonce": 0}
s = semneaza(tx)
primita = {"nonce": 0, "suma": 5, "catre": "bogdan", "de_la": "ana"}
falsa = dict(primita, suma=50)
for nume, t in (("originală", primita), ("modificată", falsa)):
try:
verifica_tx(t, s)
print(f"Tranzacție {nume}: validă")
except InvalidSignature:
if nume == "originală":
raise
print(f"Tranzacție {nume}: invalidă")De ce merge
Semnătura acoperă bytes-urile exacte ale textului semnat. Nodul primea câmpurile în altă ordine, iar json.dumps(tx) fără sortare producea alt text, deci alt hash, iar verificarea eșua chiar pentru tranzacția corectă. Cu canonic(tx) la ambele capete, tranzacția originală trece, iar cea cu suma schimbată pică, exact cum trebuie. RSA-ul de jucărie are doar 3233 de valori posibile, deci e doar pentru învățare.
Alte forme ale mesajului
ecdsa.keys.BadSignatureError: Signature verification failedInvalidSignature
Cum o eviți pe viitor
Separă clar datele semnate de semnătură și folosește o singură funcție canonic(date) pentru semnare și pentru verificare. Testează întotdeauna ambele cazuri: tranzacția nemodificată trebuie să treacă, iar una cu suma schimbată trebuie să pice. Dacă și tranzacția nemodificată pică, problema e în serializare sau în chei, nu în date.
Întrebări frecvente
De ce excepția nu spune ce e greșit?
Intenționat: verificarea doar confirmă sau infirmă. Un mesaj detaliat ar putea ajuta un atacator. Diagnosticul îl faci tu, comparând bytes-urile semnate cu cele verificate.
Pot prinde excepția și continua?
Da, cu try / except InvalidSignature, dar tranzacția trebuie respinsă. Un nod nu acceptă niciodată în bloc o tranzacție cu semnătură invalidă.
Erori înrudite
Hash diferit pentru aceleași date: ordinea cheilor în json.dumps Două dicționare cu aceleași date, dar cu cheile adăugate în altă ordine, dau texte JSON diferite, deci hash-uri diferite. Serializează determinist: json.dumps(date, sort_keys=True, separators=(",", ":")). ValueError: base is not invertible for the given modulus pow(x, -1, m) caută inversul modular al lui x, dar acesta nu există: x e 0 modulo m sau are un divizor comun cu m. În codul de curbe eliptice apare de obicei la dublarea unui punct (P + P) tratată ca adunare obișnuită, cu x2 - x1 = 0. TypeError: key: expected bytes or bytearray, but got 'str' Ai dat lui hmac.new o cheie de tip text. Cheia HMAC trebuie să fie bytes: hmac.new(cheie.encode(), mesaj.encode(), hashlib.sha256). Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
