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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
hmac.new(cheie, mesaj, algoritm) calculează un HMAC: un hash care depinde de o cheie secretă, folosit ca să dovedești că un mesaj vine de la cineva care are cheia (de exemplu derivarea cheilor din seed phrase în BIP-32 sau semnarea unui webhook). Mesajul de eroare spune că parametrul key trebuie să fie bytes sau bytearray, dar a primit str.
Atenție: dacă repari cheia, dar mesajul rămâne text, următoarea eroare va fi „Strings must be encoded before hashing”, pentru că și mesajul trebuie să fie bytes. Ambele se repară cu .encode(). Al treilea argument, algoritmul (hashlib.sha256 sau "sha256"), este obligatoriu în Python 3.
De ce apare: cauzele frecvente
1Cheia secretă ca text
sig = hmac.new("secret", b"plata 10", hashlib.sha256).hexdigest()sig = hmac.new("secret".encode(), b"plata 10", hashlib.sha256).hexdigest()Cheia intră în calculul hash-ului, deci trebuie să fie bytes.
2Cheia și mesajul ca text
sig = hmac.new(cheie, mesaj, hashlib.sha512)sig = hmac.new(cheie.encode(), mesaj.encode(), hashlib.sha512)Dacă repari doar cheia, mesajul text dă imediat „Strings must be encoded before hashing”.
Repară eroarea, direct în pagină
Codul de mai jos semnează cu HMAC-SHA256 un mesaj de plată și verifică semnătura, dar dă TypeError: key: expected bytes or bytearray, but got 'str'. Repară funcția semneaza ca să afișeze HMAC: (primele 16 caractere) și Valid: True.
import hmac, hashlib
CHEIE = "cheie-de-test-magazin"
def semneaza(mesaj):
return hmac.new(CHEIE, mesaj, hashlib.sha256).hexdigest()
sig = semneaza("plata 1001: 250 monede")
print("HMAC:", sig[:16])
print("Valid:", hmac.compare_digest(sig, semneaza("plata 1001: 250 monede")))HMAC: f2c895641098cef7 Valid: True
Indiciu
Și cheia, și mesajul trebuie transformate în bytes.
Reparația
import hmac, hashlib
CHEIE = "cheie-de-test-magazin"
def semneaza(mesaj):
return hmac.new(CHEIE.encode(), mesaj.encode(), hashlib.sha256).hexdigest()
sig = semneaza("plata 1001: 250 monede")
print("HMAC:", sig[:16])
print("Valid:", hmac.compare_digest(sig, semneaza("plata 1001: 250 monede")))De ce merge
hmac.new amestecă cheia cu mesajul și le trece prin SHA-256, deci are nevoie de bytes pentru amândouă. Cu CHEIE.encode() și mesaj.encode() calculul merge, iar același mesaj cu aceeași cheie dă mereu același HMAC. Verificarea se face recalculând HMAC-ul și comparându-l cu hmac.compare_digest, care nu dezvăluie prin timp câte caractere se potrivesc.
Alte forme ale mesajului
TypeError: Strings must be encoded before hashing
Cum o eviți pe viitor
Păstrează cheile secrete ca bytes de la început (de exemplu CHEIE = b"..." sau bytes.fromhex(...)). Scrie o funcție semneaza_hmac(cheie, mesaj) care encodează ce e text și întoarce hexdigest(). Compară două HMAC-uri cu hmac.compare_digest(a, b), nu cu ==.
Întrebări frecvente
HMAC e același lucru cu o semnătură digitală?
Nu. HMAC folosește o singură cheie secretă, pe care o au ambele părți. O semnătură ECDSA folosește o cheie privată pentru semnare și o cheie publică pentru verificare, deci oricine poate verifica fără să poată semna.
De ce compare_digest și nu ==?
hmac.compare_digest compară în timp constant, așa că un atacator nu poate ghici HMAC-ul măsurând cât durează comparația.
Erori înrudite
TypeError: Strings must be encoded before hashing Ai dat un text (str) direct lui hashlib.sha256, dar funcțiile hash lucrează doar pe bytes. Transformă textul cu .encode() înainte: hashlib.sha256(mesaj.encode()).hexdigest(). TypeError: string argument without an encoding Ai apelat bytes(text) fără să spui codificarea. Scrie text.encode() sau bytes(text, "utf-8"). 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. Î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.
