Hoe toegangsbeslissingen werken

Op deze pagina

Deze pagina legt het model achter elke ontgrendeling uit: wie door een deur mag, in welke volgorde de controles plaatsvinden en hoe Access Policies, machtigingen en veiligheidscontroles samenwerken. Lees dit eerst; alle andere pagina's bouwen voort op deze concepten.

De aanvullende routes voor toegang

Een gebruiker kan via elke route van beleid of machtiging door een deur worden toegelaten. Eén geslaagde route is voldoende; een route neemt nooit toegang weg die door een andere route wordt verleend.

Route	Wat het is	Waar je het configureert
Access Policies	Meerdere benoemde beleidsregels die alleen toestaan. Elk beleid definieert Who, Where en When.	Settings → Access Policies
Permanente machtigingen	Expliciete machtigingen voor één persoon: de hele faciliteit, geselecteerde deuren of geselecteerde Access Scopes, eventueel met eigen tijden.	Users → open een gebruiker → Access Control → Additional permanent access
Access Time Windows	Tijdelijke toegang die door een beheerder wordt beheerd, voor één persoon en geselecteerde doelen (faciliteit/deur/scope).	Users → open een gebruiker → Access Time Windows
Integration Access Time Windows	Alleen-lezen bronvensters voor een gesynchroniseerde persoon, gekoppeld via logische scopesleutels uit de bron.	Brongegevens plus koppelingen in Settings → Sync settings

Een beleid komt alleen overeen wanneer Who EN Where EN When overeenkomen. Beleidsregels worden met OF gecombineerd. Binnen Who zijn voorwaarden voor persoonstype/status en tags alternatieven; binnen When zijn vensters van het type Weekly en One-time alternatieven. Where kan alle deuren van de faciliteit, Access Scopes, afzonderlijke deuren en uitsluitingen bevatten.

Voorbeeld: een beleid "Active members" kan de scope Front entrances Anytime omvatten, terwijl een afzonderlijk beleid "Staff" alle deuren van de faciliteit omvat behalve de Plant room. Een schoonmaker die met geen van beide overeenkomt, kan nog steeds een permanente machtiging krijgen voor de scope Service entries.

Permanente machtigingen en vensters van beheerders of integraties blijven afzonderlijk en aanvullend. Wijzigingen in beleid en de automatische import nemen ze niet over en verwijderen ze niet.

Performance Hub-medewerkers die naar Users worden gesynchroniseerd, krijgen deurtoegang via het bewerkbare beleid Performance Hub staff, net als bij elk ander beleid. Zie Synchronisatie en integraties.

De volledige beslissingsvolgorde

Wanneer een gebruiker in de mobiele app op Unlock tikt, controleert de server het volgende, in deze volgorde. De eerste mislukte controle weigert de ontgrendeling en legt de reden vast in de Toegangslogboeken.

Is de toegang van de gebruiker ingeschakeld? De schakelaar Access enabled in de rij van de gebruiker in Users is een noodschakelaar voor beheerders. Verwijderde, uitgeschakelde of door synchronisatie geblokkeerde gebruikers kunnen niet ontgrendelen, ongeacht beleid of machtiging. (Bijvoorbeeld: access_disabled.)
Is de deur geblokkeerd of in onderhoud? Een expliciete blockAllAccess weigert elke route voor leden. De onderhoudsmodus Force closed houdt de deur vergrendeld en buiten gebruik voor leden; Force open houdt de deur ontgrendeld. Beheerders kunnen een deur op afstand ontgrendelen; elke ontgrendeling door een beheerder wordt in de Toegangslogboeken vastgelegd.
Slaagt een van de aanvullende routes voor toegang?
- Beleidsroute: elk ingeschakeld benoemd beleid waarvan Who, Where en When allemaal overeenkomen, verleent toegang.
- Route via permanente machtiging: een machtiging voor een faciliteit, deur of bovenliggende Access Scope verleent toegang wanneer de optionele tijden overeenkomen.
- Route via gebruikersvenster: een Access Time Window van een beheerder is actief en is gericht op deze deur, deze faciliteit of een bovenliggende Access Scope.
- Route via integratievenster: een actueel bronvenster is actief en de geconfigureerde koppeling scope_key is gericht op deze deur. Verouderde of niet-gekoppelde bronvensters falen veilig.
- Als geen enkele route slaagt → geweigerd (no_matching_policy_or_grant)
Geofence-controle (indien ingeschakeld). Op basis van de locatie die de telefoon meldt:
- Als de telefoon geen locatie kon doorgeven → geweigerd (location_unavailable)
- Als de GPS-meting minder nauwkeurig is dan de instelling Require GPS accuracy better than → geweigerd (gps_too_imprecise)
- Als de afstand van de gebruiker tot het middelpunt van de geofence groter is dan straal + GPS-nauwkeurigheid + nauwkeurigheidsbuffer → geweigerd (outside_geofence)
- De server is leidend: een vervalste locatie op de telefoon wordt aan de serverzijde alsnog geweigerd.
Is de deurcontroller online? Als de controller zich niet heeft gemeld (heartbeat in de afgelopen 5 minuten), kan de ontgrendeling niet worden afgeleverd (device_offline). Als de opdracht wordt verstuurd maar de controller deze niet bevestigt, wordt de gebeurtenis vastgelegd als Timed out.
Ontgrendelen. Het relais laat los gedurende de Hold time van de deur (1–30 seconden, standaard 10) en vergrendelt daarna automatisch opnieuw. De gebeurtenis wordt vastgelegd als Confirmed unlocked zodra de controller dit bevestigt.

