Hyperledger Fabric Web App Eğitimi

Eğitim Hakkında

Hyperledger Fabric ağına bağlanan uçtan uca web uygulaması geliştirmenin yolu

Bu eğitim, Hyperledger Fabric ağına bağlanan uçtan uca web uygulaması geliştirmeyi öğretir. Katılımcılar fabric-network SDK'sı, Gateway, kanal ve kontrat nesnelerini kullanarak chaincode'a bağlanır. Bağlantı profili ve cüzdanla kimlik yönetimini, CA ile kullanıcı kaydı ve enrollment'ı uygular. Node.js ve Express ile REST API kurar, submitTransaction ve evaluateTransaction çağrılarını uç noktalara bağlar. Program, ön yüzün API'ye bağlanması ve olay dinlemeyle tamamlanır.

Süre ve Format

3 Gün. Her gün dört modül; SDK kavramları anlatımla, uygulama geliştirme tek bir varlık yönetimi web projesiyle uygulamalı işlenir.

Seviye

Orta Seviye — Fabric SDK, Gateway ve REST katmanıyla blok zincirine bağlı web uygulaması geliştirmeye odaklanır

Öğrenme Metodu

SDK ve bağlantı kavramları anlatılır, ardından her konu örnek uygulamaya eklenerek Fabric'e bağlı bir web uygulaması adım adım kurulur.

Neden Bu Eğitim?

🖥️Uçtan uca uygulama

Chaincode'dan ön yüze kadar Fabric ağına bağlı gerçek bir web uygulamasını baştan sona geliştirerek bütünü kavrarsınız.

🔐Kimlik ve cüzdan

CA ile kullanıcı kaydı, enrollment ve cüzdan tabanlı kimlik yönetimini uygulayarak güvenli bağlantı kurmayı öğrenirsiniz.

🔗SDK ve REST

fabric-network Gateway ve Express ile chaincode'u REST uç noktalarına bağlayarak ön yüzün blok zinciriyle konuşmasını sağlarsınız.

Anahtar Konular

hyperledger fabric web app eğitimifabric sdk eğitimifabric-network gatewayblok zinciri web uygulamasıhyperledger fabric eğitiminode.js blok zincirifabric rest apiblok zinciri eğitimiakıllı sözleşme uygulamasıizinli blok zinciri

“Blok zinciri ancak kullanıcıya ulaştığında değer üretir; chaincode'u web'e bağlayan, güveni gerçek uygulamaya dönüştürür.”

Ön Koşullar

Eğitimden en iyi verimi almak için faydalı bilgi ve ortam gereksinimleri

1

Fabric ve chaincode

Fabric ağ bileşenlerine ve temel chaincode kavramına aşinalık, uygulamanın bağlandığı katmanı anlamak için gerekir.

2

Node.js deneyimi

Node.js ile async fonksiyon, npm paketleri ve modül kullanımına aşinalık SDK ve API geliştirmeyi kolaylaştırır.

3

REST ve HTTP

REST uç noktası, HTTP metodu ve JSON gibi temel web kavramlarına aşinalık API katmanı için faydalıdır.

4

Çalışma ortamı

Docker, Node.js ve bir kod düzenleyici kurulabilen, Fabric test ağı çalıştırabilen bir ortam gerekir.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı fabric-network SDK'sını kavrar, bağlantı profiliyle Gateway üzerinden ağa bağlanır ve kontrat nesnesine erişir.

Modül 1

fabric-network SDK'sı

fabric-network ve fabric-ca-client paketleri
Uygulama ile Fabric arasındaki katman
Gateway, Network ve Contract nesneleri
SDK'nın işlem gönderme ve sorgu rolü
Node.js uygulama iskeletinin kurulması
Eski SDK ile fabric-network farkı

Modül 2

Bağlantı Profili

connection profile (ccp) JSON yapısı
Peer, orderer ve CA uç noktaları tanımı
TLS sertifikalarının profilde yer alması
Kuruluş ve kanal bilgisinin yapılandırması
Profilin test ağından elde edilmesi
Profil yollarının uygulamada okunması

Modül 3

Cüzdan ve Gateway

Wallet ile kimlik saklama kavramı
FileSystemWallet ile yerel cüzdan
Gateway.connect ile ağa bağlanma
discovery seçeneği ile servis keşfi
getNetwork ile kanal ağına erişim
getContract ile chaincode kontratı alma

Modül 4

İlk İşlem ve Sorgu

evaluateTransaction ile salt okuma sorgusu
submitTransaction ile işlem gönderme
İşlem argümanlarının aktarılması
Dönen Buffer'ın JSON'a çözümlenmesi
Hata yakalama ve bağlantının kapatılması
Basit bir komut satırı istemci denemesi

Günün hedefiKatılımcı CA ile kullanıcı kaydeder ve enroll eder, Express ile REST API kurar, chaincode çağrılarını uç noktalara bağlar.

Modül 1

CA ile Kimlik Oluşturma

fabric-ca-client ile CA'ya bağlanma
admin kimliğinin enroll edilmesi
register ile yeni kullanıcı kaydı
enroll ile sertifika ve anahtar alma
Alınan kimliğin cüzdana yazılması
Kimlik yaşam döngüsü ve yenileme

Modül 2

Express REST Sunucusu

Express uygulamasının kurulması
Router ile uç nokta yapısının tasarımı
JSON gövde ayrıştırma middleware'i
Hata yönetimi ve durum kodu dönüşleri
Ortam değişkenleriyle yapılandırma
CORS ve güvenlik başlıklarının eklenmesi

Modül 3

Chaincode Çağrılarını Bağlama

