...
Eroare Blockchain · Chei, semnături și aritmetică modulară

cryptography.exceptions.InvalidSignature

Pe scurt

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

Greșit
PYTHON
semnatura = semneaza(json.dumps(tx, sort_keys=True))
...
verifica(json.dumps(tx), semnatura)
Corect
PYTHON
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

Greșit
PYTHON
tx["semnatura"] = semneaza(canonic(tx))
verifica(canonic(tx), tx["semnatura"])
Corect
PYTHON
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

Greșit
PYTHON
tx["suma"] = 50   # după semnare
verifica(canonic(tx), semnatura)
Corect
PYTHON
# 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ă tu

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

Codul care dă eroarea
PYTHON
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ă")
După reparație, programul afișează
Tranzacție originală: validă
Tranzacție modificată: invalidă
Indiciu

Folosește funcția canonic și la verificare.

Alte forme ale mesajului

  • ecdsa.keys.BadSignatureError: Signature verification failed
  • InvalidSignature

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

← Toate erorile Blockchain

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ță 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.