Implementar via EMM

O que é um EMM?

Um Enterprise Mobility Manager (EMM) é uma plataforma de TI que gere de forma centralizada uma frota de tablets Android — Intune (Microsoft), Jamf Pro, Esper, Scalefusion e Samsung Knox são escolhas comuns. Depois de as suas aplicações Jonot estarem registadas no seu EMM através do Managed Google Play, o EMM pode enviar Configurações Geridas para cada dispositivo: definições de chave/valor que a aplicação lê no arranque e sempre que o administrador de TI as atualiza, sem necessidade de uma nova compilação do APK.

Registar no Managed Google Play

Antes de poder enviar configurações, as suas aplicações Jonot têm de estar disponíveis no catálogo de aplicações do seu EMM:

1. Siga o guia da Google Importar uma aplicação do Google Play para adicionar o Jonot Kiosk e o Jonot Desk à sua conta Managed Google Play.
2. No seu EMM, adicione ambas as aplicações ao perfil de dispositivo que usa para os tablets de quiosque/balcão.
3. O EMM deteta automaticamente o esquema de configuração gerida de cada aplicação (definido em app_restrictions.xml dentro do APK). Não é necessária nenhuma importação manual do esquema.

Chaves de configuração

Ambas as aplicações partilham as mesmas chaves, exceto a substituição de URL (o quiosque usa kioskUrlOverride; o balcão usa deskUrlOverride). Todas as chaves são opcionais e têm por predefinição um valor vazio, salvo indicação em contrário.

• pairingCode (texto) — Associa automaticamente o dispositivo no primeiro arranque. A aplicação injeta o código na SPA, para que o pessoal não tenha de digitar o código de associação de 7 carateres no dispositivo. Por dispositivo — defina um valor diferente por tablet.
• managerPin (texto) — Define centralmente o PIN da saída de emergência. Quando definido, a caixa de diálogo de configuração de PIN de primeira execução no dispositivo é ignorada. Deixe em branco para que o pessoal no local defina o PIN manualmente. Enviar um novo valor é também a forma recomendada de recuperar um PIN esquecido sem tocar no dispositivo.
• allowEscapeHatch (booleano, predefinição true) — Defina como false para desativar totalmente o gesto de 5 toques no canto superior direito. Útil para quiosques públicos de tráfego elevado onde não quer nenhuma via de saída.
• kioskUrlOverride / deskUrlOverride (texto) — Avançado, apenas para staging/LAN. Substitui o URL da SPA incorporado (https://kiosk.jonot.io ou https://desk.jonot.io). Deixe em branco para produção.
• apiOriginOverride (texto) — Avançado, apenas para staging/LAN. Substitui a origem da API incorporada (https://api.jonot.io). Deixe em branco para produção.

Implementar definições no seu EMM

A interface exata varia consoante o EMM, mas os passos gerais são:

1. Na consola do seu EMM, abra a configuração de aplicação gerida para Jonot Kiosk ou Jonot Desk.
2. O EMM apresenta o esquema como um formulário. Preencha as chaves que quer definir; deixe as restantes em branco para usar as predefinições.
3. Atribua a configuração ao seu grupo de dispositivos ou a dispositivos individuais.
4. Envie a configuração. A aplicação recebe-a de imediato se o dispositivo estiver online, ou na próxima verificação de estado.
5. A aplicação volta a ler a configuração e aplica-a. As alterações de URL e de origem recarregam a WebView (efetivamente uma recriação da aplicação) — qualquer fluxo de cliente em curso será reiniciado.

Definições recomendadas por implementação

• pairingCode: o código de associação do seu painel de administração Jonot para este dispositivo.
• managerPin: a sua política de PIN de TI corporativa (ou deixe em branco para configuração no local).
• allowEscapeHatch: true para a maioria das implementações; false apenas se nunca for necessário acesso de gestão no local.

Substituições de URL

Não precisa das chaves de substituição de URL para implementações de produção padrão. Defina-as apenas se:

• Estiver a testar contra um ambiente de staging.
• Tiver uma implementação de anfitrião offline no local (apps/host) numa LAN local.

Se definir uma substituição de URL, certifique-se também de que a configuração de compilação ALLOW_CLEARTEXT do dispositivo permite HTTP (para URLs de LAN). Isto requer uma compilação personalizada — a compilação da Play Store define sempre o cleartext como false por predefinição.

Detalhes de comportamento

• Associação automática (pairingCode): O código é injetado na SPA como window.__JONOT_MANAGED_PAIRING_CODE depois de cada carregamento de página. A SPA lê este valor no arranque e conclui a associação automaticamente. Enviar o mesmo código para um dispositivo já associado não tem efeito. Enviar um código diferente para um dispositivo que já tinha sido associado automaticamente vai acionar a associação de novo.
• PIN de gestor (managerPin): Guardado nas SharedPreferences encriptadas do dispositivo, sob a mesma chave usada pela configuração de PIN no dispositivo. Tem efeito no próximo toque na saída de emergência. Quando definido, o PIN enviado pelo EMM tem precedência e substitui qualquer PIN no dispositivo sempre que a aplicação arranca ou a configuração muda.
• Saída de emergência (allowEscapeHatch): Aplicada de imediato quando a configuração muda — sem necessidade de reiniciar.
• Substituições de URL/origem: Aplicadas quando a configuração muda. A aplicação recarrega para o novo URL — qualquer fluxo de cliente em curso será reiniciado.