Implementar via EMM

O que é um EMM?

Uma plataforma de gestão de mobilidade empresarial (EMM) permite que a equipe de TI gerencie vários tablets Android em um só lugar. Alguns exemplos são Microsoft Intune, Jamf Pro, Esper, Scalefusion e Samsung Knox. Depois de adicionar os aplicativos Jonot ao EMM pelo Managed Google Play, você pode enviar Configurações Gerenciadas para cada dispositivo. O aplicativo lê essas configurações ao iniciar e sempre que a equipe de TI as altera. Não é preciso gerar outro APK.

Registrar no Managed Google Play

Antes de poder enviar configurações, os seus aplicativos Jonot precisam estar disponíveis no catálogo de aplicativos do seu EMM:

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

Chaves de configuração

Ambos os aplicativos compartilham 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 padrão um valor vazio, salvo indicação em contrário.

• pairingCode (texto) — Associa automaticamente o dispositivo na primeira inicialização. O aplicativo injeta o código na SPA, para que a equipe não precise digitar o código de associação de 7 caracteres 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 a equipe 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, padrã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 configurações no seu EMM

A interface exata varia de acordo com o EMM, mas os passos gerais são:

1. No console do seu EMM, abra a configuração gerenciada do aplicativo Jonot Kiosk ou Jonot Desk.
2. O EMM apresenta o esquema como um formulário. Preencha as chaves que deseja definir; deixe as demais em branco para usar os padrões.
3. Atribua a configuração ao seu grupo de dispositivos ou a dispositivos individuais.
4. Envie a configuração. Se o dispositivo estiver online, o aplicativo a recebe imediatamente. Caso contrário, recebe na próxima verificação.
5. O aplicativo lê e aplica a nova configuração. Alterações de URL e origem recarregam a WebView e reiniciam qualquer fluxo de cliente em andamento.

Configuraçõ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 testando em um ambiente de staging.
• Tiver uma implementação de host offline no local (apps/host) em uma 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 padrã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 na inicialização 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): Salvo nas SharedPreferences criptografadas 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 o aplicativo inicia 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. O aplicativo recarrega para o novo URL — qualquer fluxo de cliente em andamento será reiniciado.