Vensters van het type One-time en begrensde Weekly-vensters gebruiken grenzen in hele Unix-seconden en halfopen intervallen [from, to): het begin telt mee en het einde niet. Weekly-blokken gebruiken hun opgegeven IANA-tijdzone en de lokale regels voor kloktijd en zomertijd. Zie Schema's voor Access Policies.

Nieuwe clients ontvangen het detail outside_access_time_window plus gestructureerde informatie over de volgende beschikbaarheid voor een deur die alleen een toekomstig venster heeft. Tijdens de compatibele uitrol blijven oudere clients outside_access_hours als primaire reden ontvangen, zodat de deur veilig uitgeschakeld en zichtbaar blijft.

Bestaande configuratie

Bestaande toegangsconfiguratie wordt automatisch geïmporteerd in Access Policies. De import behoudt wie toegang had, de deuren of Access Scopes die diegene kon gebruiken en de geldende tijden als Who-, Where- en When-waarden in het beleid. Beheerders beheren het resulterende beleid rechtstreeks; er is geen uitrolmodus of handmatig conversieproces.

Het overnemen van de geofence blijft onafhankelijk van Access Policies. Overeenkomsten met beleid doorlopen nog steeds de effectieve geofence en alle andere veiligheids- en apparaatcontroles.

Aanmelden bij de mobiele app (eenmalige code via sms of e-mail) is alleen authenticatie: het bewijst wie de gebruiker is. Het verleent op zichzelf geen toegang tot deuren. Elke ontgrendeling wordt afzonderlijk geautoriseerd met de bovenstaande beslissingsvolgorde. Een gebruiker kan bij de app zijn aangemeld en toch "You don't have access to this door." zien.

Woordenlijst

