Support Hub/API & Integrations/Protokol Adaptörü Mimarisi: Eski SDK'dan Bulut API'sine
Translated from the English article and reviewed by a person. Read the English original
Developer

Protokol Adaptörü Mimarisi: Eski SDK'dan Bulut API'sine

Protokol Adaptörü Mimarisi: Eski SDK'dan Bulut API'sine

Kurumsal sistemlerin çoğu birbiriyle konuşmak üzere tasarlanmamıştır. Tasarlandıkları dönemde mantıklı görünen iletişim modeline uygun, belirli bir işi yapmak için geliştirilmişlerdir. Protokol adaptörü mimarisi, bu iki dünyayı birbirini yeniden yazmadan bağlayan mühendislik disiplinidir. Bu makale, protokol adaptörlerinin ne olduğunu, teknik düzeyde nasıl çalıştıklarını ve kurumsal entegrasyondaki en kalıcı sorunlardan birine, yani biyometrik cihaza, neden en pratik çözüm olduklarını açıklamaktadır.

Protokol Nedir ve Neden Bağımlılık (Lock-In) Yaratır

Protokol adaptörlerini anlamadan önce, protokolün gerçekte ne olduğuna dair net bir tanıma ihtiyacınız var. Yazılım ve donanım iletişiminde protokol, verinin nasıl biçimlendirildiğini, iletildiğini ve iki taraf arasında nasıl yorumlandığını yöneten kurallar bütünüdür. Paket yapısını, bağlantı modelini, el sıkışma (handshake) sırasını, kodlama biçimini ve hata yönetimi davranışını tanımlar.

Protokoller bağımlılık yaratır, çünkü iki tarafın da aynı dili konuşmasını gerektirirler. Protokol A kullanarak iletişim kuran bir yazılım yazarsanız, yalnızca Protokol A'yı da uygulayan sistemlerle iletişim kurabilir. İşlevsel olarak ne kadar benzer olursa olsun, Protokol B kullanan herhangi bir sisteme, bir çeviri katmanı olmadan ulaşılamaz.

Bu, protokol tasarımındaki bir kusur değildir. Yapılandırılmış iletişimin kaçınılmaz bir sonucudur. Sorun, bir cihazın veya sistemin kullandığı protokolün, ekosistemin geri kalanının geçtiği iletişim standartlarına göre eskimesiyle ortaya çıkar. Cihaz hâlâ çalışır. Verisi hâlâ değerlidir. Ama protokolü bir duvara dönüşmüştür.

Protokol bağımlılığına somut bir örnek

2010 yılında üretilmiş bir parmak izi biyometrik terminali, üreticisi tarafından tanımlanmış ikili (binary) bir TCP protokolü kullanarak iletişim kurar. Terminal, yoklama verilerini her gün doğru biçimde kaydeder. Ancak şirketinizin 2023 yılında benimsediği İK Yönetim Sistemi (HRMS), REST ve HTTPS üzerinden JSON ile iletişim kurar. Bu iki sistemin ortak bir protokolü yoktur. Her iki sistemin tek tek ne kadar yetenekli olduğuna bakılmaksızın doğrudan iletişim kuramazlar. Protokoller arasında bir şey çeviri yapmadığı sürece, terminaldeki veriye İK Yönetim Sistemi erişemez.

Protokol Çözücü Olarak SDK: Gerçekte Ne Yapar

Bir biyometrik cihaz üreticisi cihazını standart bir protokolle açığa çıkaramadığında, bir SDK dağıtır. SDK'nın teknik düzeyde gerçekte ne yaptığını anlamak, neden var olduğunu ve neden bu kadar önemli mimari sorunlar yarattığını açıklamaya yardımcı olur.

SDK (Software Development Kit, Yazılım Geliştirme Kiti), bir geliştiricinin belirli bir cihaz veya hizmetle iletişim kurabilmesi için bir makineye yüklediği derlenmiş kod kütüphaneleri, başlık dosyaları ve dokümantasyon bütünüdür. Biyometrik cihazlar bağlamında SDK iki kritik işlevi yerine getirir.

