Jak podejmowane są decyzje o dostępie

Na tej stronie

Ta strona wyjaśnia model stojący za każdym otwarciem: kto może przejść przez drzwi, w jakiej kolejności wykonywane są kontrole oraz jak współdziałają Access Policies, uprawnienia i kontrole bezpieczeństwa. Przeczytaj ją najpierw — wszystkie pozostałe strony opierają się na tych pojęciach.

Sumujące się ścieżki zezwoleń

Użytkownik może uzyskać dostęp przez drzwi dzięki dowolnej ścieżce zasady lub uprawnienia. Wystarczy spełnienie jednej ścieżki; żadna ścieżka nie odbiera dostępu przyznanego przez inną.

Ścieżka	Czym jest	Gdzie się ją konfiguruje
Access Policies	Wiele nazwanych zasad, które tylko zezwalają. Każda zasada określa Who, Where i When.	Settings → Access Policies
Stałe uprawnienia	Jawne uprawnienia dla jednej osoby: w całym obiekcie, do wybranych drzwi lub wybranych Access Scopes, opcjonalnie z własnymi godzinami.	Users → otwórz użytkownika → Access Control → Additional permanent access
Access Time Windows	Tymczasowy dostęp nadawany przez administratora jednej osobie do wybranych celów (obiekt, drzwi, zakres).	Users → otwórz użytkownika → Access Time Windows
Access Time Windows z integracji	Okna tylko do odczytu pochodzące ze źródła dla synchronizowanej osoby, mapowane z logicznych kluczy zakresów źródła.	Dane źródłowe oraz mapowania w Settings → Sync settings

Zasada jest dopasowana tylko wtedy, gdy pasują jednocześnie Who ORAZ Where ORAZ When. Zasady łączą się alternatywą (LUB). W obrębie Who warunki typu osoby/statusu i tagi są alternatywami; w obrębie When alternatywami są okna Weekly i One-time. Where może obejmować wszystkie drzwi obiektu, Access Scopes, pojedyncze drzwi i wykluczenia.

Przykład: zasada „Active members” może obejmować zakres Front entrances w trybie Anytime, a osobna zasada „Staff” — wszystkie drzwi obiektu z wyjątkiem Plant room. Osoba sprzątająca, która nie pasuje do żadnej z nich, może nadal otrzymać stałe uprawnienie do zakresu Service entries.

Stałe uprawnienia oraz okna nadane przez administratora lub integrację pozostają osobne i sumują się. Edycje zasad i automatyczny import ich nie wchłaniają ani nie usuwają.

Personel Performance Hub zsynchronizowany do listy Users uzyskuje dostęp do drzwi przez edytowalną zasadę Performance Hub staff, tak jak przez każdą inną zasadę. Zobacz Synchronizacja i integracje.

Pełna sekwencja decyzji

Gdy użytkownik dotknie Unlock w aplikacji mobilnej, serwer sprawdza kolejno poniższe warunki. Pierwsza niezaliczona kontrola powoduje odmowę otwarcia, a powód jest zapisywany w Rejestrach dostępu.

Czy dostęp użytkownika jest włączony? Przełącznik Access enabled w wierszu użytkownika na liście Users to wyłącznik awaryjny administratora. Użytkownicy usunięci, wyłączeni lub zablokowani przez synchronizację nie mogą otwierać drzwi niezależnie od zasad i uprawnień. (Na przykład: access_disabled.)
Czy drzwi są zablokowane lub w trybie serwisowym? Jawna blokada blockAllAccess odrzuca każdą ścieżkę członka. Tryb serwisowy Force closed utrzymuje drzwi zablokowane i wyłączone z użytku dla członków; Force open utrzymuje drzwi otwarte. Administratorzy mogą zdalnie otworzyć drzwi; każde otwarcie przez administratora jest zapisywane w Rejestrach dostępu.
Czy spełniona jest którakolwiek z sumujących się ścieżek zezwoleń?
- Ścieżka zasad: dostęp przyznaje dowolna włączona nazwana zasada, której warunki Who, Where i When są spełnione.
- Ścieżka stałych uprawnień: uprawnienie do obiektu, drzwi lub obejmującego je Access Scope przyznaje dostęp, gdy pasują jego opcjonalne godziny.
- Ścieżka okien użytkownika: aktywne jest okno Access Time Window nadane przez administratora, którego celem są te drzwi, obiekt lub obejmujący je Access Scope.
- Ścieżka okien integracji: aktywne jest aktualne okno ze źródła, a jego skonfigurowane mapowanie scope_key wskazuje te drzwi. Nieaktualne lub niezmapowane okna ze źródła domyślnie blokują dostęp.
- Jeśli żadna nie jest spełniona → odmowa (no_matching_policy_or_grant)
Kontrola geofence (jeśli jest włączona). Na podstawie lokalizacji zgłoszonej przez telefon:
- Jeśli telefon nie mógł podać lokalizacji → odmowa (location_unavailable)
- Jeśli odczyt GPS jest mniej dokładny niż ustawienie Require GPS accuracy better than → odmowa (gps_too_imprecise)
- Jeśli odległość użytkownika od środka geofence przekracza promień + dokładność GPS + bufor dokładności → odmowa (outside_geofence)
- Rozstrzyga serwer — sfałszowana lokalizacja w telefonie i tak zostanie odrzucona po stronie serwera.
Czy kontroler drzwi jest online? Jeśli kontroler się nie zgłosił (sygnał aktywności w ciągu ostatnich 5 minut), polecenie otwarcia nie może zostać dostarczone (device_offline). Jeśli polecenie zostało wysłane, ale kontroler go nie potwierdził, zdarzenie jest zapisywane jako Timed out.
Otwarcie. Przekaźnik zwalnia zamek na Hold time drzwi (1–30 sekund, domyślnie 10), po czym drzwi automatycznie się blokują. Po potwierdzeniu przez kontroler zdarzenie jest zapisywane jako Confirmed unlocked.

