Hash Message Authentication Code (HMAC)

Implementação "hash-agnostic" de um gerador e autenticador de HMAC

Algoritmo escrito em conformidade com o descrito pelo artigo Message Authentication using Hash Functions — The HMAC Construction

Exemplo de uso

from hmac import HMAC
import hashing

minha_chave = "minhachavesupersecreta"
minha_mensagem = "Mensagem de exemplo"

hmac_authority = HMAC(minha_chave, hashing.MD5) # Usará MD5 como função de hashing

# Gera o hash para minha_mensagem usando a chave minha_chave
msg_hash = hmac_authority.generate(minha_mensagem)

# Verifica se o conjunto (mensagem, hash) é válido (usando minha_chave)
hmac_authority.verify("Mensagem de exemplo", expected_hash=msg_hash) # Retorna True
hmac_authority.verify("Mensagem adulterada", expected_hash=msg_hash) # Retorna False


# Para facilitar, também podemos gerar e verificar "pacotes" contendo a mensagem e seu hash

# Gera um pacote de bytes contendo a mensagem (codificada) e seu hash, separados por um byte nulo (0x00)
pack = hmac_authority.generate_pack("Mensagem de exemplo")

# Verifica a validade do pacote (em relação a minha_chave)
hmac_authority.verify_pack(pack) # Retorna True

Esquema do algoritmo implementado