Udrul via EMM

Hvad er en EMM?

En Enterprise Mobility Manager (EMM) er en it-platform, der administrerer flere Android-tablets centralt. Intune (Microsoft), Jamf Pro, Esper, Scalefusion og Samsung Knox er almindelige valg. Når dine Jonot-apps er tilmeldt din EMM via Managed Google Play, kan EMM’en sende administrerede konfigurationer til hver enhed. Appen læser disse nøgle/værdi-indstillinger ved opstart og efter hver ændring. Du behøver ikke bygge en ny APK.

Tilmelding til Managed Google Play

Før du kan sende konfiguration, skal dine Jonot-apps være tilgængelige i din EMM’s app-katalog:

1. Følg Googles guide Import an app from Google Play for at tilføje Jonot Kiosk og Jonot Desk til din Managed Google Play-konto.
2. Tilføj i din EMM begge apps til den enhedsprofil, du bruger til kiosk-/skranke-tablets.
3. EMM’en registrerer automatisk hver apps skema for administreret konfiguration (defineret i app_restrictions.xml inde i APK’en). Ingen manuel skemaimport er nødvendig.

Konfigurationsnøgler

Begge apps deler de samme nøgler, bortset fra URL-tilsidesættelsen (kiosk bruger kioskUrlOverride; skranke bruger deskUrlOverride). Alle nøgler er valgfrie og er som standard tomme, medmindre andet er angivet.

• pairingCode (streng) — Kobl enheden automatisk ved første start. Appen indsætter koden i SPA’en, så personalet ikke skal indtaste den 7-tegns koblingskode på enheden. Pr. enhed — angiv en forskellig værdi pr. tablet.
• managerPin (streng) — Angiv centralt undslippelses-PIN-koden. Er den angivet, springes dialogen til opsætning af PIN-koden ved første kørsel på enheden over. Lad stå tomt for at lade personalet på stedet angive PIN-koden manuelt. At sende en ny værdi er også den anbefalede måde at gendanne en glemt PIN-kode uden at røre enheden.
• allowEscapeHatch (bool, standard true) — Sæt til false for helt at deaktivere 5-tryks-gestussen i øverste højre hjørne. Nyttigt til offentlige kiosker med høj trafik, hvor du ikke ønsker nogen flugtvej.
• kioskUrlOverride / deskUrlOverride (streng) — Avanceret, kun staging/LAN. Tilsidesætter den indbagte SPA-URL (https://kiosk.jonot.io eller https://desk.jonot.io). Lad stå tomt til produktion.
• apiOriginOverride (streng) — Avanceret, kun staging/LAN. Tilsidesætter den indbagte API-oprindelse (https://api.jonot.io). Lad stå tomt til produktion.

Udrulning af indstillinger i din EMM

Brugerfladen afhænger af EMM-systemet, men trinnene er:

1. Åbn i din EMM-konsol den administrerede app-konfiguration for Jonot Kiosk eller Jonot Desk.
2. EMM’en gengiver skemaet som en formular. Udfyld de nøgler, du vil angive; lad resten stå tomt for at bruge standarder.
3. Tildel konfigurationen til din enhedsgruppe eller individuelle enheder.
4. Send konfigurationen. Appen modtager den med det samme, hvis enheden er online, eller ved næste check-in.
5. Appen genindlæser og anvender konfigurationen. Ændringer af URL og oprindelse genindlæser WebView. Et igangværende kundeforløb nulstilles.

Anbefalede indstillinger pr. udrulning

• pairingCode: koblingskoden fra dit Jonot-admin-dashboard for denne enhed.
• managerPin: din virksomheds it-PIN-politik (eller lad stå tomt til opsætning på stedet).
• allowEscapeHatch: true til de fleste udrulninger; false kun hvis der aldrig er brug for administrationsadgang på stedet.

URL-tilsidesættelser

Du behøver ikke URL-tilsidesættelsesnøglerne til almindelige produktionsudrulninger. Angiv dem kun, hvis:

• Du tester mod et staging-miljø.
• Du har en lokal offline-værtsudrulning (apps/host) på et lokalt LAN.

Angiver du en URL-tilsidesættelse, skal du også sikre, at enhedens build-konfiguration ALLOW_CLEARTEXT tillader HTTP (til LAN-URL’er). Dette kræver en tilpasset bygning — Play Store-bygningen bruger altid false som standard for cleartext.

Adfærdsdetaljer

• Automatisk kobling (pairingCode): Koden indsættes i SPA’en som window.__JONOT_MANAGED_PAIRING_CODE efter hver sideindlæsning. SPA’en læser denne værdi ved opstart og fuldfører koblingen automatisk. At sende den samme kode til en allerede koblet enhed er en no-op. At sende en anden kode til en enhed, der tidligere var automatisk koblet, udløser kobling igen.
• Administrator-PIN (managerPin): Gemmes i enhedens krypterede SharedPreferences under den samme nøgle, der bruges af PIN-opsætningen på enheden. Træder i kraft ved næste tryk på undslippelsesvejen. Er den angivet, har den EMM-sendte PIN-kode forrang og overskriver enhver PIN-kode på enheden ved hver appstart eller konfigurationsændring.
• Undslippelsesvej (allowEscapeHatch): Anvendes med det samme ved konfigurationsændring — ingen genstart nødvendig.
• URL-/oprindelses-tilsidesættelser: Anvendes ved konfigurationsændring. Appen genindlæser til den nye URL — ethvert igangværende kundeforløb nulstilles.