Distribuere via EMM

Hva er en EMM?

En Enterprise Mobility Manager (EMM) er en IT-plattform som administrerer en flåte av Android-nettbrett sentralt — Intune (Microsoft), Jamf Pro, Esper, Scalefusion og Samsung Knox er vanlige valg. Så snart Jonot-appene dine er registrert i EMM-en via Managed Google Play, kan EMM-en sende Managed Configurations til hver enhet: nøkkel/verdi-innstillinger appen leser ved oppstart, og hver gang IT-administratoren oppdaterer dem, uten å kreve en ny APK-bygging.

Registrere i Managed Google Play

Før du kan sende konfigurasjon, må Jonot-appene dine være tilgjengelige i EMM-ens appkatalog:

1. Følg Googles veiledning Import an app from Google Play for å legge til Jonot Kiosk og Jonot Desk i Managed Google Play-kontoen din.
2. I EMM-en legger du til begge appene i enhetsprofilen du bruker for kiosk-/skranke-nettbrett.
3. EMM-en oppdager automatisk hver apps skjema for administrert konfigurasjon (definert i app_restrictions.xml inne i APK-en). Ingen manuell skjemaimport kreves.

Konfigurasjonsnøkler

Begge appene deler de samme nøklene, unntatt URL-overstyringen (kiosk bruker kioskUrlOverride; skranke bruker deskUrlOverride). Alle nøkler er valgfrie og tomme som standard, med mindre annet er nevnt.

• pairingCode (streng) — Kobler enheten automatisk til ved første oppstart. Appen injiserer koden i SPA-en, slik at personalet ikke trenger å skrive inn den 7-tegns koblingskoden på enheten. Per enhet — angi en annen verdi per nettbrett.
• managerPin (streng) — Angir nødutgangs-PIN-en sentralt. Når den er satt, hoppes den enhetslokale dialogen for førstegangsoppsett av PIN over. La stå tom for å la personalet på stedet sette PIN-en manuelt. Å sende en ny verdi er også den anbefalte måten å gjenopprette en glemt PIN uten å røre enheten.
• allowEscapeHatch (bool, standard true) — Sett til false for å deaktivere 5-trykks-bevegelsen i øvre høyre hjørne helt. Nyttig for offentlige kiosker med høy trafikk der du ikke ønsker noen rømningsvei.
• kioskUrlOverride / deskUrlOverride (streng) — Avansert, kun for staging/LAN. Overstyrer den innebygde SPA-URL-en (https://kiosk.jonot.io eller https://desk.jonot.io). La stå tom for produksjon.
• apiOriginOverride (streng) — Avansert, kun for staging/LAN. Overstyrer det innebygde API-opphavet (https://api.jonot.io). La stå tom for produksjon.

Distribuere innstillinger i EMM-en din

Det nøyaktige grensesnittet varierer etter EMM, men de generelle trinnene er:

1. Åpne den administrerte appkonfigurasjonen for Jonot Kiosk eller Jonot Desk i EMM-konsollen din.
2. EMM-en rendrer skjemaet som et skjema. Fyll inn nøklene du vil sette; la resten stå tomt for å bruke standardverdiene.
3. Tilordne konfigurasjonen til enhetsgruppen din eller enkeltenheter.
4. Send konfigurasjonen. Appen mottar den umiddelbart hvis enheten er tilkoblet, eller ved neste innsjekking.
5. Appen leser konfigurasjonen på nytt og bruker den. Endringer i URL og opphav laster WebView-en på nytt (i praksis en gjenoppretting av appen) — enhver pågående kundeflyt vil bli tilbakestilt.

Anbefalte innstillinger per utrulling

• pairingCode: koblingskoden fra Jonot-admin-dashbordet ditt for denne enheten.
• managerPin: din bedrifts IT-PIN-policy (eller la stå tom for oppsett på stedet).
• allowEscapeHatch: true for de fleste utrullinger; false bare hvis administrativ tilgang på stedet aldri er nødvendig.

URL-overstyringer

Du trenger ikke URL-overstyringsnøklene for vanlige produksjonsutrullinger. Sett dem bare hvis:

• Du tester mot et staging-miljø.
• Du har en lokal offline-vert-utrulling (apps/host) på et lokalt LAN.

Hvis du setter en URL-overstyring, sørg også for at enhetens byggekonfigurasjon ALLOW_CLEARTEXT tillater HTTP (for LAN-URL-er). Dette krever en tilpasset bygging — Play Store-byggingen har alltid cleartext satt til false som standard.

Atferdsdetaljer

• Automatisk kobling (pairingCode): Koden injiseres i SPA-en som window.__JONOT_MANAGED_PAIRING_CODE etter hver sideinnlasting. SPA-en leser denne verdien ved oppstart og fullfører koblingen automatisk. Å sende samme kode til en allerede koblet enhet er en no-op. Å sende en annen kode til en enhet som tidligere var automatisk koblet, utløser koblingen på nytt.
• Administrator-PIN (managerPin): Lagres i enhetens krypterte SharedPreferences under samme nøkkel som brukes av det enhetslokale PIN-oppsettet. Trer i kraft ved neste trykk på nødutgangen. Når den er satt, har PIN-en sendt fra EMM forrang og overskriver enhver enhetslokal PIN ved hver appoppstart eller konfigurasjonsendring.
• Nødutgang (allowEscapeHatch): Brukes umiddelbart ved en konfigurasjonsendring — ingen omstart kreves.
• URL-/opphavsoverstyringer: Brukes ved en konfigurasjonsendring. Appen laster på nytt til den nye URL-en — enhver pågående kundeflyt vil bli tilbakestilt.