Wdrażanie przez EMM

Czym jest EMM?

Enterprise Mobility Manager (EMM) to platforma IT centralnie zarządzająca flotą tabletów z Androidem — Intune (Microsoft), Jamf Pro, Esper, Scalefusion i Samsung Knox to popularne opcje. Gdy Twoje aplikacje Jonot zostaną zarejestrowane w EMM przez Managed Google Play, EMM może wysyłać Managed Configurations do każdego urządzenia: ustawienia klucz/wartość, które aplikacja odczytuje przy starcie oraz zawsze, gdy administrator IT je zaktualizuje, bez potrzeby budowania nowego APK.

Rejestracja w Managed Google Play

Zanim będzie można wysłać 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/stanowiska.
3. EMM automatycznie 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 współdzielą 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) — Automatycznie paruje urządzenie przy pierwszym uruchomieniu. Aplikacja wstrzykuje kod do SPA, dzięki czemu personel nie musi wpisywać 7-znakowego kodu parowania na urządzeniu. Wartość per urządzenie — ustaw inną wartość dla każdego tabletu.
• managerPin (ciąg znaków) — Centralnie ustawia PIN awaryjnego wyjścia. Gdy jest ustawiony, dialog konfiguracji PIN-u przy pierwszym uruchomieniu na urządzeniu jest pomijany. Pozostaw puste, aby pozwolić personelowi 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 dla ruchliwych publicznych kiosków, gdzie nie chcesz żadnej drogi ucieczki.
• kioskUrlOverride / deskUrlOverride (ciąg znaków) — Zaawansowane, tylko dla staging/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 staging/LAN. Nadpisuje wbudowane źródło API (https://api.jonot.io). Pozostaw puste dla produkcji.

Wdrażanie ustawień w Twoim EMM

Dokładny interfejs różni się w zależności od EMM, ale ogólne kroki to:

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 swojej grupy urządzeń lub pojedynczych urządzeń.
4. Wyślij konfigurację. Aplikacja otrzyma ją natychmiast, jeśli urządzenie jest online, lub przy następnym połączeniu.
5. Aplikacja ponownie odczytuje konfigurację i ją stosuje. Zmiany adresu URL i źródła przeładowują WebView (efektywnie odtwarzają aplikację od nowa) — każdy trwający proces obsługi klienta zostanie zresetowany.

Zalecane ustawienia dla każdego wdrożenia

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

Nadpisania adresu URL

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

• Testujesz w środowisku staging.
• Masz lokalne wdrożenie hosta offline (apps/host) w lokalnej sieci LAN.

Jeśli ustawisz nadpisanie adresu URL, upewnij się również, że konfiguracja builda ALLOW_CLEARTEXT urządzenia dopuszcza HTTP (dla adresów URL w LAN). Wymaga to niestandardowego builda — build ze Sklepu Play zawsze domyślnie ustawia cleartext 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 automatycznie kończy parowanie. Wysłanie tego samego kodu do już sparowanego urządzenia nie ma żadnego efektu. Wysłanie innego kodu na urządzenie wcześniej sparowane automatycznie ponownie uruchamia parowanie.
• PIN menedżera (managerPin): Zapisywany w zaszyfrowanych SharedPreferences urządzenia pod tym samym kluczem, który wykorzystuje konfiguracja PIN-u na urządzeniu. Zaczyna obowiązywać przy następnym dotknięciu awaryjnego wyjścia. Gdy jest ustawiony, PIN wysłany przez EMM ma pierwszeństwo i nadpisuje ewentualny PIN ustawiony na urządzeniu przy każdym uruchomieniu aplikacji lub zmianie konfiguracji.
• Awaryjne wyjście (allowEscapeHatch): Stosowane natychmiast po zmianie konfiguracji — nie wymaga ponownego uruchomienia.
• Nadpisania adresu URL/źródła: Stosowane przy zmianie konfiguracji. Aplikacja przeładowuje się do nowego adresu URL — każdy trwający proces obsługi klienta zostanie zresetowany.