Roger Access Control System Aplikacja Roger Mobile Key Wersja oprogramowania : 1.0.14.xx Wersja dokumentu: Rev. B
Spis treści Spis treści... 2 1. Wstęp... 3 1.1 Przeznaczenie i główne cechy aplikacji... 3 1.2 Wymagania systemowe... 3 2. Generowanie Klucza RMK... 3 2.1 Utworzenie klucza RMK... 3 2.2 Przeniesienie Klucza RMK do telefonu... 7 2.2.1 Przeniesienie klucza poprzez kod QR... 7 2.2.3 Przeniesienie klucza poprzez kod QR zapisany do pliku... 9 2.2.4 Przeniesienie klucza poprzez plik... 9 2.2.5 Opcje menu...10 3. Praca z aplikacją Roger Mobile Key... 11 3.1 Logowanie na rejestratorze...11 3.1.1 Ekran startowy...11 3.1.2 Logowanie przy pomocy NFC...12 3.1.3 Logowanie przy pomocy kodu QR...13 3.1.4 Logowanie przy pomocy klucza BT...14 Strona 2 z 14
1. WSTĘP 1.1 Przeznaczenie i główne cechy aplikacji Roger Mobile Key, to aplikacja mobilna służąca jako zasobnik do przechowywania kluczy. Każda z wirtualnych kart-kluczy pełni funkcjonalną rolę tradycyjnych kart RFID oraz Mifare. Oprogramowanie umożliwia wykorzystanie urządzenia mobilnego do zarejestrowania się na terminalach EGTP-1 wykorzystywanych do rejestracji czasu pracy firmy Roger. Dzięki swojej formie, aplikacja może przechowywać w pamięci telefonu wiele różnych kart-kluczy. Klucze można powielać i przechowywać na kilku telefonach równocześnie (np. prywatnym i firmowym) lub dla większego bezpieczeństwa powiązać kartę-klucz z konkretnym urządzeniem o określonym numerze ID (SIM, Android ID, IMEI). Każda z kart-kluczy ma przypisany KANAŁ TRANSMISJI. Oznacza to, że pozwala ona na logowanie się w jeden określony sposób. KANAŁAMI TRANSMISJI mogą być: PCE, BT, kod QR. Ponieważ kod QR posiada formę obrazka, a logowanie polega na pokazaniu kodu w kamerze, istnieje możliwość przeniesienia kodu QR na dowolny nośnik. Można go np. wydrukować na identyfikatorze lub nawet na zwykłej kartce. 1.2 Wymagania systemowe Aplikacja Roger Mobile Key do poprawnego działania wymaga urządzenia mobilnego z zainstalowanym systemem operacyjnym Android w wersji 2.3.3. lub nowszej. Sugerowana wersja systemu, to 4.4 lub nowsza. Poprzez urządzenie mobilne rozumiany jest tablet, telefon lub smartfon wyposażony w system Android w wersji opisanej powyżej. Rejestracja poprzez PCE jest możliwa tylko na telefonach lub tabletach, które posiadają wbudowany moduł NFC z minimum Android 4.4. Kanał BT wymaga modułu Bluetooth w telefonie. Roger Mobile Key nie jest aplikacją samodzielną. Skonfigurowanie jej go do poprawnej pracy wymaga zainstalowanego programu do rejestracji czasu pracy RCP Master w wersji 2.1 lub nowszej. Uwaga: Do poprawnej pracy z minimalną funkcjonalnością aplikacja Roger Mobile Key wymaga telefonu z systemem Android 2.3.3 lub nowszym. Sugerowana wersja systemu, to 4.4 lub nowsza. 2. GENEROWANIE KLUCZA RMK 2.1 Utworzenie klucza RMK Wygenerowanie klucza RMK jest możliwe wyłącznie w programie RCP Master 2.1 lub późniejszym. Pierwszym krokiem jest utworzenie pracownika oraz przypisanie mu numeru karty. Całą procedurę opisuje dokument Instrukcja Obsługi RCP Master 2.1, pkt. 4.1.2.5. Na otwartej karcie pracownika należy wybrać kartę, którą chce się przenieść do telefonu. Zazwyczaj w tym polu znajdują się numery istniejących kart RFID/Mifare, jednak zamiast realnego numeru można użyć dowolnego unikalnego ciągu cyfr np. RCP ID danego pracownika. Po zaznaczeniu karty wybieramy opcję UTWÓRZ KLUCZ RMK. Strona 3 z 14
Rysunek 1. Tworzenie klucza RMK W nowo otwartym oknie widzimy numer karty, na bazie którego tworzymy RMK oraz nazwę klucza, którą domyślnie jest imię i nazwisko pracownika. Strona 4 z 14
Rysunek 2. Ekran konfiguracji klucza RMK W zależności od wybranej opcji wyświetlają się odpowiednie pola formularza, których wypełnienie jest konieczne do konfiguracji klucza. NUMER KARTY pole wypełniane automatycznie numerem karty przypisanej użytkownikowi NAZWA KLUCZA edytowalne pole, domyślnie wypełniane imieniem i nazwiskiem, ta nazwa jest wyświetlana w Roger Mobile Key, TYP IDENTYFIKATORA służy przypisaniu klucza do określonego urządzenia. Wybrany w tym polu typ identyfikator jest zapisywany w kluczu i próba uruchomienia klucza na innym urządzeniu mobilnym sprawi, że jego użycie nie będzie możliwe. Typy identyfikatorów, jednoznacznie wskazujące docelowy egzemplarz urządzenia mobilnego, mogą być następujące: ANDROIDID - unikalny numer urządzenia nadawany przez systemem Android (zalecany) IMEI numer IMEI urządzenia mobilnego SIM numer karty SIM Ustawienie pola TYP IDENTYFIKATORA na wartość None umożliwia zainstalowanie klucza RMK na dowolnym urządzeniu i na dowolnej ilości urządzeń równocześnie. IDENTYFIKATOR konkretna wartość alfanumeryczna, która jest unikatowa dla każdego urządzenia mobilnego. Wartość każdego identyfikatora jest do sprawdzenia korzystając z opcji O urządzeniu w Roger Mobile Key na urządzeniu mobilnym Strona 5 z 14
KOMENTARZ pozwala na dołączenie krótkiej notatki, widocznej dla użytkownika w aplikacji Mobile Key pod ikonką. KANAŁ TRANSMISJI określa metodę, jaką będziemy się logować na rejestratorze, innymi słowy w jaki sposób będzie przekazywane żądanie rejestracji z telefonu do urządzenia: PCE urządzenie mobilne działa jak karta zbliżeniowa, należy go przyłożyć do rejestratora w odpowiednim miejscu (np. tam, gdzie znajduje się ikona ręki trzymającej kartę). Uwaga: Opcję komunikacji poprzez PCE realizują tylko te modele urządzeń mobilnych, które mają wbudowany moduł NFC oraz system Android w wersji 4.4 lub wyższej. QR na ekranie urządzenia mobilnego wyświetla się kod QR, który należy pokazać do kamery rejestratora. BT urządzeni mobilne łączy się bezprzewodowo, poprzez Bluetooth z rejestratorem, zasięg działania do 10m. Uwaga: Opcję komunikacji poprzez BT realizują tylko te modele urządzeń mobilnych, które mają wbudowany moduł Bluetooth. ADRES MAC wymagany w przypadku wybrania kanału BT. Należy podać adres MAC bluetooth rejestratora RCP Point, na którym będzie wykonywane logowanie. Wartość adresu MAC możemy sprawdzić w RCP Point wybierając MenuàAdres MAC bluetooth. TRYB RCP określa predefiniowany tryb RCP terminala, na którym nastąpi logowanie w przypadku braku wyboru, logowanie następuje w trybie aktualnie wybranym na rejestratorze. WYGENEROWANY PIN domyślna wartość to 1234. Po kliknięciu na przycisk Generuj PIN w polu PINu pojawia się losowa wartość, która będzie przypisana do klucza. Jest to pole edytowane, także można wpisać własną wartość. GENERUJ KLUCZ - po wypełnieniu wymaganych pól formularza aplikacja szyfruje wpisane przez użytkownika ustawienia konfiguracyjne i przekształca je do postaci ciągu alfanumerycznego, czyli klucza RMK. Klucz wyświetlany jest na ekranie w postaci kodu QR. Do wygenerowanego klucza przypisany jest wcześniej wygenerowany numer PIN, uniemożliwiający użycie klucza niepowołanej osobie. ZAPISZ KLUCZ JAKO PLIK RMK opcja zapisu wygenerowanego klucza w postaci pliku z rozszerzeniem *.rmk, ZAPISZ KLUCZ JAKO KOD QR opcja zapisu wygenerowanego kodu QR w postaci zdjęcia z rozszerzeniem *.jpg, Strona 6 z 14
Rysunek 3. Ekran zawierający wygenerowany klucz RMK 2.2 Przeniesienie Klucza RMK do telefonu 2.2.1 Przeniesienie klucza poprzez kod QR Najprostszym sposobem przeniesienia klucza RMK do telefonu jest odczytanie kodu QR przez aplikację Roger Mobile Key. Po uruchomieniu Roger Mobile Key na ekranie powitalnym należy wybrać DODAJ KLUCZ Z KODU QR. Opcjonalnie należy wejść do menu programu i wybrać pozycję DODAJ KLUCZ Z KODU QR. Uwaga: W zależności od posiadanego modelu telefonu i położenia przycisku Menu, dostęp do dodatkowych opcji aplikacji może wyglądać inaczej. Strona 7 z 14
Rysunek 4. Ekran powitalny Rysunek 5. Menu aplikacji Roger Mobile Key Na ekranie telefonu pojawi się obraz z tylnej kamery. Należy skierować widok na kod QR (np. w aplikacji RCP Master 2.1) tak, jakbyśmy chcieli zrobić mu zdjęcie, następnie chwilę poczekać. Telefon automatycznie wykryje kod na ekranie i go odczyta. Rysunek 6. Prośba o wprowadzenie PIN-u Rysunek 7. Prośba o zapamiętanie PIN-u Przed dodaniem klucza do pamięci telefonu, program uwierzytelnia użytkownika prosząc go o wpisanie PIN-u. PIN klucza możemy zapisać w pamięci urządzenia mobilnego. Jeśli nie zapamiętamy PIN-u program będzie nas prosił o jego podanie przy każdej próbie użycia klucza. Strona 8 z 14
Uwaga: Jeśli chcesz zwiększyć bezpieczeństwo i uniemożliwić użycie klucza osobie niepowołanej (np. złodziejowi urządzenia mobilnego), nie zapamiętuj kodu PIN w pamięci aplikacji. Aplikacja zapisuje klucz pod nazwą użytą w polu NAZWA KLUCZA. 2.2.3 Przeniesienie klucza poprzez kod QR zapisany do pliku Kod QR wyświetlony na ekranie można zapisać do pliku JPG wybierając opcję ZAPISZ KLUCZ JAKO KOD QR. Tak zapisany kod, razem z wygenerowanym przez program kodem PIN, można przesłać użytkownikowi mailem, wydrukować lub zapisać na dowolnym nośniku danych (np. pendrivie). Użytkownik może wyświetlić kod QR np. na komputerze i zaimportować klucz analogicznie, jak to zostało opisane w punkcie 2.2.1. Uwaga: Dla bezpieczeństwa zalecamy przekazywanie kodu QR i PIN-u osobno - różnymi kanałami (np. wydruk + mail). 2.2.4 Przeniesienie klucza poprzez plik Wygenerowany Klucz RMK można zapisać do pliku wybierając opcję ZAPISZ KLUCZ JAKO PLIK RMK. Plik należy przesłać do użytkownika razem z wygenerowanym przez program kodem PIN. Przesłany plik użytkownik powinien przenieść do pamięci telefonu (np. podłączając telefon do komputera kablem USB). Po uruchomieniu aplikacji Roger Mobile Key, w menu należy wybrać opcję DODAJ KLUCZ Z PLIKU (patrz Rysunek 4 lub Rysunek 5). Następnie należy wejść do katalogu w którym został zapisany plik RMK i wskazać go. Rysunek 8. Lista katalogów telefonu Przed dodaniem klucza do pamięci urządzenia mobilnego, program uwierzytelnia użytkownika prosząc go o wpisanie PIN-u. PIN klucza możemy zapisać w pamięci urządzenia mobilnego. Jeśli nie zapamiętamy PIN-u program będzie nas prosił o jego podanie przy każdej próbie użycia klucza. Strona 9 z 14
2.2.5 Opcje menu Po wybraniu przycisku Menu w urządzeniu pojawia się widok z Rysunku 9. Wybranie pozycji O urządzeniu powoduje wyświetlenie informacji o urządzeniu mobilnym tj. identyfikator AndroidID, IMEI i SIM. Wyświetlane są tylko te identyfikatory, które obsługuje dane urządzenie mobilne. Rysunek 9. Menu aplikacji Roger Mobile Key Rysunek 10. Identyfikatory urządzenia W przypadku kliknięcia i przytrzymania na danym kluczu pojawia się Menu kontekstowe dzięki któremu możemy usunąć dany klucz lub zmienić jego wyświetlaną nazwę. Rysunek 11. Menu kontekstowe klucza Rysunek 12. Zmiana nazwy klucza Strona 10 z 14
3. PRACA Z APLIKACJĄ ROGER MOBILE KEY 3.1 Logowanie na rejestratorze 3.1.1 Ekran startowy Po poprawnym skonfigurowaniu aplikacji Roger Mobile Key (pkt. 2.1, 2.2), na ekranie startowym zobaczymy listę zainstalowanych kluczy RMK. Rysunek 13. Ekran startowy lista kluczy RMK Rysunek 14. Informacja o kluczu Jeśli klucz posiada dodatkowy opis zdefiniowany w KOMENTARZ, to można go podejrzeć pod ikoną (Rys. 14). Po wybraniu klucza, którym chcemy dokonać logowania na rejestratorze, jeśli nie zapisaliśmy PIN-u w pamięci urządzenia mobilnego (Rys. 7), zostaniemy poproszeni o jego podanie. Rysunek 15. Prośba o podanie PIN-u Strona 11 z 14
3.1.2 Logowanie przy pomocy NFC Po wybraniu klucza, mającego zdefiniowane PCE, jako KANAŁ TRANSMISJI, na ekranie telefonu pojawia się zachęta do rejestracji (Rys. 16). Należy przyłożyć urządzenie mobilne do rejestratora w miejscu, gdzie znajduje się antena NFC. Na urządzeniach EGTP-1 firmy Roger, miejsce przyłożenia telefonu jest oznaczone symbolem: Odczyt kodu sygnalizowany jest przez RCP Point charakterystycznym sygnałem dźwiękowym oraz komunikatem. UŻYWAJ KLUCZA W TLE zaznaczenie tej opcji umożliwia załączenie pracy w tle, nawet po wyjściu z aplikacji. Ta opcja możliwa jest w danej chwili tylko dla jednego klucza. Dany klucz musi posiadać zapisany kod PIN w aplikacji. Rysunek 16. Klucz gotowy do użycia - NFC Strona 12 z 14
3.1.3 Logowanie przy pomocy kodu QR Po wybraniu klucza, mającego zdefiniowany kod QR, jako KANAŁ TRANSMISJI, na ekranie telefonu pojawia się zachęta do rejestracji oraz obraz kodu QR (Rys. 17). Należy pokazać kod QR do kamery rejestratora w taki sposób, żeby był on w całości widoczny w okienku rejestratora, na którym wyświetlany jest obraz z kamery. Odczyt kodu sygnalizowany jest przez RCP Point charakterystycznym sygnałem dźwiękowym oraz komunikatem. Rysunek 17. Klucz gotowy do użycia kod QR Strona 13 z 14
3.1.4 Logowanie przy pomocy klucza BT Po wybraniu klucza, mającego zdefiniowany BT, jako KANAŁ TRANSMISJI, na ekranie telefonu pojawia się zachęta do rejestracji oraz przycisk Wykonaj (Rys. 18). Należy użyć przycisku wykonaj w odległości maksymalnie 10 metrów od rejestratora EGTP-1 aby poprawnie zarejestrować zdarzenie RCP. Odczyt kodu sygnalizowany jest przez RCP Point charakterystycznym sygnałem dźwiękowym oraz komunikatem. Dodatkowo w aplikacji RMK pojawia się informacja Wykonano poprawnie po prawidłowym zalogowaniu na rejestratorze EGTP-1. Rysunek 18. Klucz gotowy do użycia klucz BT Kontakt: Roger sp.j. 82-400 Sztum Gościszewo 59 Tel.: +48 55 272 0132 Faks: +48 55 272 0133 Pomoc tech.: +48 55 267 0126 Pomoc tech. (GSM): +48 664 294 087 E-mail: biuro@roger.pl Web: www.roger.pl Strona 14 z 14