Support Hub/API & Integrations/Native Push vs. modurile Hybrid: arbore tehnic de decizie
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push vs. modurile Hybrid: arbore tehnic de decizie

Native Push vs. modurile Hybrid: arbore tehnic de decizie

Fiecare dispozitiv biometric conectat la Cams Biometric Gateway se conectează prin unul dintre cele două moduri Push. Modul utilizat de dispozitiv determină ce API-uri sunt disponibile, modul în care evenimentele sunt livrate și modul în care infrastructura dvs. trebuie configurată. Acest ghid parcurge fiecare variabilă din decizie, de la tipul dispozitivului la metoda de comunicare și topologia de implementare, astfel încât să puteți alege calea potrivită înainte de a începe dezvoltarea.

Prima întrebare: ce tip de dispozitiv conectați?

Înainte de a alege o metodă de comunicare sau o topologie de implementare, trebuie să răspundeți la o întrebare mai fundamentală: dispozitivul dvs. este un dispozitiv Cams Biometrics sau un dispozitiv verificat pe portalul pentru dezvoltatori Cams?

Răspunsul la această întrebare determină complet modul dvs. Push. Dacă răspunsul este da, utilizați Native Push și nu mai este necesară nicio decizie suplimentară. Dacă răspunsul este nu, vă aflați în zona Hybrid Push și urmează o serie de decizii suplimentare.

Mod 1
Native Push
Pentru toate mașinile Cams Biometrics și pentru orice dispozitiv listat ca verificat pe developer.camsbiometrics.com. Dispozitivul comunică direct cu Biometric Gateway prin internet, fără a fi necesară nicio configurare suplimentară.

Toate cele 38 de operațiuni
Callback API complet
RESTful API complet

Mod 2
Hybrid Push
Pentru toate celelalte dispozitive neverificate. Selectați o metodă de comunicare și o topologie de implementare care se potrivesc mediului dvs. Disponibilitatea API-ului depinde de combinația aleasă.

3 metode de comunicare
2 opțiuni de topologie
Acces variabil la API

Native Push: imaginea completă

Dispozitivele Native Push beneficiază de acces complet la toate cele 38 de operațiuni ale Gateway, fără nicio configurare în afară de conectarea dispozitivului la internet. Callback API livrează evenimentele cu latență zero. Comenzile RESTful API se execută în aproximativ 15 secunde. Nu este necesar niciun SDK, software local sau o decizie privind topologia.

Înțelegerea Hybrid Push: trei metode de comunicare

Dacă dispozitivul dvs. nu este un dispozitiv Cams sau un dispozitiv verificat, următoarea decizie privește modul în care Gateway va comunica efectiv cu hardware-ul dvs. Există trei metode de comunicare disponibile, iar fiecare are cerințe diferite și implicații diferite asupra funcțiilor API pe care le puteți utiliza.

Metoda de comunicare nu ține de configurarea rețelei dvs. Ține de mecanismul tehnic prin care Gateway citește date de la dispozitivul dvs. specific și trimite comenzi către acesta. Această alegere este limitată de ceea ce acceptă hardware-ul dvs.

a
Device SDK
Cea mai bună opțiune pentru acces complet la API
Gateway comunică cu hardware-ul folosind SDK-ul producătorului dispozitivului. SDK-ul gestionează protocolul de nivel scăzut al dispozitivului, iar Gateway expune prin API-ul său toate funcțiile acceptate de SDK. Aceasta este singura metodă de comunicare din Hybrid Push care permite operațiuni RESTful API.
Callback API complet + RESTful API complet (în limitele capacităților SDK)
b
DB Pull
Doar date de prezență
Gateway citește dintr-o bază de date locală în care software-ul de management al dispozitivului scrie înregistrările de prezență. Gateway monitorizează această bază de date și trimite înregistrările noi către URL-ul dvs. de callback în timp real. Nu are loc nicio comunicare directă cu dispozitivul, ceea ce înseamnă că nu pot fi trimise comenzi către dispozitiv. Operațiunile precum adăugarea utilizatorilor, ștergerea înregistrărilor sau încărcarea jurnalelor nu sunt disponibile.
Callback API: doar înregistrări de prezență și jurnale de pontaj. RESTful API: nesuportat.
c
File Processing
Doar date de prezență
Un fișier de prezență desemnat de pe computerul local este supus unei monitorizări continue. De fiecare dată când software-ul dispozitivului actualizează acest fișier cu înregistrări noi de prezență, Gateway detectează modificarea, extrage înregistrările noi și le trimite către URL-ul dvs. de callback în timp real. Ca și DB Pull, această metodă este doar pentru citire din perspectiva dispozitivului și are aceleași limitări API.
Callback API: doar înregistrări de prezență și jurnale de pontaj. RESTful API: nesuportat.
Cum alegeți o metodă de comunicare

