Casus: toegang voor één persoon per ruimte met Server Approval
De vereiste
Een klant met een beveiligde ruimte (bijv. een serverruimte, kluis of lab) had een eenvoudige maar strikte regel nodig die bij de deur wordt afgedwongen:
Er mag slechts één persoon tegelijk in de ruimte aanwezig zijn. De volgende persoon mag pas worden binnengelaten als de huidige bezetter is uitgecheckt.
Het Cams-apparaat zorgt voor de identiteitsverificatie, en Server Approval breidt dat uit doordat uw eigen software de logica “is er al iemand binnen?” kan toevoegen , en in realtime beslist of een geverifieerde gebruiker daadwerkelijk mag worden binnengelaten.
Waarom Server Approval geschikt is
Standaard (Server Approval uitgeschakeld) verleent het apparaat toegang zodra het de gebruiker lokaal heeft geverifieerd , uw software hoort het pas achteraf. Dat is prima voor eenvoudige logboeken, maar het kan toegang niet voorkomen.
Met Server Approval ingeschakeld pauzeert het apparaat na de lokale verificatie en wacht het tot uw software de punch bevestigt voordat de deur opengaat. Dankzij deze heen-en-terugcommunicatie kunt u bedrijfslogica , zoals “is er al iemand binnen?” , in de toegangsbeslissing zelf inbrengen, in plaats van die achteraf alleen vast te leggen.
Hoe de flow werkt
- Een gebruiker doet een punch op het apparaat.
- Het apparaat verifieert de gebruiker lokaal en stuurt vervolgens een JSON-verzoek naar uw geregistreerde callback-URL.
- Uw software controleert de eigen bezettingsstatus en antwoordt:
{"status": "done"}→ het apparaat accepteert de punch en opent de deur.{"status": "reject"}→ het apparaat weigert de toegang en houdt de deur gesloten.
- Bij het uitchecken werkt uw software de bezettingsstatus bij, zodat de volgende check-in correct wordt beoordeeld.
Een voorbeeld met twee gebruikers
Gebruiker X checkt in. Het apparaat verifieert X, roept terug, uw software constateert dat de ruimte leeg is en geeft done terug. X gaat naar binnen. Uw software markeert de ruimte als bezet.
Gebruiker Y probeert in te checken terwijl X nog binnen is. Het apparaat verifieert Y en roept terug , net als bij elke andere punch. Uw software ziet dat de ruimte nog bezet is en geeft reject terug. Het apparaat weigert Y en de deur blijft dicht. Y wordt pas binnengelaten als uw software anders aangeeft.
X checkt uit. Uw software registreert het uitchecken en wist de bezettingsvlag.
Y probeert het opnieuw. Dezelfde callback-flow, maar nu ziet uw software dat de ruimte vrij is en geeft done terug. Y gaat naar binnen.
De rol van het apparaat verandert nooit , het verifieert altijd de persoon en vraagt uw software wat er vervolgens moet gebeuren. Het enige dat verschilt tussen “reject” en “done” is wat uw software weet over wie er op dat moment binnen is.
Implementatieopmerkingen
- De bezettingscontrole is volledig uw eigen verantwoordelijkheid , het apparaat onthoudt niet wie er binnen is. Een eenvoudige vlag of record per ruimte volstaat voor een ruimte met één bezetter; bij meerdere ruimtes of meerdere toegestane personen is een kleine statustabel per ruimte/apparaat nodig.
- Zorg ervoor dat check-out-gebeurtenissen betrouwbaar worden vastgelegd, want een gemiste check-out vergrendelt de ruimte permanent, ook nadat de gebruiker is vertrokken.
- Test het callback-pad lokaal voordat u live gaat , zie onze aanvullende handleiding over het lokaal testen van Cams API-callbacks met tunneling-tools voor het opzetten van ngrok/Cloudflare Tunnel/localhost.run in uw ontwikkelomgeving.
Waar u rekening mee moet houden: connectiviteit en callback-antwoorden
Server Approval is afhankelijk van een live heen-en-terugcommunicatie tussen het apparaat en uw server, en ervan dat uw server altijd correct antwoordt. Met twee situaties is het verstandig rekening te houden:
Het apparaat is offline. Het kan de verificatiecallback niet in realtime verzenden, waardoor uw software nooit de kans krijgt om done of reject terug te geven. Het apparaat toont de melding “Disconnected” en weigert de punch zonder meer , het valt niet terug op uitsluitend lokale toegang.
Uw callback geeft iets anders terug dan {"status": "done"} of {"status": "reject"}. Een ongeldig of onverwacht antwoord blijft in de wachtrij hangen, en het apparaat pusht geen volgende punchgegevens naar uw callback totdat dit is opgelost , de deur blijft dus dicht, niet alleen voor die gebruiker maar voor iedereen daarna, totdat uw callback weer correct antwoordt.
Met andere woorden: de garantie dat er maar één persoon tegelijk binnen is, is slechts zo sterk als de netwerkverbinding van het apparaat en de betrouwbaarheid van uw callback-antwoorden. Houd bij productie-implementaties met beide rekening in uw opzet , bijv. bekabelde verbindingen in plaats van Wi-Fi of waarschuwingen bij langdurige offlineperiodes, en strikte validatie om te garanderen dat uw callback altijd een correct gevormd done/reject-antwoord teruggeeft, ook in foutpaden.
Resultaat
Met Server Approval ingeschakeld en een minimale bezettingsvlag in de software van de klant werd de eis van één persoon tegelijk volledig afgedwongen met bestaande apparaatmogelijkheden , zonder extra hardware en zonder aanpassingen aan het apparaat, behalve het omzetten van één configuratieoptie.