Penjana & Pengesah HMAC

Kira dan sahkan tandatangan RFC 2104 HMAC-SHA256, SHA-384, SHA-512, SHA-1, dan MD5 dalam Hex, Base64, atau Base64URL secara tempatan dalam pelayar anda melalui.

Tiada muat naikTanpa daftarHasil segera
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL100% Tempatan • Tiada Muat Naik
Kira HMAC
Enjin luar talian sediaRuang kerja pelayar 100% peribadi • Tanpa muat naik awan
100% Peribadi • Tanpa Muat Naik Fail ke Pelayan

Mengapa Guna Penjana & Pengesah HMAC Percuma Utiliome?

Dibina khas untuk privasi ketat, pelaksanaan serta-merta, dan tanpa kerumitan. Tiada langganan atau pendaftaran akaun.

Binaan Patuh Piawaian RFC 2104 & FIPS 198-1

Melaksanakan pelapik kunci XOR dalaman (0x36) dan luaran (0x5c) bersaiz blok piawai merentasi HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1, dan HMAC-MD5, disahkan terhadap vektor ujian IETF RFC 2202 dan RFC 4231.

Penyahkodan Kunci Rahsia UTF-8, Hex, dan Base64

Menghurai rahsia penandatanganan sebagai teks UTF-8, oktet perenambelasan mentah, atau penimbal bait Base64 RFC 4648 supaya kunci API binari dinyahkod kepada bait kunci yang tepat sebelum penerbitan HMAC.

Mod Pengesahan Tandatangan Masa Malar

Mengesahkan pengepala MAC webhook atau API yang masuk terhadap tandatangan yang dikira menggunakan Web Crypto crypto.subtle.verify dan perbandingan XOR bitwise panjang tetap tanpa membocorkan pemasaan awalan.

Output Webhook Hex, Base64 & Base64URL

Menghasilkan intisari dalam format Hex huruf kecil/besar (GitHub, Stripe, Slack), Base64 berpelapik piawai (Shopify, AWS), dan Base64URL tanpa pelapik (segmen JWS/JWT) sepenuhnya di luar talian dalam memori pelayar tempatan.

Utiliome berbanding Alat Awan Tradisional

Bandingkan enjin WebAssembly tempatan kami dengan alat awan lama.

Ciri Utiliome (Penyemak Imbas Tempatan) Penukar Awan Lama
Binaan Patuh Piawaian RFC 2104 & FIPS 198-1 Melaksanakan pelapik kunci XOR dalaman (0x36) dan luaran (0x5c) bersaiz blok piawai merentasi HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1, dan HMAC-MD5, disahkan terhadap vektor ujian IETF RFC 2202 dan RFC 4231. Pilihan terhad tanpa penyesuaian lanjutan
Penyahkodan Kunci Rahsia UTF-8, Hex, dan Base64 Menghurai rahsia penandatanganan sebagai teks UTF-8, oktet perenambelasan mentah, atau penimbal bait Base64 RFC 4648 supaya kunci API binari dinyahkod kepada bait kunci yang tepat sebelum penerbitan HMAC. Memerlukan alat luaran atau pemprosesan manual
Privasi & Pemprosesan Data 100% setempat dalam pelayar (sifar muat naik pelayan) Memuat naik data ke pelayan awan pihak ketiga
Harga & Keperluan Akaun 100% percuma selamanya tanpa pendaftaran Memerlukan pendaftaran akaun atau langganan berbayar
Cara ia berfungsi

Cara Menggunakan Penjana & Pengesah HMAC dalam 3 Langkah Mudah

Pemasangan perisian tidak diperlukan. Semuanya berjalan terus dalam penyemak imbas anda.

1

Bekalkan Muatan Mesej yang Tepat

Tampal badan permintaan HTTP mentah yang tidak diformat atau rentetan penandatanganan kanonik—mengekalkan ruang kosong dan susunan kunci yang tepat—atau lepaskan fail muatan yang ditangkap.

2

Konfigurasikan Pengekodan Kunci Rahsia & Hash

