...
Eroare Blockchain · hashlib: text, bytes și hash-uri

TypeError: key: expected bytes or bytearray, but got 'str'

Pe scurt

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

Greșit
PYTHON
sig = hmac.new("secret", b"plata 10", hashlib.sha256).hexdigest()
Corect
PYTHON
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

Greșit
PYTHON
sig = hmac.new(cheie, mesaj, hashlib.sha512)
Corect
PYTHON
sig = hmac.new(cheie.encode(), mesaj.encode(), hashlib.sha512)

Dacă repari doar cheia, mesajul text dă imediat „Strings must be encoded before hashing”.

Repară tu

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.

Codul care dă eroarea
PYTHON
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")))
După reparație, programul afișează
HMAC: f2c895641098cef7
Valid: True
Indiciu

Și cheia, și mesajul trebuie transformate în bytes.

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

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