Okna One-time i ograniczone okna Weekly używają granic w postaci liczb całkowitych sekund Unix oraz przedziałów prawostronnie otwartych [from, to): początek się kwalifikuje, a koniec nie. Bloki Weekly używają zadeklarowanej strefy czasowej IANA oraz lokalnych reguł czasu zegarowego i czasu letniego. Zobacz Harmonogramy Access Policies.

Nowe wersje aplikacji otrzymują szczegół outside_access_time_window oraz ustrukturyzowaną informację o następnej dostępności dla drzwi, które mają tylko przyszłe okna. W okresie przejściowym zapewniającym zgodność starsze wersje aplikacji nadal otrzymują outside_access_hours jako główny powód, dzięki czemu drzwi pozostają bezpiecznie niedostępne i widoczne.

Istniejąca konfiguracja

Istniejąca konfiguracja dostępu jest automatycznie importowana do Access Policies. Import zachowuje informacje o tym, kto miał dostęp, z których drzwi lub Access Scopes mógł korzystać i jakie godziny obowiązywały, jako wartości Who, Where i When zasad. Administratorzy zarządzają powstałymi zasadami bezpośrednio; nie ma trybu wdrażania ani procesu ręcznej konwersji.

Dziedziczenie geofence pozostaje niezależne od Access Policies. Dopasowania zasad nadal przechodzą przez efektywny geofence oraz wszystkie inne kontrole bezpieczeństwa i urządzenia.

Logowanie do aplikacji mobilnej (kodem jednorazowym przez SMS lub e-mail) służy wyłącznie do uwierzytelniania — potwierdza tożsamość użytkownika. Nie przyznaje samo w sobie dostępu do drzwi. Każde otwarcie jest autoryzowane osobno zgodnie z powyższą sekwencją decyzji. Użytkownik może być zalogowany do aplikacji i mimo to zobaczyć komunikat „You don't have access to this door.”

Słowniczek