Masukkan rahsia dikongsi anda, pilih perwakilan baitnya (teks biasa UTF-8, Hex, atau Base64), dan pilih HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1, atau HMAC-MD5.

3

Salin MAC atau Sahkan Tandatangan Masuk

Salin intisari Hex, Base64, atau Base64URL yang terhasil, atau tampal tandatangan yang dijangkakan (buang awalan pengangkutan seperti sha256= atau v0=) untuk menjalankan pengesahan masa malar.

Mengira dan Mengesahkan Tandatangan HMAC Webhook & API: Panduan Praktikal

Jawapan Pantas: Menandatangani mesej what do ya want for nothing? dengan rahsia 4-bait Jefe (Kes Ujian 2 IETF RFC 4231) di bawah HMAC-SHA256 menghasilkan 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 dalam Hex dan W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= dalam Base64 merentasi mod kunci UTF-8, Hex (4a656665), dan Base64 (SmVmZQ==).

Kod Pengesahan Mesej Hash Berkunci (HMAC) membuktikan kedua-dua integriti data (muatan tidak diubah semasa transit) dan kesahihan (pengirim memegang kunci rahsia yang dikongsi). Menghasilkan semula tandatangan pembekal memerlukan padanan tiga parameter yang tepat: primitif hash asas, penyahkodan bait mentah kunci rahsia, dan jujukan bait tepat bagi muatan yang ditandatangani.

Contoh 1: Kes Ujian 2 IETF RFC 2104 / RFC 2202 / RFC 4231

Sama ada anda memasukkan kunci rahsia 4-bait sebagai teks UTF-8 Jefe, perenambelasan mentah 4a656665, atau Base64 SmVmZQ==, ia dinyahkod kepada penimbal kunci yang serupa [0x4a, 0x65, 0x66, 0x65]. Menandatangani mesej UTF-8 28-bait what do ya want for nothing? menghasilkan:

{
  "keyUtf8": "Jefe",
  "keyHex": "4a656665",
  "keyBase64": "SmVmZQ==",
  "message": "what do ya want for nothing?",
  "signatures": {
    "hmac_md5_hex": "750c783e6ab0b503eaa86e310a5db738",
    "hmac_sha1_hex": "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79",
    "hmac_sha256_hex": "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843",
    "hmac_sha256_base64": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=",
    "hmac_sha256_base64url": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM",
    "hmac_sha384_hex": "af45d2e376484031617f78d2b58a6b1b9c7ef464f5a01b47e42ec3736322445e8e2240ca5e69e2c78b3239ecfab21649",
    "hmac_sha512_hex": "164b7a7bfcf819e2e395fbe73b56e0a387bd64222e831fd610270cd7ea2505549758bf75c05a994a6d034f65f8f0e6fdcaeab1a34d4a6b4b636e070a38bce737"
  }
}

Contoh 2: Base64 lwn Base64URL dan Muatan Kanonik Webhook

Base64 piawai (RFC 4648 Seksyen 4) mengeluarkan +, /, dan pelapik = di hujung, manakala Base64URL yang selamat untuk URL (RFC 4648 Seksyen 5, digunakan dalam tandatangan JWS/JWT dan URL bertandatangan) menggantikan + dengan -, / dengan _, serta membuang pelapik =. Menandatangani The quick brown fox jumps over the lazy dog dengan kunci UTF-8 key di bawah HMAC-SHA256 menunjukkan perbezaan pengekodan secara langsung:

Key (UTF-8):     key
Message (UTF-8): The quick brown fox jumps over the lazy dog

HMAC-SHA256 Hex:       f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
HMAC-SHA256 Base64:    97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg=
HMAC-SHA256 Base64URL: 97yD9DBThCSxMpjmqm-xQ-9NWaFJRhdZl0edvC0aPNg

Apabila mengesahkan pengepala webhook dunia sebenar, bina muatan pra-tandatangan yang tepat seperti yang ditakrifkan oleh setiap pembekal sebelum membuang awalan pengepala:

GitHub (X-Hub-Signature-256: sha256=<hex>):
  Signed input = <raw_http_body>

Stripe (Stripe-Signature: t=1730419200,v1=<hex>):
  Signed input = 1730419200.<raw_http_body>

Slack (X-Slack-Signature: v0=<hex>):
  Signed input = v0:1730419200:<raw_http_body>

Shopify (X-Shopify-Hmac-Sha256: <base64>):
  Signed input = <raw_http_body>

Binaan RFC 2104, Peraturan Penormalan Kunci, dan Rintangan Serangan Pemasaan

Jawapan Pantas: RFC 2104 mentakrifkan HMAC sebagai H((K_0 XOR opad) || H((K_0 XOR ipad) || m)), menormalkan kunci rahsia terhadap saiz blok mampatan dalaman fungsi hash B (64 bait untuk MD5/SHA-1/SHA-256; 128 bait untuk SHA-384/SHA-512) dan bukannya panjang output intisari L.

Ditakrifkan dalam IETF RFC 2104 dan NIST FIPS 198-1, HMAC membalut sebarang fungsi hash kriptografi berulang H dalam sampul dua laluan bersarang yang menghalang serangan lanjutan panjang (length-extension attack) Merkle-Damgard:

HMAC(K, m) = H( (K_0 XOR opad) || H( (K_0 XOR ipad) || m ) )

Saiz Blok (`B`) lwn Panjang Output (`L`) dan Penormalan Kunci

Kesilapan pelaksanaan yang kerap berlaku dalam kod HMAC tersuai ialah menormalkan kunci rahsia K terhadap panjang bait output intisari L dan bukannya panjang bait blok mampatan B:

  • MD5 (L = 16), SHA-1 (L = 20), SHA-256 (L = 32): Saiz blok dalaman B = 64 bait (512 bit).
  • SHA-384 (L = 48), SHA-512 (L = 64): Saiz blok dalaman B = 128 bait (1024 bit).

Sebelum melakukan operasi XOR terhadap ipad (0x36 diulang B kali) dan opad (0x5c diulang B kali), bait kunci mentah K dinormalkan menjadi blok B-bait yang tepat K_0:

  1. Kunci pendek (len(K) < B): Tambah B - len(K) bait sifar (0x00) di sebelah kanan K.
  2. Kunci sejajar blok (len(K) == B): Gunakan K tanpa pengubahsuaian (K_0 = K).
  3. Kunci bersaiz lebih (len(K) > B): Hash K sekali menggunakan H(K) untuk menghasilkan intisari L-bait, kemudian tambah B - L bait sifar (0x00) untuk mencapai B bait.

Menurut RFC 2104 Seksyen 3, kunci rahsia hendaklah mengandungi sekurang-kurangnya L bait entropi kriptografi (>= 32 bait CSPRNG untuk HMAC-SHA256, >= 64 bait CSPRNG untuk HMAC-SHA512). Kunci yang lebih pendek daripada L mengurangkan keselamatan brute-force berkesan di bawah batas birthday bound hash tersebut.

Perangkap Pengekodan Kunci dan Pengesahan Masa Malar

  • Rentetan Hex lwn Bait Hex Mentah: Jika API mengeluarkan rahsia hex 64 aksara seperti 4a656665..., semak sama ada SDK mereka menganggap rentetan itu sebagai 64 bait UTF-8 ASCII (0x34 0x61...) atau menyahkod hex tersebut kepada 32 bait mentah (0x4a 0x65...) sebelum memanggil importKey. Menukar pemilih Pengekodan Kunci antara UTF-8, Hex, dan Base64 dengan serta-merta mengasingkan ketidakpadanan penyahkodan kunci semasa penyahpepijatan integrasi.
  • Pengesahan Masa Malar: Jangan sesekali mengesahkan MAC yang tidak dipercayai dalam kod pelayan menggunakan persamaan rentetan piawai (computedHex === headerHex). Perbandingan rentetan piawai memulangkan false pada bait pertama yang tidak sepadan, mewujudkan oracle pemasaan berskala nanosaat yang membolehkan penyerang jauh melakukan brute-force MAC yang sah satu bait pada satu masa (256 * L tekaan dan bukannya 2^(8*L)). Pengesahan pelayar menggunakan crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (atau pengumpulan XOR bitwise panjang tetap merentasi tatasusunan bait yang dinyahkod), mencerminkan crypto.timingSafeEqual dalam Node.js dan hmac.compare_digest dalam Python.

Penjana HMAC lwn Penjana Hash Kriptografi lwn Penjana JWT: Yang Mana Satu Anda Perlukan?

Jawapan Pantas: Gunakan Penjana HMAC untuk menandatangani atau mengesahkan muatan mentah (badan HTTP, rentetan kanonik, acara webhook) dengan kunci rahsia yang dikongsi. Gunakan Penjana Hash Kriptografi untuk intisari rentetan atau fail tanpa kunci, dan gunakan Penjana JWT untuk membina JSON Web Token RFC 7519 berstruktur yang ditandatangani dengan HS256, HS384, atau HS512.

Walaupun intisari tanpa kunci, HMAC mentah, dan JSON Web Token simetri berkongsi primitif SHA-2 asas yang sama, ia menyelesaikan lapisan keselamatan protokol yang berbeza:

Ciri Penjana & Pengesah HMAC (Alat Ini) Penjana Hash Kriptografi Penjana JWT
Primitif Kriptografi MAC Berkunci (RFC 2104 / FIPS 198-1) Intisari Tanpa Kunci (FIPS 180-4 / RFC 1321) Sampul Token JWS / JWT (RFC 7515 / RFC 7519)
Memerlukan Kunci Rahsia Ya (Rahsia dikongsi UTF-8, Hex, atau Base64) Tidak Ya (Rahsia simetri atau pasangan kunci RSA/ECDSA)
Jaminan Keselamatan Kesahihan + Integriti Data Integriti Data Awam / Tidak Sengaja Sahaja Tuntutan Berstruktur Disahkan (iss, sub, exp)
Algoritma Disokong HMAC-SHA256, SHA384, SHA512, SHA1, MD5 MD5, SHA-1, SHA-256, SHA-384, SHA-512 HS256, HS384, HS512 (serta suit JWS asimetri)
Format Output Hex, Base64, Base64URL Hex Huruf Kecil/Besar, Base64 <header>.<payload>.<signature> (Base64URL)

Memilih Utiliti yang Betul

  • Menyahpepijat intisari fail tanpa kunci, hash W3C SRI, atau kunci ETag / cache? Tiada kunci rahsia terlibat—gunakan Penjana Hash Kriptografi.
  • Membina atau memeriksa token pengesahan pembawa (HS256, HS384, HS512)? Di bawah RFC 7515, tandatangan JWT HS256 adalah secara khusus output Base64URL tanpa pelapik bagi HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). Walaupun anda boleh mengesahkan segmen ketiga mentah secara terus di sini dengan menampal <base64url_header>.<base64url_payload> sebagai mesej dan memilih output Base64URL, gunakan Penjana JWT untuk menyunting pengepala JSON, mengesahkan cap masa exp/nbf, dan memasang token tiga bahagian yang lengkap.
  • HMAC Simetri lwn Tandatangan Asimetri: Oleh sebab HMAC adalah simetri, setiap perkhidmatan yang mengesahkan tandatangan memegang rahsia tepat yang diperlukan untuk memalsukan tandatangan baharu. Gunakan HMAC untuk webhook titik ke titik dan perkhidmatan dalaman yang dipercayai; apabila pihak ketiga yang tidak dipercayai mesti mengesahkan token tanpa keistimewaan menandatangani, gunakan kunci asimetri (RS256, ES256, EdDSA) dalam Penjana JWT.
FAQ

Soalan Lazim dan Panduan Teknikal Penjana & Pengesah HMAC

Semua yang anda perlu tahu tentang penggunaan penjana hmac dalam talian dalam talian percuma Utiliome.

Mengapakah pengesahan HMAC webhook saya gagal walaupun kunci rahsia dan medan JSON saya kelihatan serupa?

Dua isu menyebabkan lebih 90% ketidakpadanan HMAC webhook. Pertama, perisian tengah seperti Express express.json() menghurai dan mensirikan semula JSON, mengubah ruang kosong, pelepasan Unicode, atau susunan kunci berbanding strim bait TCP mentah yang ditandatangani oleh pengirim—sentiasa tandatangani penimbal permintaan mentah yang tidak dihurai, dan sertakan awalan cap masa pembekal (seperti <timestamp>.<body> Stripe atau v0:<timestamp>:<body> Slack). Kedua, semak sama ada rahsia pembekal mesti dinyahkod daripada Base64 atau Hex kepada bait mentah dan bukannya dibaca sebagai rentetan UTF-8.

Mengapakah SHA256(secret + message) tidak selamat berbanding RFC 2104 HMAC-SHA256?

MD5, SHA-1, SHA-256, dan SHA-512 menggunakan binaan Merkle-Damgard, yang intisari akhirnya mendedahkan keadaan mampatan dalaman yang lengkap. Dengan adanya SHA256(secret || message) dan panjang bait secret, penyerang boleh mengira SHA256(secret || message || padding || attacker_suffix) tanpa perlu mengetahui secret (serangan lanjutan panjang / length-extension attack). RFC 2104 HMAC menghapuskan kelemahan ini dengan memasukkan intisari dalaman ke dalam hash luaran berkunci kedua H((K_0 XOR opad) || inner_hash).

Apakah yang berlaku jika kunci rahsia HMAC saya lebih panjang daripada 64 atau 128 bait?

Menurut RFC 2104 Seksyen 2, jika kunci rahsia melebihi saiz blok dalaman fungsi hash B (len(K) > 64 bait untuk MD5, SHA-1, dan SHA-256; len(K) > 128 bait untuk SHA-384 dan SHA-512), kunci tersebut dimampatkan terlebih dahulu dengan melakukan hashing sekali menggunakan H(K) kepada L bait dan kemudian dilapik di sebelah kanan dengan bait 0x00 sehingga mencapai B bait. Kedua-dua Web Crypto (crypto.subtle.importKey) dan pustaka pelayan patuh RFC melaksanakan langkah pra-hash ini secara automatik.

Pengekodan output yang manakah patut saya pilih untuk GitHub, Stripe, Slack, Shopify, dan JWT HS256?

GitHub (X-Hub-Signature-256), Stripe (Stripe-Signature v1), dan Slack (X-Slack-Signature v0) semuanya menghantar intisari HMAC-SHA256 Hex huruf kecil selepas awalan sha256=, v1=, atau v0= masing-masing. Shopify (X-Shopify-Hmac-Sha256) dan AWS Signature v1/v2 menggunakan Base64 berpelapik piawai. JSON Web Token (HS256, HS384, HS512) memerlukan Base64URL tanpa pelapik menurut RFC 7515—lihat Penjana JWT untuk pemasangan token penuh.

Adakah HMAC-MD5 dan HMAC-SHA1 ditembusi oleh serangan perlanggaran MD5 dan SHA-1?

Tidak secara langsung. Serangan perlanggaran terhadap MD5 dan SHA-1 tanpa kunci bergantung pada penyerang yang bebas memilih blok mesej terhadap IV tetap awam, manakala HMAC melindungi IV dalaman di sebalik langkah rahsia K_0 XOR ipad dan K_0 XOR opad (didokumenkan dalam IETF RFC 6151). Walau bagaimanapun, NIST SP 800-131A dan pembekal webhook utama (seperti GitHub yang menamatkan X-Hub-Signature SHA-1) telah menamatkan penggunaan HMAC-MD5 dan HMAC-SHA1 warisan untuk sistem baharu—sentiasa pilih HMAC-SHA256 atau HMAC-SHA512 melainkan untuk mengekalkan keserasian protokol warisan.