Wdrażanie przez EMM

Czym jest EMM?

Platforma do zarządzania mobilnością w przedsiębiorstwie (EMM) pozwala działowi IT zarządzać grupą tabletów z Androidem z jednego miejsca. Popularne przykłady to Microsoft Intune, Jamf Pro, Esper, Scalefusion i Samsung Knox. Gdy zarejestrujesz aplikacje Jonot przez Managed Google Play, EMM może wysyłać do każdego urządzenia Managed Configurations. Te ustawienia klucz/wartość zaczynają obowiązywać przy starcie aplikacji oraz wtedy, gdy administrator je zmieni. Nie potrzebujesz nowego builda APK.

Rejestracja w Managed Google Play

Zanim wyślesz konfigurację, Twoje aplikacje Jonot muszą być dostępne w katalogu aplikacji Twojego EMM:

1. Postępuj zgodnie z przewodnikiem Google Import an app from Google Play, aby dodać Jonot Kiosk i Jonot Desk do swojego konta Managed Google Play.
2. W swoim EMM dodaj obie aplikacje do profilu urządzenia używanego dla tabletów kiosku i stanowiska.
3. EMM sam wykrywa schemat managed configuration każdej aplikacji (zdefiniowany w pliku app_restrictions.xml wewnątrz APK). Ręczny import schematu nie jest potrzebny.

Klucze konfiguracji

Obie aplikacje mają te same klucze, z wyjątkiem nadpisania adresu URL (kiosk używa kioskUrlOverride, stanowisko używa deskUrlOverride). Wszystkie klucze są opcjonalne i domyślnie puste, chyba że zaznaczono inaczej.

• pairingCode (ciąg znaków) — Paruje urządzenie automatycznie przy pierwszym uruchomieniu. Aplikacja wstrzykuje kod do SPA, dzięki czemu personel nie wpisuje 7-znakowego kodu parowania na urządzeniu. Wartość per urządzenie — ustaw inną dla każdego tabletu.
• managerPin (ciąg znaków) — Ustawia centralnie PIN awaryjnego wyjścia. Gdy jest ustawiony, aplikacja pomija okno konfiguracji PIN-u przy pierwszym uruchomieniu. Pozostaw puste, aby personel na miejscu ustawił PIN ręcznie. Wysłanie nowej wartości to również zalecany sposób na odzyskanie zapomnianego PIN-u bez dotykania urządzenia.
• allowEscapeHatch (bool, domyślnie true) — Ustaw na false, aby całkowicie wyłączyć gest 5 dotknięć w prawym górnym rogu. Przydatne w ruchliwych publicznych kioskach, w których nie chcesz żadnej drogi wyjścia.
• kioskUrlOverride / deskUrlOverride (ciąg znaków) — Zaawansowane, tylko dla środowiska testowego lub sieci LAN. Nadpisuje wbudowany adres URL SPA (https://kiosk.jonot.io lub https://desk.jonot.io). Pozostaw puste dla produkcji.
• apiOriginOverride (ciąg znaków) — Zaawansowane, tylko dla środowiska testowego lub sieci LAN. Nadpisuje wbudowane źródło API (https://api.jonot.io). Pozostaw puste dla produkcji.

Wdrażanie ustawień w Twoim EMM

Dokładny interfejs zależy od EMM, ale ogólne kroki są takie:

1. W konsoli EMM otwórz managed app configuration dla Jonot Kiosk lub Jonot Desk.
2. EMM renderuje schemat jako formularz. Wypełnij klucze, które chcesz ustawić; pozostaw resztę pustą, aby użyć wartości domyślnych.
3. Przypisz konfigurację do grupy urządzeń lub do pojedynczych urządzeń.
4. Wyślij konfigurację. Aplikacja otrzyma ją natychmiast, jeśli urządzenie jest online, albo przy kolejnym połączeniu.
5. Aplikacja odczytuje i stosuje nową konfigurację. Zmiany adresu URL i źródła przeładowują WebView. Resetuje to każdy trwający proces obsługi klienta.

Zalecane ustawienia dla każdego wdrożenia

• pairingCode: kod parowania tego urządzenia z panelu administracyjnego Jonot.
• managerPin: PIN zgodny z polityką Twojego działu IT (lub pozostaw puste, aby ustawić go na miejscu).
• allowEscapeHatch: true w większości wdrożeń; false tylko wtedy, gdy dostęp zarządczy na miejscu nigdy nie będzie potrzebny.

Nadpisania adresu URL

W standardowych wdrożeniach produkcyjnych klucze nadpisania adresu URL nie są potrzebne. Ustaw je tylko, jeśli:

• Testujesz w środowisku testowym.
• Masz lokalnie zainstalowanego hosta offline w sieci lokalnej.

Jeśli ustawisz nadpisanie adresu URL, upewnij się też, że konfiguracja builda ALLOW_CLEARTEXT urządzenia dopuszcza HTTP (dla adresów URL w sieci LAN). Wymaga to niestandardowego builda — build ze Sklepu Play zawsze ustawia cleartext domyślnie na false.

Szczegóły zachowania

• Automatyczne parowanie (pairingCode): Kod jest wstrzykiwany do SPA jako window.__JONOT_MANAGED_PAIRING_CODE po każdym załadowaniu strony. SPA odczytuje tę wartość przy starcie i kończy parowanie automatycznie. Wysłanie tego samego kodu na już sparowane urządzenie nie ma żadnego efektu. Wysłanie innego kodu na urządzenie sparowane wcześniej automatycznie uruchamia parowanie ponownie.
• PIN menedżera (managerPin): Zapisywany w zaszyfrowanych SharedPreferences urządzenia pod tym samym kluczem, którego używa konfiguracja PIN-u na urządzeniu. Zaczyna obowiązywać przy kolejnym dotknięciu awaryjnego wyjścia. Gdy jest ustawiony, PIN wysłany przez EMM ma pierwszeństwo i nadpisuje PIN ustawiony na urządzeniu przy każdym uruchomieniu aplikacji i każdej zmianie konfiguracji.
• Awaryjne wyjście (allowEscapeHatch): Działa natychmiast po zmianie konfiguracji — bez ponownego uruchamiania.
• Nadpisania adresu URL i źródła: Działają po zmianie konfiguracji. Aplikacja przeładowuje się na nowy adres URL — każdy trwający proces obsługi klienta zostaje zresetowany.