Hashes para C# com uma API simples e direta.

Use GetMD5 quando o sistema de destino já exige MD5 ou quando precisa manter compatibilidade com valores existentes. Para um helper sem extensão, use Hash.Content.

using System.IO;
using System.Text;
using MD5Hash;

string fromString = "123".GetMD5();
byte[] bytes = Encoding.UTF8.GetBytes("Hello, World!");
string fromBytes = bytes.GetMD5();
string fromObject = new { Id = 1, Name = "Test" }.GetMD5();
using var stream = File.OpenRead("arquivo.zip");
string fromStream = stream.GetMD5();

Strings usam ASCII por padrão em GetMD5(string). Para acentos, emojis ou outros caracteres fora de ASCII, informe EncodingType.UTF8:

string hash = "Olá, mundo! 👋".GetMD5(EncodingType.UTF8);
string helper = Hash.Content("123");

Para novos checksums, SHA-256 é a escolha recomendada. O método produz 64 caracteres hexadecimais:

string checksum = "hello world".GetSHA256();
// b94d27b9934d3e08a52e52d7da7dabfa...

Strings e objetos usam UTF-8 por padrão. Para arquivos grandes, passe o stream aberto; a posição atual será consumida durante a leitura.

using FileStream file = File.OpenRead("relatorio.pdf");
string checksum = file.GetSHA256();

HMAC-SHA-256 combina o conteúdo com uma chave secreta. É útil quando quem recebe precisa verificar que a mensagem veio de uma parte que conhece a chave. Nunca exponha essa chave no código-fonte.

string secretKey = "a-secret-key";
string signature = "hello world".GetHMACSHA256(secretKey);

Para bytes, passe conteúdo e chave como byte[]. Para objetos, a biblioteca serializa o objeto em JSON antes de calcular o HMAC.

byte[] payload = Encoding.UTF8.GetBytes("Hello, World!");
byte[] key = Encoding.UTF8.GetBytes("a-secret-key");
string signature = payload.GetHMACSHA256(key);

Este método existe para reproduzir o comportamento legado. Um salt muda o resultado, mas não transforma MD5 em algoritmo adequado para senhas. Para novas senhas, use PasswordHash.

string hash = "hello world".GetMD5WithSalt("randomSalt");
string objectHash = new { Id = 1 }.GetMD5WithSalt("randomSalt");

byte[] data = Encoding.UTF8.GetBytes("Hello, World!");
byte[] salt = Encoding.UTF8.GetBytes("randomSalt");
string hash = data.GetMD5WithSalt(salt);