Distribuire tramite EMM

Cos’è un EMM?

Un Enterprise Mobility Manager (EMM) è una piattaforma IT che gestisce centralmente una flotta di tablet Android — Intune (Microsoft), Jamf Pro, Esper, Scalefusion e Samsung Knox sono scelte comuni. Una volta che le tue app Jonot sono registrate nel tuo EMM tramite Managed Google Play, l’EMM può inviare Managed Configurations a ogni dispositivo: impostazioni chiave/valore che l’app legge all’avvio e ogni volta che l’amministratore IT le aggiorna, senza richiedere una nuova build APK.

Registrazione in Managed Google Play

Prima di poter inviare la configurazione, le tue app Jonot devono essere disponibili nel catalogo app del tuo EMM:

1. Segui la guida di Google Import an app from Google Play per aggiungere Jonot Kiosk e Jonot Desk al tuo account Managed Google Play.
2. Nel tuo EMM, aggiungi entrambe le app al profilo dispositivo che usi per i tablet chiosco/sportello.
3. L’EMM rileva automaticamente lo schema di configurazione gestita di ciascuna app (definito in app_restrictions.xml all’interno dell’APK). Non è necessaria alcuna importazione manuale dello schema.

Chiavi di configurazione

Entrambe le app condividono le stesse chiavi, ad eccezione della sovrascrittura dell’URL (il chiosco usa kioskUrlOverride; lo sportello usa deskUrlOverride). Tutte le chiavi sono facoltative e per impostazione predefinita vuote salvo indicazione contraria.

• pairingCode (stringa) — Abbina automaticamente il dispositivo al primo avvio. L’app inserisce il codice nella SPA così il personale non deve digitare il codice di abbinamento di 7 caratteri sul dispositivo. Per dispositivo — imposta un valore diverso per ogni tablet.
• managerPin (stringa) — Imposta centralmente il PIN di via di fuga. Se impostato, la finestra di configurazione PIN al primo avvio sul dispositivo viene saltata. Lascia vuoto per lasciare che il personale in sede imposti il PIN manualmente. L’invio di un nuovo valore è anche il modo consigliato per recuperare un PIN dimenticato senza toccare il dispositivo.
• allowEscapeHatch (bool, predefinito true) — Imposta su false per disabilitare completamente il gesto dei 5 tocchi nell’angolo in alto a destra. Utile per chioschi pubblici ad alto traffico dove non si vuole alcuna via di fuga.
• kioskUrlOverride / deskUrlOverride (stringa) — Avanzato, solo staging/LAN. Sovrascrive l’URL SPA incorporato (https://kiosk.jonot.io o https://desk.jonot.io). Lascia vuoto per la produzione.
• apiOriginOverride (stringa) — Avanzato, solo staging/LAN. Sovrascrive l’origine API incorporata (https://api.jonot.io). Lascia vuoto per la produzione.

Distribuire le impostazioni nel tuo EMM

L’interfaccia esatta varia a seconda dell’EMM, ma i passaggi generali sono:

1. Nella console del tuo EMM, apri la configurazione dell’app gestita per Jonot Kiosk o Jonot Desk.
2. L’EMM presenta lo schema come un modulo. Compila le chiavi che vuoi impostare; lascia il resto vuoto per usare i valori predefiniti.
3. Assegna la configurazione al tuo gruppo di dispositivi o a singoli dispositivi.
4. Invia la configurazione. L’app la riceve immediatamente se il dispositivo è online, oppure al prossimo check-in.
5. L’app rilegge la configurazione e la applica. Le modifiche a URL e origine ricaricano la WebView (di fatto una ricreazione dell’app) — qualsiasi flusso cliente in corso verrà azzerato.

Impostazioni consigliate per distribuzione

• pairingCode: il codice di abbinamento dalla tua dashboard di amministrazione Jonot per questo dispositivo.
• managerPin: la policy PIN IT aziendale (oppure lascia vuoto per la configurazione in sede).
• allowEscapeHatch: true per la maggior parte delle distribuzioni; false solo se non è mai necessario un accesso gestionale in sede.

Sovrascritture URL

Non hai bisogno delle chiavi di sovrascrittura URL per distribuzioni di produzione standard. Impostale solo se:

• Stai testando su un ambiente di staging.
• Hai una distribuzione host offline on-premises (apps/host) su una LAN locale.

Se imposti una sovrascrittura URL, assicurati anche che la configurazione build ALLOW_CLEARTEXT del dispositivo consenta HTTP (per URL LAN). Questo richiede una build personalizzata — la build dello Store Play imposta sempre il testo in chiaro su false per impostazione predefinita.

Dettagli sul comportamento

• Abbinamento automatico (pairingCode): Il codice viene iniettato nella SPA come window.__JONOT_MANAGED_PAIRING_CODE dopo ogni caricamento della pagina. La SPA legge questo valore all’avvio e completa l’abbinamento automaticamente. Inviare lo stesso codice a un dispositivo già abbinato non ha alcun effetto. Inviare un codice diverso a un dispositivo precedentemente abbinato automaticamente attiverà di nuovo l’abbinamento.
• PIN manager (managerPin): Memorizzato nelle SharedPreferences crittografate del dispositivo sotto la stessa chiave usata dalla configurazione PIN sul dispositivo. Ha effetto al successivo tocco della via di fuga. Se impostato, il PIN inviato dall’EMM ha la precedenza e sovrascrive qualsiasi PIN sul dispositivo a ogni avvio dell’app o modifica della configurazione.
• Via di fuga (allowEscapeHatch): Applicata immediatamente al cambio di configurazione — nessun riavvio necessario.
• Sovrascritture URL/origine: Applicate al cambio di configurazione. L’app ricarica alla nuova URL — qualsiasi flusso cliente in corso verrà azzerato.