Dacă dispozitivul dvs. are un SDK al producătorului acceptat de Cams Gateway, alegeți Device SDK (a). Este singura metodă care deblochează operațiunile RESTful API pentru dispozitivele Hybrid Push. Dacă SDK-ul nu este acceptat sau nu este disponibil, DB Pull (b) sau File Processing (c) vor livra în continuare date de prezență către endpoint-ul dvs. de callback în timp real, ceea ce este suficient pentru multe cazuri de utilizare.

Înțelegerea Hybrid Push: două topologii de implementare

Odată ce ați ales o metodă de comunicare, a doua decizie este locul unde Gateway se conectează la dispozitivul, baza de date sau fișierul dvs. Aceasta este decizia privind topologia și depinde de mediul de rețea din locația fizică a dispozitivului.

Topologia X

Directă
Computerul de la fața locului unde este conectat dispozitivul, sau unde rulează software-ul de management al dispozitivului, are o adresă IP publică, cu redirecționare de porturi configurată către rețeaua locală. Biometric Gateway se conectează direct la dispozitiv, bază de date sau fișiere prin internet.
Necesită: IP public + redirecționare de porturi la fața locului
Topologia Y

Indirectă
O aplicație Hybrid Connector este instalată pe computerul local de la fața locului. Aceasta acționează ca o punte de ieșire între mașina locală și Biometric Gateway, stabilind conexiunea din interior, în loc să necesite o conexiune de intrare. Nu este necesară o adresă IP publică din partea clientului.
Necesită: Hybrid Connector instalat pe computerul local. Nu este necesar IP public.
Recomandare privind topologia

Dacă nu puteți configura o adresă IP publică sau redirecționarea de porturi la fața locului, alegeți topologia Indirectă (Y) cu Hybrid Connector. Este cea mai simplă cale de implementare și evită complet configurarea rețelei din partea clientului. Dacă o adresă IP publică este disponibilă și configurată, topologia Directă (X) funcționează și ea și nu necesită instalarea de software suplimentar la fața locului.

Arborele de decizie: ce mod ar trebui să alegeți?

Parcurgeți acest arbore de decizie de sus în jos. Opriți-vă la primul răspuns care se aplică situației dvs.

Arbore de decizie, începeți de sus
1. Dispozitivul dvs. este un dispozitiv Cams Biometrics sau este listat ca verificat pe developer.camsbiometrics.com?
Da Utilizați Native Push. Acces API complet. Nu sunt necesare alte decizii.
Nu Continuați cu întrebarea 2.
2. Cams Gateway acceptă SDK-ul pentru producătorul dispozitivului dvs.?
Da Utilizați Hybrid Push, Device SDK (a). Acces complet Callback și RESTful API, în limitele SDK. Continuați cu întrebarea 3 pentru topologie.
Nu Continuați cu întrebarea 2b.
2b. Software-ul de management al dispozitivului dvs. scrie înregistrările de prezență într-o bază de date locală?
Da Utilizați Hybrid Push, DB Pull (b). Doar Callback pentru prezență. Continuați cu întrebarea 3 pentru topologie.
3. Computerul de la fața locului are o adresă IP publică cu redirecționare de porturi disponibilă?
Da Utilizați Topologia Directă (X). Nu este necesar software suplimentar la fața locului.
Nu Utilizați Topologia Indirectă (Y). Instalați Hybrid Connector pe computerul local de la fața locului.

Matricea de disponibilitate a funcțiilor Hybrid Push

Tabelul de mai jos prezintă fiecare combinație de metodă de comunicare și topologie de implementare, precum și funcțiile API disponibile în fiecare caz. Utilizați-l împreună cu arborele de decizie pentru a confirma ce acceptă configurația aleasă.

Mod Comunicare Topologie Callback API RESTful API
Dispozitiv direct (a) Device SDK (X) IP public Complet Complet (se aplică limitele SDK)
Dispozitiv indirect (a) Device SDK (Y) Hybrid Connector Complet Complet (se aplică limitele SDK)
BD directă (b) DB Pull (X) IP public Doar prezență Nesuportat
BD indirectă (b) DB Pull (Y) Hybrid Connector Doar prezență Nesuportat
Fișier direct (c) File Processing (X) IP public Doar prezență Nesuportat
Fișier indirect (c) File Processing (Y) Hybrid Connector Doar prezență Nesuportat
Avertisment important privind hardware-ul

