TypeError: Missing required argument 'digestmod'.
Ai apelat hmac.new(cheie, mesaj) fără algoritmul hash. Din Python 3.8, digestmod e obligatoriu: scrie hmac.new(cheie, mesaj, hashlib.sha256) sau hmac.digest(cheie, mesaj, "sha256").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
HMAC este un hash cu cheie: doar cine cunoaște cheia poate produce sau verifica amprenta unui mesaj. În blockchain îl întâlnești la API-urile de exchange (semnarea cererilor), la derivarea cheilor din fraza de recuperare (BIP-32 folosește HMAC-SHA512) și la autentificarea mesajelor între noduri.
hmac.new are nevoie de trei lucruri: cheia (bytes), mesajul (bytes) și algoritmul hash (digestmod). Înainte de Python 3.8, dacă lipsea algoritmul, se folosea implicit MD5, un algoritm slab. Acum lipsa lui dă eroarea din titlu, ca să alegi conștient. Uneori eroarea apare și când pui algoritmul pe poziția greșită, ca al doilea argument, iar mesajul rămâne nespecificat.
De ce apare: cauzele frecvente
1Algoritmul lipsește
import hmac
semn = hmac.new(b"cheie-api", b"GET /sold").hexdigest()import hmac, hashlib
semn = hmac.new(b"cheie-api", b"GET /sold", hashlib.sha256).hexdigest()Al treilea argument spune ce hash folosește HMAC. Fără el, Python refuză să aleagă.
2Algoritmul pus în locul mesajului
import hmac, hashlib
h = hmac.new(b"cheie", hashlib.sha256)
h.update(b"mesaj")import hmac, hashlib
h = hmac.new(b"cheie", digestmod=hashlib.sha256)
h.update(b"mesaj")Cu numele argumentului (digestmod=) nu mai contează poziția și codul se citește clar.
Repară eroarea, direct în pagină
Codul de mai jos semnează cu HMAC o cerere către API-ul unui exchange și verifică semnătura, dar dă TypeError: Missing required argument 'digestmod'.. Repară-l folosind HMAC-SHA256, ca să afișeze Semnătură: ... și Valid: True.
import hmac, hashlib
CHEIE = b"cheie-secreta-de-test"
cerere = b"GET /api/sold?moneda=BTC&ts=1700000000"
semnatura = hmac.new(CHEIE, cerere).hexdigest()
primita = hmac.new(CHEIE, cerere, hashlib.sha256).hexdigest()
print("Semnătură:", semnatura)
print("Valid:", hmac.compare_digest(semnatura, primita))Semnătură: 3e14a25ff2037558ed94ba98df0eab91eab77fb6e79782f2d00b467c1f3906df Valid: True
Indiciu
hmac.new are nevoie și de algoritmul hash, ca al treilea argument.
Reparația
import hmac, hashlib
CHEIE = b"cheie-secreta-de-test"
cerere = b"GET /api/sold?moneda=BTC&ts=1700000000"
semnatura = hmac.new(CHEIE, cerere, hashlib.sha256).hexdigest()
primita = hmac.new(CHEIE, cerere, hashlib.sha256).hexdigest()
print("Semnătură:", semnatura)
print("Valid:", hmac.compare_digest(semnatura, primita))De ce merge
HMAC combină cheia cu un algoritm hash, iar din Python 3.8 algoritmul trebuie dat explicit. Cu hashlib.sha256 ca al treilea argument, ambele părți calculează HMAC-SHA256 cu aceeași cheie și obțin aceeași semnătură, iar hmac.compare_digest le compară într-un timp constant.
Alte forme ale mesajului
TypeError: Missing required parameter 'digestmod'.
Cum o eviți pe viitor
Scrie mereu digestmod cu numele lui (digestmod=hashlib.sha256), ca să fie clar ce algoritm folosești. Pentru verificarea unei semnături HMAC folosește hmac.compare_digest(a, b), nu ==, ca să nu dai indicii prin timpul comparației. Ține cheia în afara codului, de exemplu într-o variabilă de mediu.
Întrebări frecvente
De ce codul vechi mergea fără digestmod?
Până la Python 3.8 se folosea MD5 implicit. Pentru că MD5 e considerat nesigur, parametrul a devenit obligatoriu.
Pot da algoritmul ca text?
Da: hmac.new(cheie, mesaj, "sha256") merge, la fel ca hashlib.sha256.
Erori înrudite
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). 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(). Î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.