Termin	Definicja
Kontroler drzwi	Urządzenie sprzętowe sparowane z drzwiami lub bramą, które uruchamia przekaźnik zamka. W tym module jest widoczne jako „drzwi”, a w module Zarządzanie urządzeniami jako urządzenie.
Drzwi	Kontroler drzwi zarejestrowany w Twoim obiekcie, z nazwą, etykietą lokalizacji, ikoną i ustawieniami.
Wiersz użytkownika	Rekord osoby w tym obiekcie na karcie Users. Tworzony ręcznie, przez import CSV lub przez synchronizację. Zawiera identyfikatory kontaktowe, typ/status/tagi, uprawnienia i stan aplikacji.
Źródło	Pochodzenie wiersza użytkownika: Manually added, External Integration, CCTV/Computer Vision lub Performance Hub staff.
Access Policy	Nazwana zasada, która tylko zezwala, zawierająca Who, Where i When. Wszystkie trzy muszą pasować; zasady łączą się alternatywą (LUB).
Warunek typu osoby	Warunek Who zasady zawierający typ osoby i opcjonalne statusy członkostwa. Brak statusów oznacza dowolny status.
Tag	Etykieta przypisana do użytkownika. Tagi synchronizowane pochodzą z integracji i są nadpisywane przy każdej synchronizacji; tagi niestandardowe należą do administratora i nigdy nie są nadpisywane. Oba rodzaje mogą spełniać warunki Who zasad.
Godziny działania / blok czasu	Przedziały czasu w poszczególnych dniach tygodnia (np. pon. 06:00–22:00), które ograniczają, kiedy zasady lub uprawnienia zezwalają na dostęp. Puste = zawsze dozwolone. Godziny są podawane w strefie czasowej obiektu.
Access Time Window	Okres Weekly lub One-time używany w harmonogramie zasady lub w osobnej ścieżce uprawnień nadanych przez administratora lub integrację.
Uprawnienie użytkownika	Jawny dostęp przyznany jednemu użytkownikowi: Facility-wide (wszystkie drzwi), wybrane drzwi lub wybrane Access Scopes — opcjonalnie z własnymi godzinami działania.
Zakres dostępu	Access Scope: nazwany zestaw drzwi (np. „Main entrances”, „Staff-only”) używany jako cel zasady lub uprawnienia oraz do ustawień geofence na poziomie zakresu. Wewnętrznie nazywany też grupą drzwi.
Wykluczenie z zasady	Drzwi lub Access Scope usunięte z dopasowania Where jednej zasady. Nie odbiera dostępu przyznanego przez inną zasadę ani ścieżkę uprawnień.
Geofence	Okrąg wokół obiektu (środek + promień). Gdy jest włączony, użytkownicy muszą fizycznie przebywać w jego obrębie (z uwzględnieniem dokładności GPS i bufora), aby otworzyć drzwi.
Bufor dokładności	Dodatkowe metry doliczane do promienia geofence w celu tolerowania normalnych wahań GPS. Domyślnie 25 m.
Tryb serwisowy	Ustawienie drzwi, które wyłącza je z normalnego działania: Normal, Force open (utrzymywane otwarte) lub Force closed (utrzymywane zablokowane i wyłączone z użytku dla członków).
Block all access	Blokada bezpieczeństwa dla drzwi, która ma pierwszeństwo przed zasadami i uprawnieniami użytkowników przy tych drzwiach, bez użycia trybu serwisowego. Otwarcie przez administratora pozostaje dostępne.
Czas otwarcia	Jak długo przekaźnik pozostaje zwolniony po otwarciu przed ponowną blokadą. Zakres 1–30 sekund, domyślnie 10.
Harmonogram automatycznego otwierania	Harmonogram drzwi, który utrzymuje je otwarte w godzinach obsady obiektu lub według niestandardowego harmonogramu. Niezależny od Access Policies.
Lock now	Blokuje drzwi utrzymywane otwarte przez harmonogram automatycznego otwierania do następnej zmiany w harmonogramie. Resume schedule cofa tę operację.
Access enabled	Wyłącznik awaryjny dla użytkownika. Wyłączony = użytkownik nie może niczego otworzyć.
Odłączony	Synchronizowany użytkownik z wyłączonym przełącznikiem Track source updates. Przebiegi synchronizacji pomijają ten wiersz, więc zmiany administratora są zachowywane.
Zaproszenie	E-mail wysyłany do użytkownika z linkami do pobrania aplikacji mobilnej. Śledzone dla każdego użytkownika (Not invited / Invited / Send failed).
Logowanie OTP	Logowanie do aplikacji mobilnej bez hasła: kod jednorazowy wysyłany na telefon lub adres e-mail użytkownika.
Nadpisanie przez administratora / otwarcie przez administratora	Otwarcie wywołane z Performance Hub przez administratora (karta Doors → Open lub Unlock door w panelu drzwi). Każde otwarcie przez administratora jest zapisywane w Rejestrach dostępu wraz z kontem administratora.
Blokada aplikacji	Wymuszane przez obiekt ponowne uwierzytelnienie na urządzeniu (Face ID / Touch ID / biometria Androida / kod) przed użyciem aplikacji.
Wiadomość w aplikacji	Karta z ogłoszeniem na panelu aplikacji — dla całego obiektu, dla użytkownika lub ustawiana automatycznie przez regułę App Messaging.
Zdarzenie dostępu	Pojedynczy wpis w Rejestrach dostępu: próba otwarcia i jej wynik.

Access Policies — Who, Where, When i automatyczny import
Harmonogramy Access Policies — Anytime, Weekly i One-time
Access Scopes — zestawy drzwi wielokrotnego użytku
Geofencing — kontrole lokalizacji
Użytkownicy — uprawnienia użytkowników i wyłącznik awaryjny
Informacje referencyjne — wszystkie powody odmowy i wartości domyślne w jednej tabeli
Drzwi mogą być również uwzględniane w reakcjach modułu Duress. Zobacz Akcje reakcji w module Duress.