Birincisi, bağlantı katmanını yönetir. SDK, cihazın beklediği kalıcı TCP soket bağlantısını kurar ve sürdürür. El sıkışma sırasını yönetir, bağlantıyı canlı tutar ve cihaz çevrimdışı olduğunda yeniden bağlanmayı sağlar. Bu bağlantı yönetimi kodu karmaşıktır ve tamamen üreticinin protokol uygulamasına özgüdür.

İkincisi, çözümleme (decoding) katmanını yönetir. Cihazın gönderdiği her paket, ham ikili baytlar olarak gelir. SDK, bu baytları bir geliştiricinin çalışabileceği anlamlı veri yapılarına dönüştüren arama tablolarını, bit maskelerini ve ayrıştırma fonksiyonlarını içerir. Bu çözümleme katmanı olmadan, cihazdan gelen ikili akış anlamsızdır.

Cihazdan gelen veri

Kalıcı bir TCP soketi üzerinden sürekli bir ikili bayt akışı. Her baytın anlamı, paket içindeki konumuna, paket türü tanımlayıcısına ve cihaz yazılımı sürümüne bağlıdır. Bu katmanda insan tarafından okunabilir bir yapı yoktur.

SDK'nın geliştiricilere sunduğu

Adlandırılmış fonksiyon çağrıları ve veri nesneleri. enrollUser(), getAttendanceLogs(), revokeAccess(). SDK, ikili dünyayı, geliştiricinin alttaki kablo formatını bilmeden çağırabileceği programatik bir arayüze dönüştürür.

SDK, sınırlı bir anlamda bir protokol adaptörüdür. Cihazın ikili protokolünü, çağrılabilir bir programlama arayüzüne uyarlar. Mimari sorun şudur: bu uyarlama yalnızca tek yönde çalışır, yalnızca SDK'nın kurulu olduğu makinelerde çalışır, yalnızca için yazıldığı cihaz markası için çalışır ve yalnızca SDK'nın derlendiği dilin çalışma modeli içinde çalışır.

SDK Tabanlı Mimari Neden Ölçeklenemez

SDK modeli, tasarlandığı dünya için makul bir çözümdü: yerel bir makinede çalışan, yerel alan ağı üzerinden tek bir marka cihazla iletişim kuran tek bir masaüstü uygulaması. Bu bağlamda SDK iyi çalışır. Sınırlamalar yalnızca mimari gereksinimler değiştiğinde görünür hâle gelir.

Kurulum bağımlılığı sorunu

SDK, entegrasyon kodunu çalıştıran makineye kurulmak zorundadır. Bu, entegrasyonunuzun konteynerleştirilmiş bir bulut ortamında, sunucusuz bir fonksiyonda veya barındırılan bir otomasyon platformunda çalışamayacağı anlamına gelir. SDK dosyalarının mevcut olduğu belirli bir makinede çalışmak zorundadır. Bu makine devreden çıkarılır, yeniden kurulur veya farklı bir işletim sistemine taşınırsa, entegrasyon bozulur.

2026 yılında, çoğu kurumsal yazılım altyapısı bulut yerel (cloud-native) dağıtıma yönelmiştir. Konteyner orkestrasyonu, sunucusuz fonksiyonlar ve yönetilen bulut hizmetleri standarttır. Konteynerler durumsuz (stateless) ve geçicidir. Dağıtımlar arasında kurulu yazılım kütüphanelerini korumazlar. Bu nedenle SDK bağımlılığı, bu modelle mimari olarak uyumsuzdur.

Çoklu marka çokluğu sorunu

Her biyometrik cihaz üreticisi kendi SDK'sını dağıtır. Bu SDK'lar birbiriyle uyumlu değildir. ZKTeco SDK'sı bir Hikvision cihazıyla iletişim kuramaz. Suprema SDK'sı bir Anviz cihazıyla iletişim kuramaz. Kuruluşunuz farklı sitelerde birden fazla üreticinin donanımını kullanıyorsa, her marka için ayrı bir SDK entegrasyonuna ihtiyacınız olur.

Bu durum her bakım yükünü çoğaltır. Bir üreticinin yazılım güncellemesi ikili paket yapısını değiştirebilir, bu markanın SDK entegrasyonunu bozarken diğerlerini etkilemeyebilir. Her entegrasyon ayrı ayrı bakımı yapılmalı, izlenmeli ve güncellenmelidir.

