Biometrische apparaten verbinden zonder publiek IP-adres: de Hybrid Connector uitgelegd
Veel integratieprojecten voor biometrie lopen vast op een vraag die niets met biometrie te maken heeft: hoe bereikt de cloud een apparaat dat achter een kantoorrouter staat? Veel locaties hebben geen publiek IP-adres, een IP-adres dat elke dag verandert, of een IT-team dat geen inkomende poorten in de firewall wil openen, en zij zijn terecht voorzichtig. Het traditionele antwoord, portforwarding, is lastig en stelt het lokale netwerk bloot. Cams Biometrics lost dit op met de Hybrid Connector, een klein stuk software dat uw locatie van binnenuit met de Gateway verbindt. Deze gids legt uit waarom zoveel apparaten moeilijk bereikbaar zijn, hoe de Hybrid Connector in eenvoudige bewoordingen werkt, wat u ermee kunt doen en hoe u hem instelt.
01 · Het netwerkprobleem
Waarom zoveel biometrische apparaten moeilijk bereikbaar zijn
Een biometrisch apparaat op een lokaal netwerk is als een huis aan een privéweg. Mensen binnen kunnen wegrijden wanneer ze willen, maar niemand van buitenaf kan binnenrijden tenzij iemand het hek opent. Om een cloudplatform rechtstreeks het apparaat te laten bereiken, heeft de locatie een publiek adres nodig en een bewuste opening in de firewall die naar het apparaat leidt. Veel locaties hebben dat simpelweg niet, om goede redenen.
| Situatie | Wat het betekent | Waarom directe toegang mislukt |
|---|---|---|
| Geen publiek IP | De internetprovider deelt één publiek adres onder veel klanten | Er is geen uniek adres dat naar uw locatie leidt |
| Wisselend IP-adres | Het publieke IP-adres van de locatie wijzigt regelmatig | Een adres dat vandaag werkt, kan morgen naar een andere plek verwijzen |
| Strikt firewallbeleid | IT staat geen inkomende verbindingen vanaf internet toe | De cloud kan geen verbinding met het apparaat starten |
| Portforwarding niet mogelijk | De router wordt beheerd door een verhuurder, internetprovider of het hoofdkantoor | Niemand op locatie kan het hek openen |
| Beveiligingszorgen | Open poorten stellen interne systemen bloot aan internet | Zelfs als het mogelijk is, zullen veel organisaties dit risico niet accepteren |
Winkelvestigingen, bouwplaatsen, magazijnen, scholen en kleine kantoren lopen allemaal tegen deze beperkingen aan. Geen van deze is een reden om cloudintegratie voor biometrie op te geven. Ze zijn een reden om anders te verbinden.
02 · Direct versus indirect
Twee manieren om een Hybrid Push-apparaat te verbinden
Cams-apparaten, en apparaten die zijn geverifieerd op developer.camsbiometrics.com, verbinden via Native Push met de Gateway en communiceren daarbij rechtstreeks via internet. Andere apparaten verbinden via Hybrid Push, en Hybrid Push kent twee implementatietopologieën. De juiste keuze hangt volledig af van het netwerk van uw locatie.
| Directe topologie | Indirecte topologie (Hybrid Connector) | |
|---|---|---|
| Hoe het verbindt | De Gateway verbindt via internet met het apparaat, de database of de bestanden | Een Hybrid Connector op een lokale computer maakt een verbinding naar buiten, naar de Gateway |
| Publiek IP nodig | Ja, op de computer van de locatie | Nee |
| Portforwarding nodig | Ja | Nee |
| Software op locatie | Geen | De Hybrid Connector, op een lokale computer |
| Het meest geschikt voor | Locaties met een publiek IP en IT-teams die portforwarding beheersen | Locaties achter routers, strikte firewalls of zonder publiek IP |
|
De eenvoudigste keuze voor de meeste locaties Als u geen publiek IP en portforwarding kunt instellen, kies dan de indirecte topologie met de Hybrid Connector. Hiervoor is helemaal geen netwerkconfiguratie aan de kant van de klant nodig, waardoor dit meestal de eenvoudigste weg naar implementatie is. |
03 · Van binnen naar buiten, niet van buiten naar binnen
Hoe de Hybrid Connector werkt
De Hybrid Connector keert het netwerkprobleem om. In plaats van dat de cloud probeert uw locatie binnen te komen, neemt iets binnen uw locatie zelf contact op met de cloud. Terug naar het huis aan de privéweg: in plaats van iemand te vragen het hek te openen, rijdt een bewoner weg en houdt hij een communicatielijn open van de buitenwereld terug naar het huis.
Zonder de Hybrid Connector
|
Cams Gateway Probeert het apparaat vanaf internet te bereiken |
→ |
Router of firewall van de locatie Blokkeert de inkomende verbinding |
→ |
Apparaat Ontvangt het verzoek nooit |
Met de Hybrid Connector
|
Apparaat, database of bestand Blijft op het lokale netwerk |
→ |
Hybrid Connector Draait op een lokale computer en communiceert lokaal met het apparaat |
→ |
Uitgaande verbinding De Connector maakt verbinding met de Gateway |
→ |
Cams Gateway Wisselt gegevens uit met uw ERP/HRMS via die verbinding |
Omdat de verbinding begint binnen uw netwerk, werkt deze op dezelfde manier als een webbrowser op die computer. De locatie heeft geen publiek IP nodig en de firewall hoeft geen enkele nieuwe inkomende verbinding toe te staan. De Hybrid Connector fungeert als brug tussen het lokale apparaat, de database of de bestanden aan de ene kant en de biometrische Gateway aan de andere kant.
|
Portforwarding opent een deur in uw netwerk. De Hybrid Connector houdt de deur gesloten en belt vanuit de binnenkant. |
|
Controleer welke poorten u moet toestaan Uitgaande verbindingen moeten nog steeds door uw firewall worden toegestaan. De meeste netwerken staan al gangbaar uitgaand webverkeer toe, maar strikte netwerken kunnen dit beperken. Bekijk de sectie Ondersteunde poorten in de documentatie van de Cams Web API en deel deze met uw IT-team voordat u installeert. |
04 · Functies en beperkingen
Wat u via de Hybrid Connector kunt doen
De Hybrid Connector bepaalt hoe uw locatie verbindt. Hij bepaalt niet wat u kunt doen. Dat wordt bepaald door de communicatiemethode die wordt gebruikt om met het apparaat te praten, en er zijn er drie om uit te kiezen.
| Modus | Communicatiemethode | Callback API | RESTful API |
|---|---|---|---|
| Indirect apparaat | Device SDK | Volledig | Volledig, binnen de grenzen van de SDK |
| Indirecte DB | DB Pull uit de lokale database van de apparaatsoftware | Alleen aanwezigheid | Niet ondersteund |
| Indirect bestand | File Processing van het aanwezigheidsbestand van de apparaatsoftware | Alleen aanwezigheid | Niet ondersteund |
| Communicatiemethode | Hoe het werkt |
|---|---|
| Device SDK | De Gateway communiceert met de hardware via de SDK van de fabrikant, zodat elke functie die de SDK ondersteunt beschikbaar is via de API. Dit is de beste optie voor volledige API-toegang |
| DB Pull | De Gateway leest nieuwe aanwezigheidsregistraties uit de lokale database waarin de apparaatsoftware ze opslaat, en stuurt ze door naar uw Callback URL |
| File Processing | Een aangewezen aanwezigheidsbestand op de lokale computer wordt continu gecontroleerd. Telkens wanneer de apparaatsoftware het bijwerkt, worden nieuwe registraties gedetecteerd en in realtime naar uw Callback URL gestuurd |
|
Topologie en functies zijn afzonderlijke keuzes De directe en indirecte topologieën bieden exact dezelfde functies voor dezelfde communicatiemethode. Kies uw communicatiemethode op basis van de API-functies die u nodig heeft, en kies uw topologie op basis van wat uw netwerk toestaat. |
Zelfs in de Device SDK-modus kunnen de firmware of SDK van een specifiek apparaatmodel sommige bewerkingen beperken. Test altijd met uw eigen hardware en bespreek randgevallen met het Cams-team.
05 · Stap voor stap
De Hybrid Connector instellen
De exacte schermen hangen af van uw Cams-account, maar elke installatie van de Hybrid Connector volgt hetzelfde pad.
|
Kies de juiste lokale computer Kies een computer op hetzelfde lokale netwerk als het apparaat. Voor DB Pull of File Processing moet dit de computer zijn waarop de apparaatsoftware de database of het aanwezigheidsbestand opslaat, omdat de Connector lokale toegang tot deze nodig heeft. |
|
|
Bevestig uitgaande toegang Deel de gegevens over ondersteunde poorten uit de Cams-documentatie met uw IT-team, en bevestig dat de computer de vereiste uitgaande verbindingen kan maken. |
|
|
Installeer de Hybrid Connector Installeer de Connector op die computer en koppel deze aan uw Cams-account, volgens de installatie-instructies voor uw account. |
|
|
Selecteer de communicatiemethode Kies Device SDK als de Gateway de SDK van uw apparaat ondersteunt. Kies anders DB Pull of File Processing voor aanwezigheidsgegevens. |
|
|
Stel uw Callback URL in Configureer het HTTPS-adres van uw ontvanger, HRMS, ERP of automatiseringstool als Callback URL, zodat aanwezigheidsgebeurtenissen een bestemming hebben. |
|
|
Test van begin tot eind Scan een vingerafdruk of gezicht bij het apparaat en controleer of de gebeurtenis uw Callback URL bereikt. Probeer in de Device SDK-modus ook een RESTful-bewerking, zoals het toevoegen van een testgebruiker. |
Heeft u een ontvanger nodig om gebeurtenissen naartoe te sturen? De Cams AI Code Generator Prompts kunnen een volledige callback-ontvanger genereren in Python, Node.js, PHP en verschillende andere talen.
06 · Best practices
De verbinding gezond houden
Eenmaal geïnstalleerd wordt de Hybrid Connector onderdeel van de infrastructuur van uw locatie. Een paar eenvoudige gewoonten houden hem betrouwbaar.
| Praktijk | Waarom het belangrijk is |
|---|---|
| Gebruik een computer die altijd aanstaat | Als de computer in de slaapstand gaat of wordt uitgeschakeld, wordt de verbinding tussen de locatie en de Gateway onderbroken |
| Schakel slaapstand en hibernatie uit | Energiebesparende instellingen zijn de meest voorkomende oorzaak van stille verbreking |
| Start de Connector automatisch | Na een herstart of stroomstoring moet de verbinding terugkomen zonder dat iemand inlogt |
| Bescherm tegen stroomstoringen | Een kleine UPS houdt de computer en het netwerk tijdens korte storingen in bedrijf |
| Houd de computer up-to-date en veilig | De computer staat op uw netwerk, dus behandel hem als elk ander beheerd apparaat |
| Let op hiaten in gebeurtenissen | Als een drukke locatie plotseling geen gebeurtenissen meer stuurt, controleer dan eerst de computer en de verbinding ervan |
|
Wat er gebeurt wanneer de verbinding wegvalt Aanwezigheid wordt op het apparaat geregistreerd, en de offline cache en wachtrij van de Gateway zijn ontworpen om onderbrekingen op te vangen. Wanneer de verbinding terugkeert, worden registraties afgeleverd met hun oorspronkelijke tijdstempels, zodat scans die tijdens een storing zijn gedaan nog steeds op het juiste tijdstip verschijnen. Bij DB Pull en File Processing blijven registraties in de database of het bestand van de apparaatsoftware staan totdat de Connector ze leest. |
Veelgestelde vragen
|
Hebben Cams-apparaten de Hybrid Connector nodig? Nee. Cams-apparaten en apparaten die zijn geverifieerd op developer.camsbiometrics.com verbinden via Native Push en communiceren rechtstreeks met de Gateway via internet. De Hybrid Connector wordt gebruikt voor Hybrid Push-apparaten. |
|
Is de Hybrid Connector veiliger dan portforwarding? Hij voorkomt dat inkomende poorten naar uw lokale netwerk worden geopend, wat een veelvoorkomende bron van risico wegneemt. Communicatie verloopt via HTTP/HTTPS met validatie van auth-tokens, en optionele AES-256-versleuteling is beschikbaar. |
|
Het IP-adres van onze locatie verandert elke dag. Levert dat problemen op? Niet met de indirecte topologie. Omdat de Hybrid Connector naar buiten verbindt met de Gateway, heeft uw locatie geen vast of publiek IP-adres nodig. |
|
Kan ik via de Hybrid Connector nog steeds gebruikers toevoegen en verwijderen? Ja, in de Device SDK-modus, binnen de grenzen van de SDK van het apparaat. DB Pull en File Processing ondersteunen alleen aanwezigheidscallbacks, zonder RESTful-bewerkingen. |
|
Werkt de Hybrid Connector met mijn HRMS of ERP? Ja. De Connector verzorgt de verbinding tussen uw locatie en de Gateway. Uw HRMS, ERP of automatiseringstool ontvangt gebeurtenissen via de Callback API op precies dezelfde manier als bij elke andere verbindingsmodus. |
Conclusie: het netwerk mag uw integratie niet bepalen
Jarenlang bepaalde het netwerk op de locatie van het apparaat stilletjes welke biometrische integraties mogelijk waren. Zonder publiek IP was er geen cloudverbinding. Een strikte firewall betekende een lange onderhandeling met IT. Een wisselend IP-adres betekende integraties die zonder waarschuwing braken.
De Hybrid Connector neemt die beperking weg. Door van binnenuit te verbinden, laat hij apparaten achter gewone kantoorrouters, strikte firewalls en gedeelde internetverbindingen deelnemen aan dezelfde realtime integraties als elk ander apparaat, zonder één enkele inkomende poort te openen.
De Cams Biometrics Gateway brengt apparaten online, waar ze ook staan. Native Push verbindt Cams-apparaten en geverifieerde apparaten rechtstreeks. Hybrid Push verbindt andere merken via Device SDK, DB Pull of File Processing, met een directe topologie of de Hybrid Connector wanneer geen publiek IP beschikbaar is. Elke gebeurtenis bereikt uw systemen via dezelfde Callback API, met validatie van auth-tokens en optionele AES-256-versleuteling. Ontdek het platform op CamsBiometrics.com, lees de volledige documentatie, inclusief verbindingsmodi en ondersteunde poorten, op developer.camsbiometrics.com, en genereer uw ontvanger met de AI Code Generator Prompts.