HMAC Oluşturucu ve Doğrulayıcı

Web Crypto aracılığıyla tarayıcınızda yerel olarak Hex, Base64 veya Base64URL biçimlerinde RFC 2104 HMAC-SHA256, SHA-384, SHA-512, SHA-1 ve MD5 imzalarını.

Yükleme yokKayıt gerekmezAnında sonuç
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL%100 Yerel • Sıfır Yükleme
HMAC Hesapla
Çevrimdışı motor hazır%100 gizli tarayıcı içi çalışma alanı • Sıfır bulut yüklemesi
%100 Gizli • Sıfır Sunucu Dosya Yüklemesi

Neden Ücretsiz Utiliome HMAC Oluşturucu ve Doğrulayıcı Kullanmalısınız?

Kesin gizlilik, anında işlem ve sıfır engelleme için sıfırdan tasarlandı. Abonelik, ödeme duvarı veya üyelik gerekmez.

RFC 2104 ve FIPS 198-1 Uyumlu Yapı

IETF RFC 2202 ve RFC 4231 test vektörlerine göre doğrulanmış HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 ve HMAC-MD5 algoritmalarında standart blok boyutlu iç (0x36) ve dış (0x5c) XOR anahtar dolgusu (padding) uygular.

UTF-8, Hex ve Base64 Gizli Anahtar Çözümleme

İkili (binary) API anahtarlarının HMAC türetilmesinden önce tam anahtar baytlarına çözümlenmesi için imzalama sırlarını UTF-8 metni, ham onaltılık oktetler veya RFC 4648 Base64 bayt tamponları olarak ayrıştırır.

Sabit Zamanlı İmza Doğrulama Modu

Önek zamanlama sızıntısına yol açmadan, Web Crypto crypto.subtle.verify ve sabit uzunluklu bit düzeyinde XOR karşılaştırması kullanarak gelen webhook veya API MAC başlıklarını hesaplanan imzalarla doğrular.

Hex, Base64 ve Base64URL Webhook Çıktıları

Küçük/büyük harfli Hex (GitHub, Stripe, Slack), standart dolgulu Base64 (Shopify, AWS) ve dolgusuz Base64URL (JWS/JWT segmentleri) biçimlerindeki özetleri tamamen çevrimdışı olarak yerel tarayıcı belleğinde üretir.

Utiliome ve Geleneksel Bulut Alternatifleri

Yerel WebAssembly motorumuzu eski bulut araçlarıyla karşılaştırın.

Özellik Utiliome (Yerel Tarayıcı) Eski Bulut Dönüştürücüler
RFC 2104 ve FIPS 198-1 Uyumlu Yapı IETF RFC 2202 ve RFC 4231 test vektörlerine göre doğrulanmış HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 ve HMAC-MD5 algoritmalarında standart blok boyutlu iç (0x36) ve dış (0x5c) XOR anahtar dolgusu (padding) uygular. Gelişmiş özelleştirme olmadan sınırlı seçenekler
UTF-8, Hex ve Base64 Gizli Anahtar Çözümleme İkili (binary) API anahtarlarının HMAC türetilmesinden önce tam anahtar baytlarına çözümlenmesi için imzalama sırlarını UTF-8 metni, ham onaltılık oktetler veya RFC 4648 Base64 bayt tamponları olarak ayrıştırır. Harici araçlar veya manuel işlem gerektirir
Gizlilik ve Veri İşleme %100 tarayıcı içi yerel işleme (sunucuya yükleme yok) Verileri üçüncü taraf bulut sunucularına yükler
Fiyatlandırma ve Hesap Şartı Kayıt olmadan sonsuza dek %100 ücretsiz Hesap kaydı veya ücretli abonelik zorunluluğu
Nasıl çalışır

HMAC Oluşturucu ve Doğrulayıcı: 3 Kolay Adımda Kullanım

Yazılım kurulumu gerekmez. Her şey doğrudan web tarayıcınızın içinde çalışır.

1