Dil ve çalışma zamanı sınırı sorunu

Çoğu biyometrik cihaz SDK'sı, Windows'a özgü ikili dosyalar olarak derlenmiş C veya C++ kütüphaneleri şeklinde dağıtılır. Entegrasyon katmanınız Python, Node.js veya Go ile yazılmışsa, ek bir çeviri sorunuyla karşılaşırsınız: C kütüphane fonksiyonlarını yönetilen bir çalışma ortamından çağırmak, platforma özgü yabancı fonksiyon arayüzü kodu gerektirir. Bu kod kırılgandır ve işletim sistemi sürümleri arasında bakımı zordur.

Birikimli bakım yükü

Üç biyometrik cihaz markası için SDK entegrasyonları oluşturmuş bir mühendislik ekibi, tek bir entegrasyonu bakımını yapmıyor. Her biri kendi bağlantı mantığına, ikili ayrıştırma koduna, hata yönetimine ve yazılım uyumluluk yüzeyine sahip üç tamamen ayrı kod tabanını sürdürüyorlar. Bir yazılım güncellemesi bir entegrasyonu bozduğunda, sorunu teşhis etmek o üreticinin ikili protokolüne derin bir hâkimiyet gerektirir. Bu bilgi nadiren belgelenir ve çoğu zaman yalnızca entegrasyonu ilk yazan mühendisin aklındadır.

Protokol Adaptörü Deseni: Resmi Bir Tanım

Protokol adaptörü deseni, iki sistem arasına özel bir çeviri katmanı yerleştirerek uyumsuz iletişim protokollerinin sorununu çözen, iyi bilinen bir yazılım mimarisi desenidir. Adaptör, bir tarafta kaynak sistemin yerel dilini, diğer tarafta hedef sistemin beklediği dili konuşur. Hiçbir sistemin değişmesi gerekmez.

Yazılım mühendisliğinde bu desen bazen Adapter deseni veya Translator deseni olarak adlandırılır. Ağ mühendisliğinde, protokol geçitlerinin (gateway) arkasındaki ilkedir. Kurumsal entegrasyonda ise mesaj aracılarının ve entegrasyon platformlarının temelidir. Belirli uygulama ayrıntıları değişir, ancak temel mimari kavram tutarlıdır: çeviri sorumluluğunu izole etmek, böylece ne kaynak ne de hedef sistemin diğerinin iletişim modelini bilmesi veya önemsemesi gerekir.

Adaptör desenini daha basit anlatmak

Evrensel bir elektrik adaptörü, Avrupa tipi iki pimli fişi olan bir cihazı İngiliz tipi üç pimli prize takmanızı sağlar. Cihaz değişmez. Priz değişmez. Adaptör, iki uyumsuz fiziksel standart arasındaki çeviriyi yapar. Protokol adaptörü, yazılım iletişim standartları için aynısını yapar. Biyometrik cihaz ikili protokolü konuşmaya devam eder. Bulut API'si JSON'u HTTPS üzerinden konuşmaya devam eder. Adaptör ikisi arasında çeviri yapar.

Biyometrik Protokol Adaptörünün Dört Katmanı

Biyometrik cihazlar için iyi tasarlanmış bir protokol adaptörü tek bir fonksiyon değildir. Her katmanın belirli ve sınırlı bir sorumluluğu olduğu katmanlı bir mimaridir. Bu katmanları anlamak, sağlam bir adaptör oluşturmanın ilk bakışta göründüğünden neden daha karmaşık olduğunu ve neden amaca yönelik bir çözümün özel bir entegrasyondan çok daha güvenilir olduğunu açıklamaya yardımcı olur.