Limitările hardware pot restricționa și mai mult funcțiile API, chiar și în modul Device SDK. Anumite API-uri pot să nu funcționeze în funcție de versiunea de firmware a modelului dispozitivului sau de capacitățile expuse de SDK-ul producătorului. Matricea de mai sus descrie ce acceptă arhitectura Gateway, nu ce garantează fiecare model individual de dispozitiv că acceptă. Testați întotdeauna cu hardware-ul dvs. specific și verificați cazurile-limită cu echipa de suport Cams înainte de implementarea în producție.

Ce afectează și ce nu afectează decizia privind topologia

O confuzie frecventă este legată de relația dintre topologie și disponibilitatea API-ului. Alegerea topologiei, fie Directă, fie Indirectă, nu afectează funcțiile API disponibile. Setul de funcții API este determinat în întregime de metoda de comunicare.

Topologia afectează modul în care se stabilește conexiunea de rețea dintre Gateway și mediul dvs. local. Topologia directă necesită o adresă IP publică și redirecționare de porturi la fața locului. Topologia indirectă necesită instalarea Hybrid Connector pe computerul local. Funcțiile API disponibile pentru dvs. sunt identice pentru Direct Device SDK și Indirect Device SDK și identice pentru Direct DB Pull și Indirect DB Pull.

“Alegeți metoda de comunicare în funcție de funcțiile API de care are nevoie integrarea dvs. Alegeți topologia în funcție de ceea ce acceptă mediul dvs. de rețea. Acestea sunt decizii independente.”

Întrebări frecvente

Pot utiliza DB Pull sau File Processing împreună cu comenzile RESTful API?
Nu. DB Pull și File Processing sunt metode de integrare doar pentru citire. Ele permit Gateway să observe datele de prezență generate de software-ul propriu al dispozitivului, dar nu stabilesc un canal prin care comenzile pot fi trimise înapoi către dispozitiv. Operațiunile RESTful API, precum adăugarea utilizatorilor, ștergerea înregistrărilor sau încărcarea jurnalelor, necesită modul Device SDK, care creează un canal de comunicare bidirecțional.
Hybrid Connector trebuie instalat pe aceeași mașină cu software-ul dispozitivului?
Da. Hybrid Connector trebuie instalat pe același computer local unde este conectat dispozitivul sau unde rulează software-ul de management al dispozitivului. Acest lucru se datorează faptului că are nevoie de acces local la dispozitiv, la baza de date locală sau la fișierul de prezență, în funcție de metoda de comunicare utilizată. Connector-ul creează apoi un tunel de ieșire către Gateway, eliminând necesitatea unei adrese IP publice la acea locație.
Care este diferența de latență între Native Push și Hybrid Push?
Pentru Native Push, evenimentele Callback API sunt livrate cu latență zero, iar comenzile RESTful API se execută în aproximativ 30 de secunde. Pentru Hybrid Push folosind Device SDK, latența depinde de ciclul de comunicare al SDK-ului și variază în funcție de producătorul dispozitivului. Latența DB Pull și File Processing depinde de frecvența cu care software-ul local scrie înregistrări noi și de cât de repede detectează Gateway modificarea, de obicei în câteva secunde de la înregistrarea evenimentului de către dispozitiv.

Concluzie: potriviți modul cu constrângerile dvs.

Decizia privind modul de conectare la Cams Biometric Gateway nu este o chestiune de preferință. Este o chestiune de constrângeri. Native Push este răspunsul corect dacă dispozitivul dvs. se califică, deoarece oferă cele mai multe capacități cu cea mai puțină configurare. Hybrid Push este răspunsul pentru toate celelalte cazuri, iar în cadrul acestuia, modul Device SDK vă oferă cel mai apropiat echivalent al Native Push din punct de vedere al accesului API.

Când accesul complet la SDK nu este disponibil, DB Pull și File Processing sunt căi pragmatice care livrează totuși date de prezență în timp real către sistemele dvs. Decizia privind topologia este atunci o alegere separată, la nivel de infrastructură, care nu schimbă ceea ce poate face API-ul.

Începeți cu arborele de decizie, confirmați alegerea în matricea de funcții, testați cu hardware-ul dvs. și verificați orice cazuri-limită cu echipa de suport Cams înainte de trecerea în producție.

Was this article helpful?