Tam Mesaj Yükünü (Payload) Girin

Ham, biçimlendirilmemiş HTTP istek gövdesini veya kanonik imzalama dizesini—boşlukları ve anahtar sırasını birebir koruyarak—yapıştırın ya da yakalanan bir yük dosyasını bırakın.

2

Gizli Anahtar Kodlamasını ve Hash Algoritmasını Seçin

Paylaşılan gizli anahtarınızı girin, bayt gösterimini (UTF-8 düz metin, Hex veya Base64) seçin ve HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 veya HMAC-MD5 arasından tercihinizi yapın.

3

MAC Değerini Kopyalayın veya Gelen İmzayı Doğrulayın

Üretilen Hex, Base64 veya Base64URL özetini kopyalayın ya da sabit zamanlı doğrulama çalıştırmak için beklenen bir imzayı (sha256= veya v0= gibi aktarım öneklerini kaldırarak) yapıştırın.

Webhook ve API HMAC İmzalarını Hesaplama ve Doğrulama: Uygulamalı Rehber

Hızlı Cevap: what do ya want for nothing? mesajını 4 baytlık Jefe gizli anahtarıyla (IETF RFC 4231 Test Case 2) HMAC-SHA256 altında imzalamak; UTF-8, Hex (4a656665) ve Base64 (SmVmZQ==) anahtar modlarının tümünde Hex biçiminde 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 ve Base64 biçiminde W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= çıktısını üretir.

Anahtarlı Hash Mesaj Kimlik Doğrulama Kodu (HMAC), hem veri bütünlüğünü (yükün aktarım sırasında değiştirilmediğini) hem de kimlik doğruluğunu (göndericinin paylaşılan gizli anahtara sahip olduğunu) kanıtlar. Bir sağlayıcının imzasını birebir yeniden üretmek, üç temel parametrenin tam eşleşmesini gerektirir: temel alınan hash algoritması, gizli anahtarın ham bayt çözümlemesi ve imzalanan yükün tam bayt dizisi.

Örnek 1: IETF RFC 2104 / RFC 2202 / RFC 4231 Test Senaryosu 2

4 baytlık gizli anahtarı ister UTF-8 metin olarak Jefe, ister ham onaltılık olarak 4a656665, ister Base64 olarak SmVmZQ== şeklinde girin; tamamı aynı [0x4a, 0x65, 0x66, 0x65] anahtar tamponuna çözümlenir. 28 baytlık what do ya want for nothing? UTF-8 mesajını imzalamak şu sonuçları verir:

{
  "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"
  }
}

Örnek 2: Base64 ve Base64URL Farkı ile Webhook Kanonik Yükleri

