Desplegar mediante EMM

¿Qué es un EMM?

Un Enterprise Mobility Manager (EMM) es una plataforma de TI que gestiona de forma centralizada una flota de tabletas Android — Intune (Microsoft), Jamf Pro, Esper, Scalefusion y Samsung Knox son opciones habituales. Una vez que tus apps de Jonot están registradas en tu EMM mediante Managed Google Play, el EMM puede enviar configuraciones administradas a cada dispositivo: ajustes clave/valor que la app lee al iniciarse y cada vez que el administrador de TI los actualiza, sin necesidad de una nueva compilación del APK.

Registro en Managed Google Play

Antes de poder enviar configuraciones, tus apps de Jonot deben estar disponibles en el catálogo de apps de tu EMM:

1. Sigue la guía de Google Import an app from Google Play para añadir Jonot Kiosk y Jonot Desk a tu cuenta de Managed Google Play.
2. En tu EMM, añade ambas apps al perfil de dispositivo que uses para las tabletas de quiosco/mostrador.
3. El EMM descubre automáticamente el esquema de configuración administrada de cada app (definido en app_restrictions.xml dentro del APK). No hace falta importar el esquema manualmente.

Claves de configuración

Ambas apps comparten las mismas claves, excepto la de sobrescritura de URL (el quiosco usa kioskUrlOverride; el mostrador usa deskUrlOverride). Todas las claves son opcionales y están vacías de forma predeterminada salvo que se indique lo contrario.

• pairingCode (cadena) — Empareja automáticamente el dispositivo en el primer inicio. La app inyecta el código en la SPA para que el personal no tenga que escribir el código de emparejamiento de 7 caracteres en el dispositivo. Por dispositivo — pon un valor distinto en cada tableta.
• managerPin (cadena) — Establece de forma centralizada el PIN de vía de escape. Cuando está establecido, se omite el diálogo de configuración inicial del PIN en el dispositivo. Déjalo en blanco para que el personal in situ configure el PIN manualmente. Enviar un nuevo valor es también la forma recomendada de recuperar un PIN olvidado sin tocar el dispositivo.
• allowEscapeHatch (booleano, predeterminado true) — Ponlo en false para desactivar por completo el gesto de 5 toques en la esquina superior derecha. Útil para quioscos públicos de alto tráfico donde no quieres ninguna vía de escape.
• kioskUrlOverride / deskUrlOverride (cadena) — Avanzado, solo para staging/LAN. Sobrescribe la URL de la SPA integrada (https://kiosk.jonot.io o https://desk.jonot.io). Déjalo en blanco para producción.
• apiOriginOverride (cadena) — Avanzado, solo para staging/LAN. Sobrescribe el origen de API integrado (https://api.jonot.io). Déjalo en blanco para producción.

Despliega los ajustes en tu EMM

La interfaz exacta varía según el EMM, pero los pasos generales son:

1. En la consola de tu EMM, abre la configuración de app administrada para Jonot Kiosk o Jonot Desk.
2. El EMM muestra el esquema como un formulario. Rellena las claves que quieras establecer; deja el resto en blanco para usar los valores predeterminados.
3. Asigna la configuración a tu grupo de dispositivos o a dispositivos individuales.
4. Envía la configuración. La app la recibe de inmediato si el dispositivo está en línea, o en el siguiente check-in.
5. La app vuelve a leer la configuración y la aplica. Los cambios de URL y origen recargan el WebView (en la práctica, una recreación de la app) — cualquier flujo de cliente en curso se reiniciará.

Ajustes recomendados por despliegue

• pairingCode: el código de emparejamiento de tu panel de administración de Jonot para este dispositivo.
• managerPin: tu política de PIN de TI corporativa (o déjalo en blanco para la configuración in situ).
• allowEscapeHatch: true para la mayoría de los despliegues; false solo si nunca se necesita acceso de gestión in situ.

Sobrescrituras de URL

No necesitas las claves de sobrescritura de URL para despliegues de producción estándar. Solo configúralas si:

• Estás probando contra un entorno de staging.
• Tienes un despliegue de host offline local (apps/host) en una LAN local.

Si estableces una sobrescritura de URL, asegúrate también de que la configuración de compilación ALLOW_CLEARTEXT del dispositivo permita HTTP (para URL de LAN). Esto requiere una compilación personalizada — la compilación de la Play Store siempre establece cleartext en false de forma predeterminada.

Detalles de comportamiento

• Emparejamiento automático (pairingCode): El código se inyecta en la SPA como window.__JONOT_MANAGED_PAIRING_CODE después de cada carga de página. La SPA lee este valor al iniciarse y completa el emparejamiento automáticamente. Enviar el mismo código a un dispositivo ya emparejado no tiene efecto. Enviar un código distinto a un dispositivo que se emparejó automáticamente antes desencadenará el emparejamiento de nuevo.
• PIN de gestor (managerPin): Se almacena en las SharedPreferences cifradas del dispositivo bajo la misma clave que usa la configuración del PIN en el dispositivo. Se aplica en el siguiente toque de vía de escape. Cuando está establecido, el PIN enviado por el EMM tiene prioridad y sobrescribe cualquier PIN local en cada inicio de la app o cambio de configuración.
• Vía de escape (allowEscapeHatch): Se aplica de inmediato al cambiar la configuración — no se necesita reiniciar.
• Sobrescrituras de URL/origen: Se aplican al cambiar la configuración. La app se recarga a la nueva URL — cualquier flujo de cliente en curso se reiniciará.