Generator HMAC & Verifikator Tanda Tangan

Apa Itu HMAC?

const crypto = require('crypto');

// HMAC-SHA256 with a UTF-8 text key, hex output
const hmac = crypto
  .createHmac('sha256', 'my-secret-key')
  .update('Hello, World!')
  .digest('hex');

console.log(hmac);
// → 'cf3141611e22ea26a9cac6fe41d941274dd6653622c83cba13972d177bd69699'

// Verify a signature in constant time
function verify(message, key, expectedHex) {
  const actual = crypto.createHmac('sha256', key).update(message).digest();
  const expected = Buffer.from(expectedHex, 'hex');
  return actual.length === expected.length &&
    crypto.timingSafeEqual(actual, expected);
}

Fitur Utama

Contoh HMAC

Hello, World!

cf3141611e22ea26a9cac6fe41d941274dd6653622c83cba13972d177bd69699

{"id":42,"event":"user.created"}

Cd2f7zTKaJFeG6k+t1FcvDPn51OAZ2f4GrxkCUgMhGs=

what do ya want for nothing?

5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843

The quick brown fox

36f44b125a8a90639dc46733039571792e081e0fd8685ff746784b02ed14aa35629d562c7117cde4a701570551faa5a5e1b7ef1eb5c3bcd4cc1fdb8923fcf14e

Cara Menghasilkan & Memverifikasi HMAC

1. 1

   Pilih algoritma

   Pilih HMAC-SHA256 (default dan pilihan tepat untuk hampir semua webhook, API, dan JWT), atau beralih ke SHA-1, SHA-384, atau SHA-512 agar cocok dengan sistem yang membutuhkannya. Keempatnya berjalan native di browser Anda lewat Web Crypto API.

2. 2

   Masukkan kunci rahasia dan atur pengodeannya

   Ketik atau tempelkan kunci rahasia Anda, lalu atur Pengodean kunci agar cocok dengan cara server menafsirkannya: Teks (UTF-8) untuk string biasa, Hex untuk blob heksadesimal, atau Base64 untuk rahasia base64. Salah di sini adalah penyebab utama HMAC tidak cocok, jadi saat ragu cobalah ketiganya.

3. 3

   Masukkan pesan

   Tempelkan byte persis yang ingin Anda tandatangani — untuk webhook ini adalah body permintaan mentah, byte-per-byte, tanpa serialisasi ulang atau perubahan spasi. HMAC dihitung ulang langsung saat Anda menyunting, tanpa apa pun yang dikirim ke server.

4. 4

   Pilih format output dan salin

   Pilih Hex (gaya GitHub), Base64 (gaya Stripe/AWS), atau Base64URL (gaya JWT) agar cocok dengan yang diharapkan integrasi Anda, lalu klik Salin untuk mengambil tanda tangannya.

5. 5

   Verifikasi tanda tangan yang ada

   Beralih ke tab Verifikasi, tempelkan HMAC yang Diharapkan dari sebuah header atau token, dan alat memastikan dalam waktu konstan apakah tanda tangan yang Anda hitung cocok — sehingga Anda dapat mengautentikasi payload sebelum bertindak atasnya.

Kesalahan HMAC yang Umum

// Server stored a base64 secret but you sign the literal string
createHmac('sha256', 'c2VjcmV0LWtleQ==').update(msg)

// Decode the base64 secret to raw bytes first
createHmac('sha256', Buffer.from('c2VjcmV0LWtleQ==', 'base64')).update(msg)

// Provider sends base64, you compare hex
expected = 'Cd2f7z...=' // base64
actual   = digest('hex') // hex — never matches

// Produce the same encoding the provider uses
actual = digest('base64')

// Re-serialization changes the bytes
body = JSON.stringify(JSON.parse(rawBody))
verify(hmac(body))

// Sign the raw bytes exactly as received
verify(hmac(rawBody))

if (received === computed) { /* trust */ }

if (crypto.timingSafeEqual(receivedBuf, computedBuf)) { /* trust */ }

Untuk Apa HMAC Digunakan

Verifikasi tanda tangan webhook

Penyedia seperti GitHub, Stripe, Slack, dan Twilio menandatangani setiap webhook dengan HMAC atas body permintaan dan rahasia yang hanya Anda bagikan. Hitung ulang tag dan bandingkan dengan header (misalnya X-Hub-Signature-256) untuk memastikan event itu asli sebelum Anda bertindak atasnya. Gunakan tab Verifikasi untuk melakukan ini tanpa menulis kode sekali-pakai.

Tandatangani permintaan API

API terautentikasi sering mewajibkan klien untuk menandatangani permintaan dengan HMAC (metode, path, timestamp, body) memakai rahasia bersama alih-alih mengirim rahasia itu sendiri. AWS Signature Version 4 adalah contoh kanoniknya. Alat ini membiarkan Anda mereproduksi dan men-debug tanda tangan itu langkah demi langkah.

Jamin integritas pesan

Saat Anda melewatkan token, cookie, atau pesan antar layanan, melampirkan HMAC membuat penerima dapat mendeteksi perusakan apa pun. Karena tag bergantung pada rahasia, penyerang tidak dapat menghitung ulangnya setelah memodifikasi data — berbeda dari checksum biasa.

Pahami penandatanganan JWT HS256

