Hedera Mesaj İmza Doğrulamasının Gizli Detayları: Bilinmeyen Bir Sır
Hedera Hashgraph, yüksek performanslı, güvenli ve adil bir dağıtık defter teknolojisi sunarak dijital dünyada önemli bir yer edinmiştir. Bu platformun temelinde yatan güvenlik mekanizmalarından biri de dijital imzalardır. Ancak, Hedera üzerinde mesaj imza doğrulamasını yaparken, özellikle SDK’lar dışındaki ortamlarda veya özel entegrasyonlarda, genellikle gözden kaçan ve “belgelenmemiş” olarak nitelendirilebilecek kritik bir detay bulunmaktadır. Bu makale, Hedera mesaj imza doğrulamasının bu gizli yönlerini aydınlatmayı ve geliştiricilere sağlam ve güvenilir doğrulama mekanizmaları oluşturmaları için gerekli bilgiyi sunmayı amaçlamaktadır.
Dijital İmzaların Temelleri ve Hedera’daki Rolü
Dijital imzalar, kriptografinin temel taşlarından biridir ve dijital dünyada kimlik doğrulama, veri bütünlüğü ve inkar edilemezlik sağlamak için kullanılır. Hedera Hashgraph gibi dağıtık defter teknolojilerinde, her işlemin ve mesajın geçerliliğini ve kaynağını doğrulamak için dijital imzalar vazgeçilmezdir.
Kriptografik İmzalar Neden Önemli?
Kriptografik imzalar, bir mesajın veya verinin belirli bir özel anahtar tarafından imzalandığını ve bu imzanın ilgili açık anahtar kullanılarak doğrulanabileceğini kanıtlar. Bu, mesajın göndericisinin kimliğini doğrular (kimlik doğrulama), mesajın imzalandıktan sonra değiştirilmediğini garanti eder (veri bütünlüğü) ve göndericinin mesajı gönderdiğini inkar etmesini engeller (inkar edilemezlik). Hedera ekosisteminde, her işlem (token transferi, akıllı sözleşme çağrısı vb.) ilgili özel anahtarla imzalanmalı ve ağ tarafından doğrulanmalıdır.
Hedera Hashgraph ve Güven Modeli
Hedera Hashgraph, geleneksel blok zincirlerinden farklı olarak, hashgraph konsensüs algoritmasını kullanır. Bu algoritma, yüksek işlem hacmi, düşük gecikme süresi ve adil sıralama sunar. Güven modeli, ağdaki düğümlerin ve kullanıcıların işlemlerini dijital imzalar aracılığıyla güvence altına almasına dayanır. Bir işlem ağa gönderildiğinde, önce imzası doğrulanır. Geçersiz imzalı işlemler reddedilir, bu da ağın bütünlüğünü korur.
Hedera’da İmza Türleri (Ed25519, ECDSA)
Hedera, iki ana kriptografik imza algoritmasını destekler:
- Ed25519: Bu, hızlı ve güvenli bir dijital imza algoritmasıdır. Hedera’nın varsayılan ve önerilen anahtar türüdür. Özellikle performans ve güvenlik açısından avantajlar sunar.
- ECDSA (secp256k1): Ethereum ve Bitcoin gibi diğer popüler blok zincirlerinde yaygın olarak kullanılan bir algoritmadır. Hedera, bu anahtar türünü de destekleyerek farklı ekosistemlerden geçişi kolaylaştırır.
Doğrulama sürecinde, kullanılan anahtar türüne uygun kriptografik fonksiyonların kullanılması hayati önem taşır.
Mesaj İmzalama Süreci: Yüzeyin Altında Ne Var?
Hedera’da bir mesajı veya işlemi imzalamak, sadece özel anahtarınızı kullanıp bir “imza” oluşturmaktan daha fazlasını içerir. Özellikle dışarıdan veya farklı dillerde doğrulama yapmaya çalışırken, imzalama sürecinin detaylarını anlamak kritik öneme sahiptir.
Standart İmzalama Akışı
Genel olarak, bir dijital imza oluşturma akışı şu adımları takip eder:
- İmzalanacak veri (mesaj veya işlem) hazırlanır.
- Bu veri, kriptografik bir hash fonksiyonu (örneğin SHA-512) kullanılarak hashlenir. Bu, verinin sabit boyutlu bir özetini oluşturur.
- Oluşturulan hash özeti, özel anahtar kullanılarak imzalanır.
- Sonuç olarak, orijinal verinin bir imza kanıtı elde edilir.
Hedera SDK’ları bu süreci genellikle soyutlar ve geliştiricilerin doğrudan hashleme veya imzalama detaylarıyla uğraşmasına gerek kalmaz. Ancak, doğrulama tarafında bu soyutlamanın ne anlama geldiğini bilmek önemlidir.
Hash Algoritması Seçimi
Hedera, genellikle SHA-512 hash algoritmasını kullanır. Bu, imzalanacak verinin sabit boyutlu bir özetini (hash’ini) oluşturur. Güvenli bir hash algoritması seçimi, imzalanan verinin değiştirilememesi ve çakışma saldırılarına karşı korunması için elzemdir. Doğrulama yaparken, imza oluşturulurken kullanılan hash algoritmasıyla aynı algoritmanın kullanıldığından emin olunmalıdır.
“İmza Payload”ının Oluşturulması: İşte Sır Burada!
Hedera’da mesaj imza doğrulamasının “gizli” detayı, imza payload’ının (yani hash’i alınan ve ardından imzalanan verinin) tam olarak ne olduğudur. Geliştiriciler genellikle sadece “mesajı” imzaladıklarını düşünürler. Ancak, Hedera SDK’ları ve ağın kendisi, farklı senaryolarda farklı veri yapılarını imzalar:
- Hedera İşlemleri (Transactions): Bir Hedera işlemi (örneğin
TransferTransaction,ContractCallTransaction), aslında bir Protobuf mesajıdır. SDK’lar, bu Protobuf mesajının ikili (binary) serileştirilmiş halini (yaniTransactionBody‘nin byte dizisini) hashler ve imzalar. - Arbitrary Mesajlar (Rastgele Mesajlar): Kullanıcıların rastgele metin veya veri imzalaması gerektiğinde (örneğin bir web sitesine giriş yapmak için), Hedera SDK’ları genellikle sağlanan mesajın ham byte dizisini (genellikle UTF-8 kodlamalı) doğrudan hashler ve imzalar. Burada herhangi bir ek Protobuf serileştirmesi veya metadata eklenmez.
“Sır”, bu iki senaryo arasındaki farkı ve özellikle rastgele mesaj imzalarken hangi byte dizisinin tam olarak imzalandığını doğru bir şekilde yeniden oluşturabilmektir.
“Bilinmeyen Sır”: İmza Verisinin Tam Yapısı
Hedera mesaj imza doğrulamasında, “bilinmeyen sır” tam olarak hangi byte dizisinin imzalandığını ve bu dizinin nasıl oluşturulduğunu anlamaktır. Bu, özellikle off-chain doğrulama yaparken veya Hedera SDK’larını kullanmadan kendi imzalama/doğrulama mantığınızı uygularken kritik hale gelir.
Hedera SDK’larının Mesajı Nasıl İşlediği
Hedera SDK’ları (JavaScript, Java, Go), genellikle geliştiriciler için bu karmaşıklığı gizler. Örneğin, bir JavaScript SDK’sında new MessageSignTransaction().setMessage("Merhaba Dünya").sign(privateKey) gibi bir kullanım, arka planda “Merhaba Dünya” metninin UTF-8 byte dizisini alır, bunu bir SignMessageTransaction‘ın parçası olarak serileştirir ve ardından bu serileştirilmiş transaction body’yi imzalar. Ancak, eğer bir privateKey.sign(messageBytes) fonksiyonu kullanılıyorsa, bu genellikle sadece messageBytes‘ı doğrudan imzalar. Bu ayrım, doğrulama yaparken hangi senaryoda olduğunuzu anlamanızı gerektirir.
Arbitrary Mesajlar vs. Hedera İşlemleri: Farkı Anlamak
- Hedera İşlemleri: Ağ üzerinde yürütülen her şey bir işlemdir. Bu işlemler, Protobuf formatında tanımlanır ve imzalanmadan önce bu formatta ikili olarak serileştirilir. Doğrulama yaparken, orijinal işlem Protobuf yapısını yeniden oluşturup,
TransactionBody‘yi ikili olarak serileştirmeli ve bu byte dizisinin hash’ini doğrulamalısınız. - Arbitrary Mesajlar: Bu, bir kullanıcının belirli bir metni veya veriyi kendi Hedera anahtarıyla imzalamak istediği durumdur. Örneğin, bir web sitesinde kimliğini doğrulamak veya bir oylama mesajını imzalamak. Bu durumda, “sır”, mesajın *tam olarak hangi byte dizisi* olarak kabul edildiğidir. Genellikle, bu, mesajın UTF-8 kodlamalı byte dizisidir ve herhangi bir ek Hedera işlemi metadata’sı içermez.
Yanlış byte dizisini hashlemek, her zaman geçersiz bir doğrulama sonucuna yol açacaktır.
Doğru Byte Dizisini Oluşturma: Kod Örnekleri ve Püf Noktaları
Arbitrary bir mesajın (örneğin “Merhaba Dünya”) Hedera anahtarıyla imzalandığını varsayalım. Doğrulama yapmak için, imzalanan mesajın tam olarak hangi byte dizisi olduğunu bilmelisiniz. Çoğu durumda, bu, mesajın UTF-8 kodlamasıdır.
// JavaScript Örneği (İmzalama tarafı - SDK ile)
import { PrivateKey, Client } from "@hashgraph/sdk";
async function signArbitraryMessage(messageString, privateKey) {
const client = Client.forTestnet(); // veya mainnet
// Özel anahtarınızı yükleyin
const signerPrivateKey = PrivateKey.fromString(privateKey);
// Mesajı doğrudan byte dizisi olarak imzala
// Bu, genellikle SDK'nın düşük seviyeli imzalama fonksiyonları veya
// bir wallet uygulaması tarafından yapılır.
const messageBytes = Buffer.from(messageString, 'utf8');
const signature = signerPrivateKey.sign(messageBytes);
return { messageBytes, signature: Buffer.from(signature).toString('hex') };
}
// Doğrulama tarafı (off-chain veya başka bir sistemde)
import { PublicKey } from "@hashgraph/sdk";
function verifyArbitraryMessage(messageString, signatureHex, publicKeyString) {
const messageBytes = Buffer.from(messageString, 'utf8');
const signatureBytes = Buffer.from(signatureHex, 'hex');
const publicKey = PublicKey.fromString(publicKeyString);
// Public key kullanarak imzayı doğrula
const isValid = publicKey.verify(messageBytes, signatureBytes);
return isValid;
}
// Kullanım Örneği
// const myPrivateKey = PrivateKey.generateEd25519();
// const myPublicKey = myPrivateKey.publicKey;
// const messageToSign = "Bu benim özel mesajım.";
// const { messageBytes, signature } = await signArbitraryMessage(messageToSign, myPrivateKey.toString());
// const isValid = verifyArbitraryMessage(messageToSign, signature, myPublicKey.toString());
// console.log("İmza geçerli mi?", isValid);
Püf Noktaları:
- Encoding: Her zaman mesajın hangi karakter kodlamasıyla (genellikle UTF-8) byte dizisine dönüştürüldüğünü doğrulayın. Tutarsızlıklar, imzanın geçersiz olmasına neden olur.
- Ek Veri: İmzalama sırasında mesaja herhangi bir ek veri (nonce, timestamp, transaction ID vb.) eklenip eklenmediğini kontrol edin. Eğer eklendiyse, doğrulama sırasında bu ek veriyi de orijinal mesajla birlikte aynı sırada ve formatta yeniden oluşturmalısınız.
- Canonicalization: Bazı sistemler, imzalamadan önce veriyi belirli bir "kanonik" forma sokar (örneğin JSON nesnelerini belirli bir anahtar sıralamasına göre düzenlemek). Hedera'nın arbitrary mesaj imzalamasında bu genellikle gerekli değildir, ancak karmaşık veri yapılarını imzalarken göz önünde bulundurulmalıdır.
İmza Doğrulama: Adım Adım Rehber
Doğru byte dizisini elde ettikten sonra, Hedera imzasını doğrulamak standart kriptografik adımları içerir.
Genel Doğrulama Mekanizması
Bir dijital imzanın doğrulanması şu adımları içerir:
- Orijinal mesajın (veya imzalanan verinin) byte dizisi elde edilir.
- Bu byte dizisi, imza oluşturulurken kullanılan aynı hash algoritmasıyla hashlenir.
- İmza, imzalayanın açık anahtarı ve orijinal hash özeti kullanılarak doğrulanır.
- Doğrulama başarılı olursa, imza geçerlidir; aksi takdirde geçersizdir.
Hedera SDK'ları bu adımları publicKey.verify(messageBytes, signatureBytes) gibi basit bir fonksiyon çağrısıyla gerçekleştirir.
Public Key ve İmza Eşleşmesi
Doğrulama için, imza oluşturulurken kullanılan özel anahtara karşılık gelen doğru açık anahtara sahip olmanız gerekir. Açık anahtar ve imza, aynı kriptografik algoritmayı (Ed25519 veya ECDSA) ve aynı hash fonksiyonunu kullanarak eşleşmelidir. Hedera'da açık anahtarlar genellikle bir 0x önekiyle veya base64 kodlamasıyla temsil edilir.
Kendi Doğrulama Fonksiyonunuzu Yazmak
Eğer Hedera SDK'larını kullanmadan kendi doğrulama mantığınızı uygulamak istiyorsanız (örneğin farklı bir programlama dilinde veya kısıtlı bir ortamda), temel kriptografik kütüphaneleri kullanmanız gerekir.
# Python Örneği (Ed25519 için)
from nacl.signing import VerifyKey
from nacl.exceptions import BadSignatureError
import binascii
def verify_hedera_ed25519_signature(message_string: str, signature_hex: str, public_key_hex: str) -> bool:
try:
# Mesajı UTF-8 byte dizisine dönüştür
message_bytes = message_string.encode('utf-8')
# İmza ve public key'i hex'ten byte'a dönüştür
signature_bytes = binascii.unhexlify(signature_hex)
public_key_bytes = binascii.unhexlify(public_key_hex)
# VerifyKey nesnesi oluştur
verify_key = VerifyKey(public_key_bytes)
# İmza doğrulamayı dene
verify_key.verify(message_bytes, signature_bytes)
return True
except BadSignatureError:
return False
except Exception as e:
print(f"Hata oluştu: {e}")
return False
# Kullanım Örneği (Python)
# from nacl.signing import SigningKey
# private_key_seed = bytes.fromhex("...") # 32 byte seed
# signing_key = SigningKey(private_key_seed)
# public_key_hex = signing_key.verify_key.encode(encoder=HexEncoder).decode('utf-8')
# message = "Merhaba Python!"
# signed = signing_key.sign(message.encode('utf-8'))
# signature_hex = signed.signature.hex()
# is_valid = verify_hedera_ed25519_signature(message, signature_hex, public_key_hex)
# print(f"Python'da imza geçerli mi? {is_valid}")
Bu örnek, PyNaCl kütüphanesini kullanarak Ed25519 imzasını doğrular. ECDSA için farklı bir kütüphane (örneğin ecdsa veya fastecdsa) ve ilgili fonksiyonlar kullanılmalıdır. Önemli olan, mesajın byte dizisi, imza ve açık anahtarın doğru formatlarda sağlanmasıdır.
Sık Karşılaşılan Hatalar ve Çözümleri
Hedera mesaj imza doğrulamasında karşılaşılan yaygın sorunlar genellikle "bilinmeyen sır" ile ilgilidir.
Yanlış Hashleme
En yaygın hata, imzalanan verinin hash'ini alırken yanlış hash algoritması kullanmak veya hash'i alınacak veriyi yanlış hazırlamaktır.
Çözüm: Hedera'nın genellikle SHA-512 kullandığını unutmayın. En önemlisi, imzalama sırasında hangi byte dizisinin hash'inin alındığını tam olarak anlamak ve doğrulama sırasında aynı byte dizisini kullanmaktır.
Eksik veya Fazla Veri Ekleme
İmzalama sırasında mesaja eklenen veya çıkarılan herhangi bir ek bilgi (timestamp, nonce, işlem ID'si vb.) doğrulama sırasında tam olarak aynı şekilde ele alınmazsa, imza geçersiz olacaktır.
Çözüm: İmzalama protokolünüzü standartlaştırın. Eğer ek metadata imzalanıyorsa, bu metadatayı da doğrulama sırasında orijinal mesajla birleştirerek aynı byte dizisini oluşturun.
Encoding Sorunları
Karakter kodlaması (UTF-8, ASCII vb.) tutarsızlıkları, mesajın byte dizisini farklı şekillerde oluşturur ve bu da imzanın geçersiz olmasına neden olur.
Çözüm: Her zaman tutarlı bir kodlama kullanın, genellikle UTF-8 en iyi seçimdir. Hem imzalayan hem de doğrulayan tarafın aynı kodlamayı kullandığından emin olun.
Güvenlik İpuçları ve En İyi Uygulamalar
Sağlam bir imza doğrulama mekanizması, uygulamanızın güvenliği için temeldir.
Replay Saldırılarına Karşı Korunma
Bir saldırgan, geçerli bir imzayı kopyalayıp tekrar göndererek "replay" saldırısı yapabilir.
Çözüm: İmzaladığınız mesajlara tek kullanımlık "nonce" değerleri, zaman damgaları veya işlem kimlikleri gibi benzersiz tanımlayıcılar ekleyin. Bu ek veriyi de imza payload'ına dahil edin ve doğrulama sırasında bu değerlerin geçerliliğini kontrol edin.
Anahtar Yönetimi
Özel anahtarlarınızın güvenliği, tüm sisteminizin güvenliği için hayati öneme sahiptir.
Çözüm: Özel anahtarları asla açıkta bırakmayın. Donanım cüzdanları (Ledger, Trezor) veya güvenli anahtar yönetim sistemleri kullanın. Açık anahtarlarınızı güvenilir bir şekilde yayınlayın.
SDK Güncellemelerini Takip Etme
Hedera SDK'ları sürekli gelişmektedir. İmzalama ve doğrulama mekanizmalarında yapılan güncellemeler, yeni özellikler veya güvenlik iyileştirmeleri getirebilir.
Çözüm: SDK'larınızı düzenli olarak güncelleyin ve değişiklik kayıtlarını (changelog) takip edin. Bu, potansiyel uyumluluk sorunlarını önlemenize ve en iyi güvenlik uygulamalarını sürdürmenize yardımcı olur.
Sonuç
Hedera mesaj imza doğrulamasının "belgelenmemiş sırrı", aslında imzalanan verinin tam olarak hangi byte dizisi olduğunu anlamaktan geçer. Hedera SDK'ları, işlemleri ve rastgele mesajları farklı şekillerde işleyerek imza payload'larını oluşturur. Geliştiricilerin, özellikle off-chain doğrulama yaparken veya özel entegrasyonlar geliştirirken, bu farkı kavraması ve mesajın doğru byte dizisini (genellikle UTF-8 kodlamalı) titizlikle yeniden oluşturması kritik öneme sahiptir. Doğru encoding, ek veri yönetimi ve tutarlı hash algoritması kullanımı, Hedera ekosisteminde güvenilir ve sağlam imza doğrulama mekanizmaları oluşturmanın anahtarıdır. Bu detaylara dikkat ederek, uygulamalarınızın güvenliğini artırabilir ve kullanıcılarınıza sorunsuz bir deneyim sunabilirsiniz.
SSS (Sık Sorulan Sorular)
1. Hedera'da bir mesajı imzalarken hangi hash algoritması kullanılır?
Genellikle SHA-512 hash algoritması kullanılır. Ancak, özellikle Hedera işlemleri için, işlemin Protobuf serileştirilmiş body'si hashlenir. Rastgele mesajlar için ise mesajın ham byte dizisi (genellikle UTF-8) hashlenir.
2. Neden Hedera SDK'sının dışından imza doğrulamak bu kadar zor olabiliyor?
Zorluk, SDK'ların imzalama sürecini soyutlamasından kaynaklanır. SDK, imzalayacağınız veriyi (mesaj veya işlem) belirli bir formata dönüştürür ve ardından imzalar. SDK dışından doğrulama yaparken, bu "belirli formatı" (yani imzalanan byte dizisini) manuel olarak doğru bir şekilde yeniden oluşturmanız gerekir.
3. "Arbitrary mesaj" ile "Hedera işlemi" arasındaki fark nedir?
"Hedera işlemi", token transferi, akıllı sözleşme çağrısı gibi Hedera ağı üzerinde yürütülen, Protobuf ile tanımlanmış yapılandırılmış bir eylemdir. "Arbitrary mesaj" ise, ağ üzerinde bir işlem olarak kaydedilmeyen, rastgele bir metin veya veri parçasıdır ve genellikle bir kullanıcının kimliğini doğrulamak veya bir bildirimi imzalamak için kullanılır.
4. İmza doğrulama hatası alıyorum, ilk olarak neyi kontrol etmeliyim?
İlk olarak, imzalanan mesajın byte dizisinin (encoding dahil) hem imzalama hem de doğrulama tarafında tam olarak aynı olduğundan emin olun. Ardından, doğru açık anahtarı kullandığınızı ve imza ile açık anahtarın aynı kriptografik algoritmayı (Ed25519 veya ECDSA) kullandığını doğrulayın.