POST uç noktasıyla varlık oluşturma
GET uç noktasıyla varlık sorgulama
PUT ile varlık güncelleme işlemi
submitTransaction çağrısının sarmalanması
İstek doğrulama ve girdi temizliği
Yanıtın JSON olarak döndürülmesi

Modül 4

Oturum ve Kullanıcı Bağlamı

İstek başına cüzdan kimliği seçimi
Kullanıcıya göre Gateway bağlantısı kurma
JWT veya basit token ile kimlik doğrulama
Yetkisiz erişimin engellenmesi
Bağlantı havuzu ve kaynak yönetimi
İşlem kimliğinin yanıta eklenmesi

Günün hedefiKatılımcı REST API'ye bağlı bir ön yüz kurar, chaincode olaylarını dinler, hataları yönetir ve uygulamayı yayına hazırlar.

Modül 1

Ön Yüz Entegrasyonu

Basit bir web arayüzünün kurulması
fetch ile REST uç noktalarına istek
Varlık listesinin arayüzde gösterimi
Form ile yeni varlık oluşturma akışı
İşlem durumu ve geri bildirim gösterimi
Hata mesajlarının kullanıcıya iletilmesi

Modül 2

Olay Dinleme ve Bildirim

contract.addContractListener kullanımı
Chaincode olaylarının yakalanması
Blok ve işlem olaylarının dinlenmesi
Olaya göre arayüzün güncellenmesi
WebSocket ile ön yüze olay iletimi
Olay checkpoint ve yeniden bağlanma

Modül 3

Hata Yönetimi ve Dayanıklılık

Endorsement hatalarının ele alınması
Zaman aşımı ve yeniden deneme stratejisi
İşlem onayı (commit) bekleme yönetimi
Bağlantı kopması ve yeniden bağlanma
Loglama ve izlenebilirlik eklenmesi
Girdi doğrulama ile hatayı önleme

Modül 4

Yapılandırma ve Dağıtım

Ortama göre yapılandırma yönetimi
Uygulamanın Docker ile konteynerlenmesi
Gizli bilgi ve sertifikaların güvenli tutulması
Reverse proxy ve TLS sonlandırma
Sağlık kontrolü uç noktası eklenmesi
Üretim ağına bağlanırken dikkat edilecekler

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

SDK ve Gateway

fabric-network SDK'sıyla Gateway üzerinden ağa bağlanır, kanal ve kontrat nesnelerine erişebilirsiniz.

✅

Bağlantı profili

Bağlantı profilini okur, peer, orderer ve CA uç noktalarını yapılandırarak güvenli bağlantı kurabilirsiniz.

✅

Kimlik yönetimi

CA ile kullanıcı kaydeder, enroll eder ve kimlikleri cüzdanda yöneterek kullanıcı bazlı erişim sağlarsınız.

✅

REST API katmanı

Express ile REST uç noktaları kurar, chaincode çağrılarını HTTP metotlarına güvenle bağlayabilirsiniz.

✅

İşlem ve sorgu

submitTransaction ve evaluateTransaction çağrılarını uç noktalara bağlar, yanıtları JSON olarak döndürebilirsiniz.

✅

Ön yüz entegrasyonu

REST API'ye bağlı bir web arayüzü kurar, varlıkları listeler ve form ile işlem gönderebilirsiniz.

✅

Olay dinleme

Chaincode ve blok olaylarını dinler, olaya göre arayüzü güncelleyip gerçek zamanlı geri bildirim verebilirsiniz.

✅

Dağıtım akışı

Uygulamayı Docker ile konteynerler, yapılandırma ve sertifikaları güvenle yöneterek yayına hazırlayabilirsiniz.

Kimler İçin Uygundur?

Hyperledger Fabric'te chaincode yazmayı bilen ve bunu bir web uygulamasıyla kullanıcıya açmak isteyen Node.js geliştiricileri
tam yığın yazılımcılar
blok zinciri çözüm mühendisleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Hyperledger Fabric'te chaincode yazmayı bilen ve bunu bir web uygulamasıyla kullanıcıya açmak isteyen Node.js geliştiricileri, tam yığın yazılımcılar ve blok zinciri çözüm mühendisleri için uygundur. Temel Fabric ve Node.js aşinalığı beklenir.

Chaincode yazmayı bilmem gerekir mi?

Bu eğitim uygulama katmanına odaklanır; hazır bir örnek chaincode üzerinden çalışırız, dolayısıyla sıfırdan chaincode yazmayı bilmek şart değildir. Ancak Fabric kavramlarına ve Node.js'e aşina olmak gerekir. İsterseniz chaincode geliştirme eğitimiyle birlikte alınabilir.

Hangi araçlar ve kütüphaneler kullanılıyor?

Eğitimde fabric-network ve fabric-ca-client SDK'ları, Fabric v2 test ağı, Node.js ve Express, cüzdan için FileSystemWallet, kimlik için Fabric CA, konteynerleme için Docker ve ön yüzde temel HTML/JavaScript ile fetch kullanılır. Araçlar kurum ihtiyacına göre uyarlanabilir.

Composer Playground eğitiminden farkı nedir?

Composer eğitimi iş ağını üst düzeyde modellemeye odaklanır. Bu eğitim ise güncel fabric-network SDK'sıyla chaincode'a doğrudan bağlanan, kimlik yöneten ve REST API ile ön yüz sunan gerçek bir web uygulaması geliştirmeye odaklanır; üretime daha yakın bir yaklaşımdır.

Eğitim sonunda sertifika veriliyor mu?

Programı tamamlayan katılımcılar Digital Vizyon Akademi Katılım ve Başarı Sertifikası alır. Sertifika tamamlanan modülleri ve geliştirilen örnek web uygulaması projesini belgeler; kurumsal gruplara özel uyarlama yapılabilir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika