Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
EN ESTA PÁGINA
 

Cliente Android de Marvis

Complete las tareas de preinstalación y elija el método que desea utilizar para instalar Marvis Client en el dispositivo.

El cliente de Marvis para Android proporciona una visibilidad detallada de cómo interactúa su dispositivo Android con la red inalámbrica. Ayuda a optimizar el rendimiento de la red, agilizar la resolución de problemas y mejorar la experiencia general del usuario al proporcionar información sobre la conectividad y el rendimiento del dispositivo.

El cliente Android de Marvis es compatible con los siguientes dispositivos:

  • Dispositivos portátiles Android y teléfonos inteligentes que ejecutan Android 11.0 y versiones posteriores

  • Dispositivos Zebra que ejecutan Android 11.0 y versiones posteriores

Descripción general de la instalación de Marvis Android Client

Puede utilizar cualquiera de los siguientes métodos para instalar la aplicación:

  • Manual: descargue e instale la aplicación cliente de Marvis directamente desde Google Play Store o el portal de Juniper Mist.

    Para descargar el cliente desde el portal de Juniper Mist:

    1. Seleccione Organización > administrador > SDK móvil en el menú de la izquierda.

    2. Haga clic en Marvis Client en la parte superior de la página del SDK para móviles.

    3. Seleccione la versión de la aplicación en Android y luego haga clic en Descargar instalador.

  • Puente de depuración de Android (ADB): instale la aplicación con ADB, una herramienta de línea de comandos que los desarrolladores pueden usar para comunicarse con dispositivos Android a fin de depurar problemas e instalar o desinstalar aplicaciones.

  • Administración de dispositivos móviles (MDM): use cualquiera de las siguientes soluciones MDM para instalar la aplicación:

    • AirWatch o VMware Workspace ONE

    • SOTI

    Nota:

    Hemos probado la interoperabilidad solo con los MDM mencionados anteriormente.

Requisitos

Antes de comenzar la instalación:

  • Active los permisos obligatorios enumerados en la tabla 1 para la aplicación.

    Tabla 1: Permisos necesarios para la aplicación Marvis Client para Android

    Permiso

    Descripción

    Obligatorio u opcional

    Ubicación: establecer como Permitir todo el tiempo

    Permite que la aplicación cliente de Marvis obtenga los datos de roaming Wi-Fi y funcione como se espera.

    Obligatorio

    Bluetooth

    Permite que la aplicación obtenga las coordenadas x e y de la ubicación.

    Obligatorio

    Dispositivos cercanos

    Permite que la aplicación determine la ubicación relativa de los dispositivos cercanos. Android 12 necesita habilitar este permiso para ejecutar el servicio de ubicación en dispositivos móviles.

    Obligatorio

    Notificaciones

    Habilita las notificaciones si desea recibir notificaciones cuando el cliente de Marvis se esté ejecutando activamente en segundo plano.

    Opcional

    Cámara: establecer como permitir una vez

    Le permite escanear el código QR durante la inscripción. No es necesario habilitar este permiso si está instalando la aplicación a través de ADB o MDM.

    Opcional

  • Configure los ajustes del firewall de red para permitir que el cliente de Marvis se conecte a su organización.

    Si su organización reside en la nube de Amazon Web Services (AWS) (predeterminada), utilice la siguiente configuración:

    • wss://client-terminator.mistsys.net:443/ws o protocolo WSS (websocket) puerto 443 para dominio/ruta

    • https://api.mist.com o el puerto de protocolo HTTPS 443 para el dominio

    Si tu organización reside en la nube de Google Cloud Platform (GCP), usa la siguiente configuración:

    • wss://client-terminator.gc1.mist.com/ws o protocolo WSS (websocket) puerto 443 para dominio/ruta

    • https://api.gc1.mist.com/ o el puerto de protocolo HTTPS 443 para el dominio

    Nota:

    Si su organización reside en una nube que no sea AWS o GCP, comuníquese con el equipo de soporte técnico para obtener las URL adecuadas para configurar los ajustes del firewall.

  • Obtenga su token secreto o código QR para incorporar el cliente de Marvis.

    1. Seleccione Organización > administrador > SDK móvil en el menú de la izquierda.

    2. Haga clic en Token en la parte superior de la página del SDK para móviles.

    3. Cree un token nuevo o use un token existente:

      • Para un nuevo token, haga clic en Crear invitación. Escriba un nombre para esta invitación y, a continuación, haga clic en Crear. Cuando el token aparezca en la página, haga clic en Ver para ver el código QR.

      • Para un token existente: consulte los nombres de los tokens para encontrar el que desea utilizar. Haga clic en el vínculo Ver en el lado derecho de la página para ver el código QR.

    Nota: Para obtener el token secreto mediante la API, consulte Crear invitación al SDK.

Como práctica recomendada, le recomendamos que desactive la dirección MAC aleatoria. Esto evita la necesidad de volver a registrar su dispositivo cada vez que se conecta a la red. Para deshabilitar la dirección MAC aleatoria:

  1. Vaya a la página Configuración en su dispositivo.

  2. Toca Red e Internet o Conexiones y luego toca Wi-Fi.

  3. Toque el icono de engranaje (configuración) junto a la conexión inalámbrica.

  4. Toque Tipo de dirección MAC y, a continuación, toque MAC del teléfono.

Modos operativos

Marvis Client funciona en los siguientes modos:

  • Modo de incorporación: modo predeterminado cuando se instala la aplicación cliente de Marvis con el método GUI. En este modo, puede incorporar dispositivos a través de un portal de NAC.

  • Modo de telemetría: modo en el que se instala la aplicación cliente de Marvis con el método CLI. Este modo es el modo operativo estándar para entornos en vivo.

Configurar el cliente Android de Marvis para la incorporación

Puede usar la aplicación Marvis Client para incorporar dispositivos a la red de Juniper Mist Access Assurance a través de un portal de control de acceso a la red (NAC) personalizado. Para obtener más información, consulte Incorporación de clientes a través de un portal de NAC con la aplicación Marvis Client.

Configure Marvis Android Client para que funcione en modo de telemetría

Para permitir que el cliente Marvis funcione en modo de telemetría, instale el cliente Marvis mediante un MDM (Implementar el Marvis Client con SOTI MDM) o adb un comando (Implementar Marvis cliente Android con otros MDM).

Modo de administrador en el cliente Android de Marvis

Cuando abra el cliente de Marvis en modo de incorporación o telemetría, solo verá las opciones Incorporación de red y Acerca de . Para ver otras opciones de menú, deberá cambiar al modo Administrador:

  1. Toque el icono de hamburguesa y, a continuación, toque el icono del cliente de Marvis 7 veces.

  2. Ingrese la contraseña como AIDriven. Ahora puede ver que está en el modo Administrador y puede ver opciones de menú adicionales.

    En el modo de administración, la página Acerca de muestra el UUID, el nombre del dispositivo, el ID de organización y el nombre de la organización.

    Puede usar la opción Configuración para actualizar o verificar el nombre del cliente, el acceso a la ubicación y el token del SDK móvil.

Estados de conexión

El estado de cliente de Marvis se indica mediante los siguientes indicadores visuales y estados de conexión. Tenga en cuenta que solo puede ver estos estados si el cliente de Marvis está en modo de telemetría.

  • Desconectado: el cliente no está conectado a la nube de Juniper Mist.

  • Conectado: el cliente está conectado a la nube de Juniper Mist.

  • Suspensión: el cliente se conecta a la nube de Juniper Mist a través de un AP que no es de Juniper.

Despliegue de Marvis Client con SOTI MDM

Para implementar el cliente de Marvis con una solución de administración de dispositivos móviles (MDM), debe personalizar la implementación del paquete del kit de paquetes de Android (APK). Personalice la implementación del APK con la acción de intención de establecer el token secreto del kit de desarrollo de software (SDK) durante la instalación. Cuando inicie el paquete de aplicación personalizado, el cliente estará completamente preconfigurado e incorporado para su funcionamiento.

Puede incorporar el cliente de Marvis utilizando SOTI MDM.

Nota:

No presentamos el proceso general de implementación de aplicaciones genéricas de Android con SOTI. Presentamos solo la información necesaria para personalizar la aplicación de Android a fin de completar el despliegue del cliente de Marvis.

Antes de empezar:

  1. Asegúrese de tener un dispositivo Windows o una máquina virtual (VM). Ejecutará Package Studio, que solo se ejecuta en dispositivos Windows.

  2. Descargue MobiControl Package Studio (McStudio.exe) de SOTI.

Para implementar el cliente de Marvis con SOTI MDM:

  1. En el dispositivo Windows o la máquina virtual, inicie Package Studio y cree un proyecto de paquete con la siguiente configuración:

    • Procesador:All (a menos que esté apuntando a tipos específicos de CPU o dispositivo)

    • Plataforma—Android

    • Versión del sistema operativo: 11 o posterior

    • Cadena de versión: igual que la versión de APK

    • Proveedor: Juniper Networks

    • Especificaciones opcionales de requisitos de espacio

  2. Agregue el APK del cliente de Marvis.
  3. Agregue el siguiente archivo de script:

    • Motor de scripts: legado

    • Tipo de script: posterior a la instalación

  4. Importe el archivo de script. El archivo de script debe tener el contenido siguiente:

    Si ha configurado un puerto específico en un dispositivo Zebra para llamadas de voz, el archivo de script debe tener el siguiente contenido:

  5. Compile el paquete.

Cuando implementa el paquete personalizado con SOTI, el cliente de Marvis se preconfigura e incorpora.

Implementar Marvis Client mediante AirWatch o VMware Workspace ONE

No cubrimos el proceso general de implementación de aplicaciones genéricas de Android con AirWatch. Cubrimos solo los pasos específicos necesarios para completar el despliegue de clientes de Marvis.

Use el siguiente comando de intención para implementar el cliente:

Si configuró un puerto específico en un dispositivo Zebra para llamadas de voz, utilice el siguiente comando de intención:

Puede utilizar las siguientes referencias para implementar el comando de intención:

Implementar el cliente Android de Marvis con Intune

Siga el procedimiento descrito en Agregar aplicaciones administradas de Google Play a dispositivos Android Enterprise con Intune para implementar el cliente Android de Marvis mediante Intune.

Una vez que Marvis Client se haya instalado correctamente, agregue los detalles de configuración, como el token secreto, el modo de ubicación y el nombre del dispositivo:

  1. En el portal de Intune, vaya a Aplicaciones>Administrar aplicaciones.

  2. Seleccione Configuración>Crear>Dispositivos administrados.

  3. Agregue detalles básicos como el nombre, la plataforma y el tipo de perfil. Seleccione Marvis Client como la aplicación de destino.

  4. Agregue los permisos de acceso a la ubicación y los ajustes de configuración, como MOBILE_LOCATION_DURATION, MOBILE_LOCATION_MODE, MOBILE_CLIENT_NAME Y MOBILE_SDK_SECRET.

  5. Agregar grupos.

  6. Haga clic en Crear.

Implementar el cliente de Android de Marvis con otros MDM

Si usas cualquier otro MDM, verifica que el MDM admita la ejecución de intenciones. A continuación, se muestra un ejemplo de implementación basada en Android Debug Bridge (ADB) (desarrollador/depuración) que puedes usar para adaptarte a un MDM de tu elección:

Habilite el modo de ubicación y actualice el nombre del cliente:

Si la solución MDM no admite la ejecución de intenciones de Android, es posible que deba incorporar cada dispositivo cliente implementado manualmente.

Verificar la instalación

Después de instalar e incorporar el cliente de Marvis, verifique que esos procesos se hayan ejecutado correctamente. Asegúrate de que tu dispositivo esté conectado a la red Wi-Fi de Mist.

Para comprobar la instalación:

  • Confirme que el valor del token secreto se haya aplicado correctamente. Vaya a la página Acerca de o Configuración (si está en el modo no productivo) de la aplicación cliente de Marvis y compruebe que el valor del token secreto sigue almacenado en el campo.

    Si los datos no persisten y el campo de token secreto está vacío, introduzca el valor del token secreto manualmente. Es posible que también deba configurar la implementación de la aplicación para conservar los datos de la aplicación.

  • Unos 15 minutos después de incorporar el cliente de Marvis, confirme que los datos del cliente de Marvis estén disponibles en el portal de Juniper Mist. Debe esperar un mínimo de 10 a 15 minutos después de incorporar el cliente de Marvis para que los datos se propaguen a la nube de Juniper Mist.

    Los datos del cliente no están disponibles en el portal de Juniper Mist cuando se produce un problema en el flujo de trabajo del cliente de recopilar y enviar datos a la nube de Juniper Mist. Póngase en contacto con el equipo de soporte. Puede acceder a los registros en la aplicación cliente de Marvis. Consulte Ver registros en el cliente Android de Marvis. Como alternativa, también puede usar herramientas como Logcat o Android Debug Bridge (ADB) para recopilar los registros del cliente de Marvis y compartirlos con el equipo de soporte.

    En el caso de los dispositivos Zebra, puede utilizar la herramienta RxLogger como método alternativo para recopilar registros.

    Cuando se comunique con el equipo de soporte, debe compartir el UUID del cliente de Marvis. Puede encontrar el UUID en la página Acerca de de la aplicación cliente de Marvis. El UUID se utiliza para rastrear el flujo de datos desde el cliente de Marvis a la nube de Juniper Mist.

Ver registros en el cliente Android de Marvis

El cliente de Marvis clasifica los registros de la siguiente manera:

  • Información: información general

  • Error: problemas graves

  • Depurar: datos detallados que puede utilizar para depurar problemas

Para ver los registros en la aplicación, deberá habilitar el modo de depuración en la aplicación:
  1. Toque el icono de hamburguesa y, a continuación, toque el icono de Marvis Client 7 veces.
    Se te pedirá una contraseña.
  2. Ingrese la contraseña como AIDriven.

    Verá la opción Registros en el menú.

  3. Toca Registros.
  4. Habilite Ver registros para ver los registros capturados por el cliente de Marvis. Puede seleccionar el tipo de información que desea ver en la lista desplegable Nivel de registro.
    Puede hacer clic en el botón Copiar para copiar y enviar los detalles del registro al equipo de soporte para la solución de problemas.
    Nota:

    Si se comunica con el equipo de soporte de Juniper Mist para resolver cualquier problema, es posible que se le solicite que proporcione detalles como el ID de la organización, UUID y el nombre de la organización. Puede encontrar estos detalles enumerados en la página Acerca de. Tenga en cuenta que deberá acceder a esta página en el modo Administrador para ver la información. Consulte Modo de administración en el cliente Android de Marvis.