Protokol adaptörü mimarisi, dört katman
Katman 4, Tüketici
n8n Workflow
AI Agent
HRMS
ERP Sistemi
Özel Uygulama
| HTTPS üzerinden JSON |
Katman 3, API yüzeyi
REST Uç Noktaları
Webhook Yayıncısı
MCP Server
Kimlik Doğrulama ve Hız Sınırlama
| Normalleştirilmiş Dahili Olaylar |
Katman 2, Protokol adaptörü çekirdeği
Bağlantı Yöneticisi
İkili Veri Çözücü
Olay Normalleştiricisi
Komut Kodlayıcı
Dayanıklılık Yöneticisi
| Yerel İkili Protokol |
Katman 1, Fiziksel cihazlar
ZKTeco
Hikvision
Suprema
Anviz
eSSL
15+ diğer
Katman 1
Fiziksel Cihaz Katmanı
Biyometrik verileri yakalayan donanım. Her cihaz, üreticiye özgü paket formatları, bağlantı modelleri ve komut kümeleri kullanarak TCP üzerinden tescilli bir ikili protokol konuşur. Bu katman değişmez. Adaptör, onunla kendi yerel dilinde iletişim kurar.
Katman 2
Protokol Adaptörü Çekirdeği
Çeviri motoru. Her cihaza kalıcı bağlantılar sürdürür, ikili paketleri yapılandırılmış verilere çözer, farklı cihaz markalarından gelen olayları tutarlı bir dahili biçime normalleştirir, giden komutları yeniden ikili biçime kodlar ve cihazlar çevrimdışı olduğunda bağlantı dayanıklılığını yönetir.
Katman 3
API Yüzey Katmanı
Tüketicilerin etkileşim kurduğu dışa dönük arayüz. Cihaz işlemlerini REST uç noktaları olarak sunar, gerçek zamanlı olayları JSON webhook'ları olarak yayımlar ve isteğe bağlı olarak tam işlem kümesini yapay zekâ ajanı kullanımı için bir MCP sunucusu olarak açığa çıkarır. Bu katman, altındaki ikili dünyadan tamamen ayrıdır.
Katman 4
Tüketici Katmanı
Biyometrik verilerle etkileşime girmesi veya biyometrik cihazlara talimat göndermesi gereken her sistem. İş akışı otomasyon platformları, yapay zekâ ajanları, İK Yönetim Sistemleri (HRMS), ERP entegrasyonları ve özel uygulamaların tümü yalnızca API yüzey katmanıyla etkileşime girer. Altlarındaki ikili protokollerden haberleri yoktur.

Adaptör Çekirdeğinin İçinde: Çeviri Gerçekte Neleri Kapsar

Gerçek karmaşıklık adaptör çekirdeğinde yaşanır. Beş bileşenin her biri, doğrudan entegrasyonu pratik olmaktan çıkaran belirli bir teknik zorluğu ele alır.

Bağlantı Yöneticisi

Biyometrik cihazlar kalıcı bir TCP bağlantısı bekler. Bağlantı yöneticisi, cihaz başına uzun süre açık kalan tek bir soket bağlantısını sürdürür, yazılımı cihaza doğrulayan üreticiye özgü el sıkışmayı yönetir, keepalive yoklamaları aracılığıyla bağlantı sağlığını izler, bağlantı kopmalarını algılar ve uygun bekleme süreleriyle yeniden bağlanma mantığını çalıştırır. Birden fazla sitede 50 cihazı yöneten bir sistem için bağlantı yöneticisi, her biri kendi durum makinesine sahip 50 eş zamanlı soket oturumunu aynı anda çalıştırır.

İkili Veri Çözücü

Bir cihazdan gelen her paket, üretici tarafından tanımlanmış belirli bir yapıya sahip bayt dizisidir. İkili veri çözücü, bu paketleri bilinen bayt konumlarından sabit genişlikli alanları okuyarak, bayrak değerlerini çıkarmak için bit maskeleri uygulayarak, ikili kodlanmış zaman damgalarını standart tarih-saat biçimlerine dönüştürerek ve standart UTF-8 olmayabilecek karakter kümelerini çözerek ayrıştırır. Çözücü, bilinen bir konumdaki tür baytıyla tanımlanan birden fazla paket türünü işlemelidir ve her paket türünü uygun ayrıştırma rutinine yönlendirmelidir.

Olay Normalleştiricisi