Standart Base64 (RFC 4648 Bölüm 4) +, / karakterlerini ve sondaki = dolgusunu üretirken; URL güvenli Base64URL (RFC 4648 Bölüm 5, JWS/JWT imzalarında ve imzalı URL'lerde kullanılır) + yerine -, / yerine _ koyar ve = dolgusunu kaldırır. The quick brown fox jumps over the lazy dog mesajını HMAC-SHA256 altında key UTF-8 anahtarıyla imzalamak, kodlama farkını doğrudan gösterir:

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

Gerçek dünya webhook başlıklarını doğrularken, başlık öneklerini ayıklamadan önce her sağlayıcının tanımladığı tam imzalama öncesi yükü oluşturun:

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>

RFC 2104 Yapısı, Anahtar Normalleştirme Kuralları ve Zamanlama Saldırısı Direnci

Hızlı Cevap: RFC 2104, HMAC'i H((K_0 XOR opad) || H((K_0 XOR ipad) || m)) olarak tanımlar ve gizli anahtarları özet çıktı uzunluğu L yerine hash fonksiyonunun dahili sıkıştırma blok boyutu B'ye göre (MD5/SHA-1/SHA-256 için 64 bayt; SHA-384/SHA-512 için 128 bayt) normalleştirir.

IETF RFC 2104 ve NIST FIPS 198-1 standartlarında tanımlanan HMAC, herhangi bir yinelemeli kriptografik hash fonksiyonu H'yi, Merkle-Damgard uzunluk uzatma (length-extension) saldırılarını önleyen iç içe iki geçişli bir zarf içine alır:

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

Blok Boyutu (`B`) ve Çıktı Uzunluğu (`L`) Karşılaştırması ile Anahtar Normalleştirme

Özel HMAC uygulamalarında sık yapılan bir hata, gizli anahtar K'yi sıkıştırma bloğu bayt uzunluğu B yerine özet çıktı bayt uzunluğu L'ye göre normalleştirmektir:

  • MD5 (L = 16), SHA-1 (L = 20), SHA-256 (L = 32): Dahili blok boyutu B = 64 bayttır (512 bit).
  • SHA-384 (L = 48), SHA-512 (L = 64): Dahili blok boyutu B = 128 bayttır (1024 bit).

ipad (B kez tekrarlanan 0x36) ve opad (B kez tekrarlanan 0x5c) ile XOR işlemine sokulmadan önce, ham anahtar baytları K tam olarak B baytlık bir K_0 bloğuna normalleştirilir:

  1. Kısa anahtarlar (len(K) < B): K'nin sağına B - len(K) adet sıfır baytı (0x00) eklenir.
  2. Blok hizalı anahtarlar (len(K) == B): K değiştirilmeden kullanılır (K_0 = K).
  3. Büyük anahtarlar (len(K) > B): L baytlık bir özet üretmek için K bir kez H(K) ile hashlenir, ardından B bayta ulaşmak için sağına B - L adet sıfır baytı (0x00) eklenir.

RFC 2104 Bölüm 3 uyarınca, gizli anahtarlar en az L bayt kriptografik entropi içermelidir (HMAC-SHA256 için >= 32 CSPRNG baytı, HMAC-SHA512 için >= 64 CSPRNG baytı). L'den kısa anahtarlar, etkin kaba kuvvet (brute-force) güvenliğini hash fonksiyonunun doğum günü sınırının altına düşürür.

Anahtar Kodlama Tuzakları ve Sabit Zamanlı Doğrulama

  • Hex Dizesi ve Ham Hex Baytları: Bir API 4a656665... gibi 64 karakterlik onaltılık bir gizli anahtar veriyorsa, ilgili SDK'nın importKey çağrısından önce bu dizeyi 64 ASCII UTF-8 baytı (0x34 0x61...) olarak mı işlediğini yoksa 32 ham bayta (0x4a 0x65...) mı çözümlediğini kontrol edin. Anahtar Kodlaması seçicisini UTF-8, Hex ve Base64 arasında değiştirmek, entegrasyon hata ayıklaması sırasında anahtar çözümleme uyuşmazlıklarını anında tespit etmenizi sağlar.
  • Sabit Zamanlı Doğrulama: Sunucu kodunda güvenilmeyen bir MAC değerini asla standart dize eşitliği (computedHex === headerHex) kullanarak doğrulamayın. Standart dize karşılaştırması eşleşmeyen ilk baytta false döndürerek, uzaktaki saldırganların geçerli MAC'leri her seferinde bir bayt tahmin ederek (2^(8*L) yerine 256 * L tahminde) kırmasına olanak tanıyan nanosaniye ölçekli bir zamanlama kahini (timing oracle) oluşturur. Tarayıcı doğrulaması, Node.js crypto.timingSafeEqual ve Python hmac.compare_digest işlevlerini yansıtacak şekilde crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (veya çözümlenmiş bayt dizileri üzerinde sabit uzunluklu bit düzeyinde XOR birikimi) kullanır.

HMAC Oluşturucu, Kriptografik Hash Oluşturucu ve JWT Oluşturucu: Hangisine İhtiyacınız Var?

Hızlı Cevap: Ham yükleri (HTTP gövdeleri, kanonik dizeler, webhook olayları) paylaşılan bir gizli anahtarla imzalamak veya doğrulamak için HMAC Oluşturucu'yu kullanın. Anahtarsız dize veya dosya özetleri için Kriptografik Hash Oluşturucu'yu; HS256, HS384 veya HS512 ile imzalanmış yapılandırılmış RFC 7519 JSON Web Token'ları oluşturmak için ise JWT Oluşturucu'yu tercih edin.

Anahtarsız özetler, ham HMAC'ler ve simetrik JSON Web Token'ları temel SHA-2 ilkellerini paylaşsa da protokol güvenliğinin farklı katmanlarını çözerler:

Özellik HMAC Oluşturucu ve Doğrulayıcı (Bu Araç) Kriptografik Hash Oluşturucu JWT Oluşturucu
Kriptografik İlkel Anahtarlı MAC (RFC 2104 / FIPS 198-1) Anahtarsız Özet (FIPS 180-4 / RFC 1321) JWS / JWT Token Zarfı (RFC 7515 / RFC 7519)
Gizli Anahtar Gereksinimi Evet (UTF-8, Hex veya Base64 paylaşılan sır) Hayır Evet (Simetrik sır veya RSA/ECDSA anahtar çifti)
Güvenlik Garantisi Kimlik Doğrulama + Veri Bütünlüğü Yalnızca Kazara / Açık Veri Bütünlüğü Doğrulanmış Yapılandırılmış İddialar (iss, sub, exp)
Desteklenen Algoritmalar HMAC-SHA256, SHA384, SHA512, SHA1, MD5 MD5, SHA-1, SHA-256, SHA-384, SHA-512 HS256, HS384, HS512 (ve asimetrik JWS paketleri)
Çıktı Biçimi Hex, Base64, Base64URL Küçük/Büyük Harf Hex, Base64 <header>.<payload>.<signature> (Base64URL)

Doğru Aracı Seçmek

  • Anahtarsız dosya özetlerinde, W3C SRI hash'lerinde veya ETag / önbellek anahtarlarında hata mı ayıklıyorsunuz? İşin içinde gizli anahtar yoktur—Kriptografik Hash Oluşturucu aracını kullanın.
  • Bearer kimlik doğrulama token'ları (HS256, HS384, HS512) mı oluşturuyor veya inceliyorsunuz? RFC 7515 uyarınca bir HS256 JWT imzası, tam olarak HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))) işleminin dolgusuz Base64URL çıktısıdır. Ham üçüncü segmenti mesaj olarak <base64url_header>.<base64url_payload> yapıştırıp Base64URL çıktısını seçerek doğrudan burada doğrulayabilseniz de, JSON başlıklarını düzenlemek, exp/nbf zaman damgalarını doğrulamak ve eksiksiz üç parçalı token'lar birleştirmek için JWT Oluşturucu aracını kullanın.
  • Simetrik HMAC ve Asimetrik İmzalar: HMAC simetrik olduğundan, bir imzayı doğrulayan her servis aynı zamanda yeni imzalar üretmek (veya taklit etmek) için gereken gizli anahtara da sahiptir. Noktadan noktaya webhook'lar ve güvenilir dahili servisler için HMAC kullanın; güvenilmeyen üçüncü tarafların imzalama yetkisi olmadan token doğrulaması gerektiğinde ise JWT Oluşturucu içinde asimetrik anahtarları (RS256, ES256, EdDSA) tercih edin.
SSS

HMAC Oluşturucu ve Doğrulayıcı SSS ve Teknik Rehber

Utiliome'un ücretsiz çevrimiçi hmac oluşturucu aracı hakkında bilmeniz gereken her şey.

Gizli anahtarım ve JSON alanlarım birebir aynı görünmesine rağmen webhook HMAC doğrulamam neden başarısız oluyor?

Webhook HMAC uyuşmazlıklarının %90'ından fazlasına iki sorun neden olur. İlk olarak, Express express.json() gibi ara katman yazılımları (middleware) JSON'u ayrıştırıp yeniden serileştirerek göndericinin imzaladığı ham TCP bayt akışına kıyasla boşlukları, Unicode kaçış dizilerini veya anahtar sıralamasını değiştirir—her zaman ayrıştırılmamış ham istek tamponunu imzalayın ve sağlayıcı zaman damgası öneklerini (Stripe'ın <timestamp>.<body> veya Slack'in v0:<timestamp>:<body> yapısı gibi) dahil edin. İkinci olarak, sağlayıcının gizli anahtarının bir UTF-8 dizesi olarak okunmak yerine Base64 veya Hex'ten ham baytlara çözümlenmesi gerekip gerekmediğini kontrol edin.

RFC 2104 HMAC-SHA256 ile karşılaştırıldığında SHA256(secret + message) neden güvensizdir?

MD5, SHA-1, SHA-256 ve SHA-512, nihai özeti tüm dahili sıkıştırma durumunu açığa çıkaran Merkle-Damgard yapısını kullanır. SHA256(secret || message) değerini ve secret bayt uzunluğunu bilen bir saldırgan, secret değerini hiç bilmeden SHA256(secret || message || padding || attacker_suffix) özetini hesaplayabilir (uzunluk uzatma saldırısı). RFC 2104 HMAC, iç özeti ikinci bir anahtarlı dış hash işlemine H((K_0 XOR opad) || inner_hash) besleyerek bu güvenlik açığını ortadan kaldırır.

HMAC gizli anahtarım 64 veya 128 bayttan uzunsa ne olur?

RFC 2104 Bölüm 2 uyarınca, bir gizli anahtar hash fonksiyonunun dahili blok boyutu B'yi aşarsa (MD5, SHA-1 ve SHA-256 için len(K) > 64 bayt; SHA-384 ve SHA-512 için len(K) > 128 bayt), anahtar önce H(K) ile bir kez hashlenerek L bayta sıkıştırılır ve ardından B bayta ulaşana kadar sağdan 0x00 baytları ile doldurulur. Hem Web Crypto (crypto.subtle.importKey) hem de RFC uyumlu sunucu kütüphaneleri bu ön-hashleme adımını otomatik olarak gerçekleştirir.

GitHub, Stripe, Slack, Shopify ve JWT HS256 için hangi çıktı kodlamasını seçmeliyim?

GitHub (X-Hub-Signature-256), Stripe (Stripe-Signature v1) ve Slack (X-Slack-Signature v0), ilgili sha256=, v1= veya v0= öneklerinden sonra küçük harfli Hex HMAC-SHA256 özetleri iletir. Shopify (X-Shopify-Hmac-Sha256) ve AWS Signature v1/v2 standart dolgulu Base64 kullanır. JSON Web Token'ları (HS256, HS384, HS512) ise RFC 7515 uyarınca dolgusuz Base64URL gerektirir—tam token oluşturma işlemi için JWT Oluşturucu aracına göz atabilirsiniz.

HMAC-MD5 ve HMAC-SHA1, MD5 ve SHA-1 çakışma (collision) saldırıları nedeniyle kırılmış durumda mı?

Doğrudan değil. Anahtarsız MD5 ve SHA-1'e yönelik çakışma saldırıları, saldırganın herkese açık sabit bir başlangıç vektörüne (IV) karşı mesaj bloklarını serbestçe seçmesine dayanırken; HMAC dahili IV'yi gizli K_0 XOR ipad ve K_0 XOR opad adımlarının arkasına gizler (IETF RFC 6151'de belgelendiği üzere). Buna rağmen, NIST SP 800-131A ve büyük webhook sağlayıcıları (örneğin GitHub'ın X-Hub-Signature SHA-1 desteğini sonlandırması) yeni sistemler için HMAC-MD5 ve eski HMAC-SHA1 kullanımını önermemektedir—eski protokol uyumluluğunu sürdürmediğiniz sürece her zaman HMAC-SHA256 veya HMAC-SHA512 seçin.