Term	Definitie
Deurcontroller	Het hardwareapparaat dat aan een deur of poort is gekoppeld en het slotrelais aanstuurt. Verschijnt in deze module als "deur" en in Apparaatbeheer als apparaat.
Deur	Een deurcontroller die bij je faciliteit is geregistreerd, met een naam, locatielabel, pictogram en instellingen.
Gebruikersrij	Het record van een persoon bij deze faciliteit op het tabblad Users. Handmatig aangemaakt, via CSV-import of via synchronisatie. Bevat contactgegevens, type/status/tags, machtigingen en de app-status.
Bron	Waar een gebruikersrij vandaan komt: Manually added, External Integration, CCTV/Computer Vision of Performance Hub staff.
Access Policy	Een benoemd beleid dat alleen toestaat, met Who, Where en When. Alle drie moeten overeenkomen; beleidsregels worden met OF gecombineerd.
Voorwaarde voor persoonstype	Een Who-voorwaarde in een beleid met een persoonstype en optionele lidmaatschapsstatussen. Geen statussen betekent elke status.
Tag	Een label op een gebruiker. Gesynchroniseerde tags komen uit de integratie en worden bij elke synchronisatie overschreven; aangepaste tags zijn van de beheerder en worden nooit overschreven. Beide kunnen voldoen aan Who-voorwaarden in beleid.
Openingstijden / tijdsblok	Tijdvensters per weekdag (bijvoorbeeld ma 06:00–22:00) die beperken wanneer beleid of machtigingen toegang verlenen. Leeg = altijd toegestaan. Tijden gebruiken de tijdzone van de faciliteit.
Access Time Window	Een periode van het type Weekly of One-time die wordt gebruikt in een beleidsschema of in een afzonderlijke machtigingsroute van een beheerder of integratie.
Machtiging per gebruiker	Expliciete toegang voor één gebruiker: Facility-wide (elke deur), specifieke deuren of specifieke Access Scopes, eventueel met eigen openingstijden.
Toegangsbereik	Een benoemde bundel deuren (bijvoorbeeld "Main entrances", "Staff-only") die wordt gebruikt als doel van beleid of machtigingen en voor geofence-instellingen op scopeniveau. Intern ook wel een deurgroep genoemd.
Beleidsuitsluiting	Een deur of Access Scope die uit de Where-overeenkomst van één beleid is verwijderd. Het weigert geen andere beleids- of machtigingsroute.
Geofence	Een cirkel rond de faciliteit (middelpunt + straal). Wanneer dit is ingeschakeld, moeten gebruikers zich fysiek binnen de cirkel bevinden (rekening houdend met GPS-nauwkeurigheid en buffer) om te ontgrendelen.
Nauwkeurigheidsbuffer	Extra meters die bij de straal van de geofence worden opgeteld om normale GPS-ruis op te vangen. Standaard 25 m.
Onderhoudsmodus	Instelling per deur die een deur uit de normale werking haalt: Normal, Force open (ontgrendeld gehouden) of Force closed (vergrendeld en buiten gebruik gehouden voor leden).
Block all access	Een veiligheidsblokkering per deur die bij die deur voorgaat op beleid en machtigingen per gebruiker, zonder de onderhoudsmodus te gebruiken. Ontgrendelen door een beheerder blijft mogelijk.
Openhoudtijd	Hoe lang het relais na een ontgrendeling losgelaten blijft voordat het weer vergrendelt. Bereik 1–30 seconden, standaard 10.
Schema voor automatisch ontgrendelen	Een schema per deur dat de deur ontgrendeld houdt tijdens de bemande uren van de faciliteit of een aangepast schema. Onafhankelijk van Access Policies.
Lock now	Vergrendelt een deur die door het schema voor automatisch ontgrendelen wordt opengehouden, tot de volgende wijziging in het schema. Resume schedule maakt dit ongedaan.
Access enabled	De noodschakelaar per gebruiker. Uit = de gebruiker kan niets ontgrendelen.
Ontkoppeld	Een gesynchroniseerde gebruiker van wie de schakelaar Track source updates uit staat. Synchronisaties slaan de rij over, zodat wijzigingen door beheerders behouden blijven.
Uitnodiging	De e-mail die naar een gebruiker wordt gestuurd met links om de mobiele app te downloaden. Wordt per gebruiker bijgehouden (Not invited / Invited / Send failed).
Aanmelden met OTP	De wachtwoordloze aanmelding van de mobiele app: een eenmalige code die naar de telefoon of het e-mailadres van de gebruiker wordt gestuurd.
Beheerdersoverride / ontgrendeling door beheerder	Een ontgrendeling die door een beheerder vanuit Performance Hub wordt gestart (tabblad Doors → Open, of Unlock door in het deurpaneel). Elke ontgrendeling door een beheerder wordt in de Toegangslogboeken vastgelegd met het account van die beheerder.
App-vergrendeling	Door de faciliteit afgedwongen herverificatie op het apparaat (Face ID / Touch ID / Android-biometrie / toegangscode) voordat de app kan worden gebruikt.
App-bericht	Een aankondigingskaart op het dashboard van de app: voor de hele faciliteit, per gebruiker of automatisch ingesteld door een regel voor App Messaging.
Toegangsgebeurtenis	Eén record in de Toegangslogboeken: een ontgrendelpoging en het resultaat ervan.

Access Policies: Who, Where, When en automatische import
Schema's voor Access Policies: Anytime, Weekly en One-time
Access Scopes: herbruikbare bundels deuren
Geofencing: locatiecontroles
Users: machtigingen per gebruiker en de noodschakelaar
Referentie: elke weigeringsreden en standaardwaarde in één tabel
Deuren kunnen ook worden opgenomen in Duress-responsen. Zie Responsacties in Duress.