ZKTeco cihazında gerçekleşen bir parmak izi tarama olayı, Hikvision cihazındaki eşdeğer olaydan farklı alan adları, farklı zaman damgası biçimleri ve farklı durum kodlarıyla gelir. Olay normalleştiricisi, üreticiye özgü her olay temsilini tek, tutarlı bir dahili olay şemasına eşler. Bu normalleştirme adımı, Katman 3 ve Katman 4'ün tamamen marka bağımsız olmasını sağlar. Tüketici, olayı hangi cihazın ürettiğinden bağımsız olarak aynı JSON yapısını alır.

Punchlog Payload İsteği, Callback Endpoint'e gönderilir
{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckIn",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiiPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}

Komut Kodlayıcı

Yukarıdaki punchlog payload'u, fiziksel bir cihazdan Biyometrik Geçit'e gerçek zamanlı bir biyometrik olay ulaştığında İkili Veri Çözücü ve Olay Normalleştiricisinin ürettiği çıktıdır. Bu yapılandırılmış JSON daha sonra yapılandırdığınız callback endpoint'e yayımlanır; bu bir n8n Webhook düğümü, bir yapay zekâ ajanı, bir İK Yönetim Sistemi endpoint'i veya başka herhangi bir tüketici olabilir.

Komut Kodlayıcı ters yönde çalışır. Bir tüketici API yüzeyine JSON talimatı gönderdiğinde, örneğin yeni bir kullanıcıyı kaydetme veya erişim izinlerini iptal etme isteği, Komut Kodlayıcı bu yapılandırılmış JSON'u hedef cihazın beklediği ikili komut paketine çevirir. Alan değerlerini o üreticinin protokolü için doğru bayt konumlarına yerleştirir, paket türü tanımlayıcısını ekler, gerekli sağlama toplamlarını hesaplayıp ekler ve ortaya çıkan ikili çerçeveyi cihazın kalıcı soketine yazar. Tüketici tarafından temiz JSON olarak bir kez ifade edilen aynı mantıksal talimat, bu komutu alan cihaz markasına bağlı olarak kabloda tamamen farklı bir ikili yapıya dönüşür. Komut Kodlayıcı bu tüm farklılıkları dahili olarak yönetir, böylece tüketicinin bunlarla uğraşması gerekmez.

Dayanıklılık Yöneticisi

Operasyonel ortamlardaki fiziksel cihazlar çevrimdışı olabilir. Güç kesintileri, ağ kesintileri ve cihaz yeniden başlatmaları olağan olaylardır. Dayanıklılık yöneticisi, bağlantı kopması sırasında gelen olayları kaybolmaması için tamponlar, bağlantı yeniden kurulana kadar iletilemeyen giden komutları kuyruğa alır, yeniden başlatılan bir cihazı aşırı yüklememek için yeniden bağlanma girişimlerinde üstel geri çekilme (exponential backoff) uygular ve cihaz kullanılamadığı için bir işlem tamamlanamadığında tüketicilere yapılandırılmış hata yanıtları sunar.

İyi Bir Protokol Adaptörünü Tanımlayan Mimari Özellikler

Tüm protokol adaptörleri eşit değildir. İyi tasarlanmış bir adaptör, onu kırılgan bir özel entegrasyondan ayıran belirli mimari özelliklere sahiptir.

Mimari Özellik Özel SDK Entegrasyonu Amaca Yönelik Protokol Adaptörü
Dağıtım modeli Yerinde (on-premises), SDK'ya bağımlı makine Bulut yerel, konteynerleştirilebilir, yerel SDK yok
Çoklu marka desteği Marka başına bir entegrasyon Tüm markalarda tek API yüzeyi
Tüketici protokolü Dile özgü SDK çağrıları Standart REST ve JSON, her dil
Gerçek zamanlı olay iletimi Sorgulama veya hiç yok Her olayda webhook ile anlık iletim
Yazılım güncellemelerine dayanıklılık Sessizce bozulabilir Adaptör katmanı değişiklikleri absorbe eder
Bağlantı dayanıklılığı Manuel yönetim gerekli Yerleşik yeniden bağlanma ve olay tamponlama
Yapay zekâ ajanı uyumluluğu Ek katman olmadan mümkün değil REST ve MCP ile yerel destek
Denetim kaydı Özel uygulama gerekli Her işlemde otomatik

Bulut Dağıtımı Protokol Adaptörü Gereksinimlerini Neden Değiştirir

Yerinde altyapıdan bulut yerel kurumsal altyapıya geçiş, protokol adaptörünün ne olması gerektiğini temelden değiştirir. Yerinde dağıtım için tasarlanmış bir adaptör, yerel SDK kurulumlarına, sabit ağ yapılandırmalarına ve kalıcı sunucu süreçlerine dayanabilir. Bulut dağıtımı için tasarlanmış bir adaptör bunların hiçbirine dayanamaz.

Durumsuz ve durumlu tasarım karşılaştırması

Bulut yerel dağıtım ortamları durumsuz süreçleri tercih eder. Durumsuz bir süreç, tüm kalıcı durum dışarıda saklandığı için önemli veri kaybetmeden başlatılabilir, durdurulabilir ve yeniden başlatılabilir. Biyometrik cihaz bağlantıları doğası gereği durumludur: etkileşimler boyunca bağlantı bağlamını tutan kalıcı bir soket gerektirirler. Bulut yerel bir protokol adaptörü, bu durumu dışsallaştırmalı, bağlantı meta verilerini kalıcı bir depoda tutmalı ve bağlantı bağlamının süreç yeniden başlatmalarından sağ çıkmasını sağlamalıdır.

Bağlantı yönetiminin API sunumundan ayrılması

İyi yapılandırılmış bir bulut protokol adaptörü, bağlantı yönetimi katmanını API sunum katmanından ayırır. Bağlantı yönetimi katmanı, kalıcı cihaz bağlantılarını sürdüren ve normalleştirilmiş olayları dahili bir mesaj kuyruğuna yayımlayan özel bir hizmet olarak çalışır. API sunum katmanı bu kuyruktan okur ve REST isteklerini bağımsız olarak yanıtlar. Bu ayrım her katmanın bağımsız olarak ölçeklenmesini sağlar ve bir API sunum sürecinin yeniden başlatılmasının etkin cihaz bağlantılarını kesmemesi anlamına gelir.

Bu ayrımın pratikte neden önemli olduğu

API sunucunuz ile cihaz bağlantı yöneticiniz aynı süreçse, bir güncelleme dağıtmak için API sunucusunu yeniden başlatmak tüm etkin cihaz bağlantılarını keser. Ayrı süreçlerse, bağlantı yöneticisine dokunmadan API sunucusuna güncelleme dağıtabilirsiniz ve etkin cihaz bağlantıları kesintisiz kalır. Cihazların yoklama olaylarını sürekli işlediği bir operasyonel ortamda, bağlantı sürekliliği bir kolaylık değil, bir veri bütünlüğü gereksinimidir.

Geçiş Yolu: SDK'dan Protokol Adaptörüne Geçiş

Şu anda SDK tabanlı entegrasyonlara güvenen kuruluşların her şeyi bir anda yeniden oluşturmaları gerekmez. Protokol adaptörü mimarisi kademeli olarak tanıtılacak şekilde tasarlanmıştır; adaptör, mevcut SDK entegrasyonundan sorumlulukları kademeli olarak devralır.

1
Mevcut SDK kurulumunuzu denetleyin
Hiçbir şeye dokunmadan önce, tüm SDK bağımlılık yüzeyinizi belgeleyin: hangi cihaz markalarının bağlı olduğunu, SDK'nın hangi makinelere kurulu olduğunu, hangi sistemlerin SDK çıktısını tükettiğini ve mevcut veri akışınızın nasıl göründüğünü. Bu denetim, Protokol Adaptörünün tam olarak neyi ve hangi sırayla değiştirmesi gerektiğini tanımlar.
2
Tüketicilerinizi geçişe hazırlayın
Cihaz aynı anda yalnızca bir sisteme, SDK'ya veya Protokol Adaptörüne bağlanabildiğinden, geçiş gerçekleşmeden önce her tüketici sistemin geçişe hazır olması gerekir. Bu, İK Yönetim Sistemi entegrasyonlarını, n8n iş akışlarını, yapay zekâ ajanı yapılandırmalarını ve mevcut SDK çıktısını okuyan diğer tüm sistemleri, adaptör devraldığı anda Protokol Adaptörü API'sini gösterecek şekilde güncellemek anlamına gelir. Tüm bu hazırlıkları SDK'nın bağlantısını kesmeden önce tamamlayın.
3
SDK bağlantısını kesin ve Protokol Adaptörünü bağlayın
Cihazdaki mevcut SDK bağlantısı önce sonlandırılır. Ardından Protokol Adaptörü, aynı cihazla kendi kalıcı bağlantısını, o cihazın yerel protokolünü kullanarak kurar. Bu andan itibaren tüm cihaz olayları Protokol Adaptörü üzerinden akar ve yapılandırdığınız tüketicilere JSON callback'leri olarak iletilir. Her iki sistemin aynı anda aynı cihaza bağlı olduğu bir dönem yoktur.
4
Yeni bağlantıyı doğrulayın ve izleyin
Geçişten sonra, olayların tüm tüketici endpoint'lerine doğru ulaştığını, JSON payload yapısının tüketicilerin beklediğiyle eşleştiğini ve hiçbir olayın kaybolmadığını doğrulayın. Geçişi kapatmadan önce, Protokol Adaptörünün API'si üzerinden belirlenmiş bir doğrulama süresi boyunca cihaz bağlantı durumunu izleyin.
5
SDK kurulumunu kaldırın ve genişletin
Doğrulama süresi kararlı çalışmayı teyit ettikten sonra, SDK kurulumunu tamamen kaldırın. Yerinde bağımlılık ortadan kalkar. Protokol Adaptörüne yeni cihaz markaları eklemek, tüm markalar aynı API yüzeyi üzerinden sunulduğu için tüketiciye yönelik herhangi bir yeni değişiklik gerektirmez. Yapay zekâ ajanları, otomasyon iş akışları veya yeni dahili sistemler gibi yeni tüketiciler, diğer tüm tüketicilerin zaten kullandığı aynı REST API'sine bağlanır.

Protokol Adaptörü Tasarımında Uyumluluk Değerlendirmeleri

Biyometrik veriler bir protokol adaptöründen geçtiğinde, adaptör çoğu veri koruma çerçevesi kapsamında yasal anlamda bir veri işleyicisi (data processor) haline gelir. Bu, adaptör mimarisinde ele alınması gereken belirli tasarım yükümlülükleri yaratır.

  • GDPR, AB: Adaptör, normalleştirme katmanında veri minimizasyonunu uygulamalıdır. Tüketicilere iletilen olay verileri yalnızca belirli amaç için gerekli alanları içermelidir. Adaptör, biyometrik şablon verilerini devam eden işlem için gerekenden daha uzun süre saklamamalıdır.
  • CCPA ve CPRA, Kaliforniya: Adaptör, biyometrik verileri onaylanmış amacın ötesinde profilleme veya yeniden tanımlamayı mümkün kılacak şekilde tüketicilere sunmamalıdır. API erişim kontrolleri, tüketici düzeyinde amaç sınırlamasını zorunlu kılmalıdır.
  • LGPD, Brezilya: İşleme kayıtları, adaptörü belirli rolüyle, dokunduğu verilerle ve her katmanda uygulanan saklama kurallarıyla birlikte bir işleme bileşeni olarak belgelemelidir.
  • PDPA, Singapur, Malezya, Tayland: API yüzeyindeki erişim kontrolleri, rızaya dayalı kısıtlamaları zorunlu kılmalıdır. Tüketiciler yalnızca veri sahibinin onayladığı amaçlar için veri almalıdır.
  • ISO 27001 ile uyumlu kontroller: Adaptör, hem cihaz bağlantı katmanında (cihaz protokolünün izin verdiği yerlerde) hem de API yüzey katmanında aktarım sırasında şifreleme uygulamalıdır. API uç noktalarına erişim kimlik doğrulamalı olmalıdır. Tüm işlemler değiştirilemez denetim kaydı girdileri üretmelidir.

Sık Sorulan Sorular

Protokol adaptörü, API geçidi (API gateway) ile aynı şey midir?
Birbiriyle ilişkilidirler ancak farklıdırlar. Bir API geçidi, API tüketicileri ile API sağlayıcıları arasındaki trafiği yönetir; kimlik doğrulama, hız sınırlama ve yönlendirme gibi konuları ele alır. Bir protokol adaptörü ise uyumsuz iletişim protokolleri arasında çeviri yapar ve verileri bir biçimden ve bağlantı modelinden diğerine dönüştürür. Biyometrik bağlamda, protokol adaptörü ikili cihaz iletişimini JSON REST'e dönüştürür. Bir API geçidi, kurumsal düzeydeki trafik yönetimini üstlenmek için adaptörün REST yüzeyinin önüne yerleştirilebilir. Olgun bir mimaride ikisi birlikte bulunabilir, ancak farklı sorunları çözerler.
Protokol adaptörü, gerçek zamanlı erişim kontrolü işlemlerinde gecikmeye neden olabilir mi?
İyi tasarlanmış bir adaptör, yoklama sorguları gibi okuma işlemlerine minimum gecikme ekler. Gerçek zamanlı olarak fiziksel bir cihaza yayılması gereken erişim izni gibi yazma işlemleri için, adaptörün komut kodlayıcısı ikili komutu, zaten kurulmuş olan mevcut kalıcı soket bağlantısı üzerinden gönderir. Gidiş-dönüş süresi, adaptörün işlem yükünden değil, cihaza olan ağ gecikmesinden kaynaklanır. Adaptör çekirdeğinin kendisinden kaynaklanan gecikme tipik olarak tek haneli milisaniye düzeyinde ölçülür.
Bir cihaz yazılım güncellemesi ikili protokolü değiştirdiğinde ne olur?
Bu, adaptör deseninin en önemli avantajlarından biridir. Bir yazılım güncellemesi ikili paket formatını değiştirdiğinde, yalnızca adaptörün ikili veri çözücü bileşeninin güncellenmesi gerekir. API yüzeyi değişmez. Tüm tüketiciler her zaman aldıkları aynı JSON formatını almaya devam eder. n8n iş akışları, yapay zekâ ajanları veya İK Yönetim Sistemleri gibi tüketici tarafındaki entegrasyonların hiçbirinin değiştirilmesi gerekmez. Yazılım değişikliği tamamen adaptör katmanı içinde absorbe edilir.
Adaptör, aynı ağdaki farklı üreticilerin cihazlarını nasıl yönetir?
Her cihaz markasının, adaptörün bağlantı yöneticisinde kayıtlı karşılık gelen bir protokol işleyicisi vardır. Adaptör, her marka için ayrı bağlantı havuzları tutar; her biri o üretici için uygun bağlantı mantığını ve ikili veri çözücüyü çalıştırır. API yüzeyi açısından bakıldığında tüm cihazlar aynı ad alanında görünür ve aynı API çağrılarına yanıt verir. Cihaz markası, tüketiciye hiçbir zaman yansımayan dahili bir yönlendirme konusudur.

Sonuç: Cams Biometrics Gateway Bu Mimarinin Hayata Geçirilmiş ve Çalışan Hâlidir

Protokol adaptörü mimarisi, biyometrik entegrasyon sorununa doğru mühendislik yanıtıdır. Bir geçici çözüm değildir. Acilen ihtiyaç duyulan belirli bir alana uygulanan, iyi kurulmuş bir desendir.

Cams Biometrics Gateway, bu mimarinin üretim ortamındaki bir uygulamasıdır. 15 veya daha fazla üreticiye ait cihazlarla kalıcı bağlantılar sürdürür, desteklenen her protokol için bir ikili veri çözücü ve olay normalleştiricisi çalıştırır ve tam işlem kümesini birleşik bir REST API'si ve MCP sunucusu üzerinden sunar. Sonuç, HTTPS üzerinden standart JSON ile erişilebilen 38 biyometrik işlem, her cihaz olayı için gerçek zamanlı webhook callback'leri ve altyapınızın hiçbir yerinde SDK kurulumu gerektirmemesidir.

Kuruluşunuzda biyometrik verileri tüketmesi gereken biyometrik cihazlar ve sistemler varsa, eksik olan mimari parça protokol adaptörü katmanıdır. Cams Biometrics Gateway API'sini CamsBiometrics.com adresinde inceleyebilir veya mevcut donanımınızı hak ettiği modern bulut API katmanına bağlamak için ekibimizle görüşebilirsiniz.

Was this article helpful?