Generator HMAC

Cara kerja HMAC

HMAC (hash-based message authentication code, RFC 2104) menggabungkan hash kriptografis dengan kunci rahasia. Hanya pihak yang mengetahui kunci yang dapat menghasilkan nilai yang benar untuk sebuah pesan, sehingga HMAC yang cocok membuktikan dua hal sekaligus: pesan tidak diubah, dan pesan berasal dari pemegang kunci.

Konstruksinya adalah H((K ⊕ opad) ‖ H((K ⊕ ipad) ‖ message)). Kunci di-hash terlebih dahulu jika lebih panjang dari ukuran blok hash (64 byte untuk MD5, SHA-1, dan SHA-256, 128 byte untuk SHA-384 dan SHA-512), ditambah byte nol hingga mencapai ukuran tersebut, lalu di-XOR dengan ipad (byte 0x36) untuk hash dalam (inner hash) atas pesan dan dengan opad (byte 0x5c) untuk hash luar (outer hash) atas hasil hash dalam. Konstruksi naif SHA-256(key ‖ message) tidak memiliki hash luar, sehingga siapa pun yang melihat satu tag dapat menambahkan data ke pesan dan menghitung tag baru yang valid tanpa kunci (serangan length-extension).

Panjang keluarannya sama dengan panjang hash yang mendasarinya: 32 byte, atau 64 karakter hex, untuk HMAC-SHA256. RFC 2104 menyarankan kunci yang setidaknya sepanjang itu, dan generator Base64 acak dapat membuat kunci yang sesuai.

Penggunaan tanda tangan HMAC

• Webhook GitHub. Header X-Hub-Signature-256 berisi sha256= diikuti HMAC-SHA256 dalam hex dari body permintaan mentah, yang dihitung dengan kunci rahasia webhook. Anda dapat menempelkan seluruh nilai header ke kolom Bandingkan dengan; awalan sha256= akan diabaikan.
• Webhook Stripe. Header Stripe-Signature memuat stempel waktu t dan tanda tangan v1: HMAC-SHA256 dalam hex dari stempel waktu, sebuah titik, dan body mentah, yang dihitung dengan kunci rahasia endpoint (whsec_...) dalam bentuk teks.
• Webhook Shopify. X-Shopify-Hmac-Sha256 berisi HMAC-SHA256 dari body mentah dalam Base64, dengan client secret aplikasi sebagai kunci, jadi pilih keluaran Base64 atau tempel nilai header tersebut ke kolom Bandingkan dengan.
• AWS Signature Version 4. Kunci penandatanganan diturunkan dengan merangkai HMAC-SHA256: pertama tanggal, dengan kunci berupa AWS4 yang disambung dengan secret access key, lalu region, layanan, dan aws4_request, masing-masing dengan hasil langkah sebelumnya sebagai kunci. Atur Format kunci ke Hex untuk memasukkan keluaran satu langkah ke langkah berikutnya.
• JSON Web Token. HS256, HS384, dan HS512 adalah HMAC-SHA256, -384, dan -512 atas header terenkode, sebuah titik, dan payload terenkode. Bagian ketiga token adalah HMAC tersebut dalam Base64 aman untuk URL, yang diterima apa adanya oleh kolom Bandingkan dengan. Decoder JWT memverifikasi token secara utuh.

Selalu hitung HMAC atas body mentah persis seperti yang diterima. Mengurai JSON lalu menyerialisasikannya kembali akan mengubah spasi atau urutan kunci, dan bahkan satu baris baru tambahan sudah menghasilkan HMAC yang sama sekali berbeda.

HMAC dalam kode

# Python
import hmac, hashlib
sig = hmac.new(b'key', b'message', hashlib.sha256).hexdigest()
hmac.compare_digest(sig, received)        # perbandingan waktu konstan

// Node.js
const crypto = require('crypto');
const sig = crypto.createHmac('sha256', 'key').update('message').digest('hex');
// timingSafeEqual memunculkan error jika panjangnya berbeda, jadi periksa dulu
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(received));

// PHP: pesan ditulis sebelum kunci
$sig = hash_hmac('sha256', 'message', 'key');
hash_equals($sig, $received);

# OpenSSL: kunci teks, lalu kunci yang sama dalam bentuk hex
printf '%s' 'message' | openssl dgst -sha256 -hmac 'key'
printf '%s' 'message' | openssl dgst -sha256 -mac HMAC -macopt hexkey:6b6579

# Vektor uji: kunci "key", pesan "The quick brown fox jumps over the lazy dog"
# HMAC-SHA256 = f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

Saat memverifikasi tanda tangan di kode Anda sendiri, gunakan perbandingan waktu konstan seperti pada contoh di atas. Operator == biasa berhenti pada karakter pertama yang berbeda, dan perbedaan waktu tersebut dapat dimanfaatkan penyerang untuk menemukan tanda tangan yang valid byte demi byte. Untuk skema bertanda waktu seperti milik Stripe, tolak juga permintaan yang stempel waktunya sudah lewat lebih dari beberapa menit untuk mencegah serangan replay.