JWT yang ditandatangani dengan HS256 hanyalah base64url(header) + '.' + base64url(payload), ditandatangani dengan HMAC-SHA256 dan hasilnya dikeluarkan sebagai Base64URL. Atur algoritma ke SHA-256 dan output ke Base64URL di sini untuk melihat persis bagaimana tanda tangan itu dihasilkan, lalu periksa silang di encoder JWT.

Debug tanda tangan yang tidak cocok

Saat HMAC Anda tidak mau cocok dengan milik server, alat ini adalah cara tercepat untuk mengisolasi penyebabnya: coba kunci sebagai Teks, Hex, dan Base64, ganti output antara Hex dan Base64, dan pastikan Anda menandatangani byte mentah yang persis — semua tanpa men-deploy ulang kode apa pun.

Cara Kerja HMAC

Konstruksi RFC 2104

HMAC didefinisikan sebagai H((K ⊕ opad) ‖ H((K ⊕ ipad) ‖ m)), di mana ipad adalah byte 0x36 yang diulang dan opad adalah 0x5c yang diulang, keduanya sampai ukuran blok hash. Kunci lebih panjang dari ukuran blok di-hash dulu; kunci lebih pendek diisi-nol. Penyaringan dua-tahap ini yang memberi HMAC bukti keamanannya, yang berlaku bahkan jika hash dasar tidak tahan-tabrakan.

Mengapa hash berkunci mengalahkan hash biasa

Hash biasa hanya membuktikan bahwa data tidak rusak secara tak sengaja, karena siapa pun dapat menghitung ulangnya untuk pesan apa pun — termasuk yang sudah dirusak. HMAC menyertakan rahasia, sehingga hanya pemegang kunci yang dapat menghasilkan tag valid. Itu mengubah integritas-saja menjadi integritas plus keaslian, yang merupakan properti yang sebenarnya dibutuhkan webhook dan permintaan bertanda tangan.

Ketahanan length-extension

SHA-1, SHA-256, dan SHA-512 telanjang adalah hash Merkle–Damgård yang rentan terhadap length-extension: diberi H(secret ‖ msg), penyerang dapat menghitung H(secret ‖ msg ‖ extra) tanpa mengetahui rahasianya. Skema 'MAC prefiks-rahasia' yang naif dipatahkan oleh ini. Hash luar HMAC menetralkan serangan tersebut, yang merupakan alasan utama memakai HMAC alih-alih menghash rahasia dan pesan bersama.

Memilih SHA-256 vs SHA-512

HMAC-SHA256 menghasilkan tag 256-bit (64 karakter hex) dan merupakan default interoperabilitas — cepat, ada di mana-mana, dan didukung di semua tempat. HMAC-SHA512 menghasilkan tag 512-bit (128 karakter hex) dan sering lebih cepat di CPU 64-bit karena SHA-512 memakai kata 64-bit. Pilih SHA-256 kecuali sebuah spesifikasi atau sistem rekan membutuhkan SHA-512; keduanya aman untuk autentikasi.

Implementasi Web Crypto

Alat ini memanggil crypto.subtle.importKey untuk memuat kunci Anda (didekode dari Teks, Hex, atau Base64) dan crypto.subtle.sign('HMAC', ...) untuk menghitung tag, lalu mengodekan byte mentah sebagai Hex, Base64, atau Base64URL. Ini adalah implementasi native dan teraudit yang sama yang dipakai browser untuk TLS, berjalan di luar mesin JavaScript demi kecepatan.

Praktik Terbaik HMAC

Gunakan kunci setidaknya sepanjang output hash

Untuk HMAC-SHA256 gunakan rahasia minimal 32 byte acak (256 bit); untuk SHA-512 gunakan 64. Kunci yang pendek atau ber-entropi rendah adalah mata rantai terlemah. Hasilkan kunci dari sumber acak yang aman secara kriptografis — jangan pernah dari kata sandi atau string yang dapat ditebak.

Selalu bandingkan tag dalam waktu konstan

Verifikasi tanda tangan dengan perbandingan waktu-konstan (crypto.timingSafeEqual di Node, hmac.compare_digest di Python) alih-alih == atau kesetaraan string. Perbandingan naif kembali lebih awal pada byte pertama yang berbeda, membocorkan waktu yang dapat membuat penyerang memulihkan tag valid byte demi byte. Tab Verifikasi alat ini sudah membandingkan dalam waktu konstan.

Jangan pernah mencatat atau membocorkan kunci rahasia

Jauhkan rahasia penandatanganan dari log, pesan kesalahan, URL, dan kode sisi-klien. Simpan di pengelola rahasia atau variabel lingkungan, putar secara berkala, dan batasi setiap integrasi ke kuncinya sendiri agar satu kebocoran tidak mengompromikan segalanya.

Utamakan HMAC-SHA256 atau yang lebih kuat

Default ke HMAC-SHA256; naik ke SHA-384 atau SHA-512 saat rekan membutuhkannya. Hindari HMAC-SHA1 untuk sistem baru dan jangan pernah memakai HMAC-MD5. Meski HMAC mentolerir hash yang lebih lemah lebih baik daripada tanda tangan mentah, memulai dari hash modern memberi Anda margin terbanyak.

Tandatangani byte yang persis, termasuk timestamp

Tandatangani payload mentah yang tidak dimodifikasi — serialisasi ulang JSON atau memangkas spasi mengubah byte dan merusak verifikasi. Untuk penandatanganan permintaan, sertakan timestamp atau nonce dalam data yang ditandatangani dan tolak tanda tangan basi untuk mencegah serangan ulang (replay).

FAQ HMAC