Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
NESTA PÁGINA
 

Cliente Android Marvis

Conclua as tarefas de pré-instalação e escolha o método que deseja usar para instalar o Cliente Marvis em seu dispositivo.

O cliente Marvis para Android oferece visibilidade detalhada de como seu dispositivo Android interage com a rede sem fio. Ele ajuda a otimizar o desempenho da rede, simplificar a solução de problemas e aprimorar a experiência geral do usuário, fornecendo informações sobre a conectividade e o desempenho do dispositivo.

O cliente Android do Marvis é compatível com os seguintes dispositivos:

  • Dispositivos portáteis Android e smartphones com Android 11.0 e versões posteriores

  • Dispositivos Zebra com Android 11.0 e versões posteriores

Visão geral da instalação do cliente Android Marvis

Você pode usar qualquer um dos seguintes métodos para instalar o aplicativo:

  • Manual — Baixe e instale o aplicativo cliente Marvis diretamente da Google Play Store ou do portal Juniper Mist.

    Para baixar o cliente do portal da Juniper Mist:

    1. Selecione Organização > Administrador > SDK Móvel no menu à esquerda.

    2. Clique em Cliente Marvis na parte superior da página do SDK para dispositivos móveis.

    3. Selecione a versão do aplicativo em Android e clique em Baixar instalador.

  • Android Debug Bridge (ADB) — Instale o aplicativo usando o ADB, uma ferramenta de linha de comando que os desenvolvedores podem usar para se comunicar com dispositivos Android para depurar problemas e instalar/desinstalar aplicativos.

  • Gerenciamento de dispositivos móveis (MDM) — Use qualquer uma das seguintes soluções de MDM para instalar o aplicativo:

    • AirWatch ou VMware Workspace ONE

    • SOTI

    Observação:

    Testamos a interoperabilidade apenas com os MDMs listados acima.

Requerimentos

Antes de iniciar a instalação:

  • Habilite as permissões obrigatórias listadas na Tabela 1 para o aplicativo.

    Tabela 1: Permissões necessárias para o aplicativo Cliente Marvis para Android

    Permissão

    Descrição

    Obrigatório ou opcional

    Local — Defina como Permitir o tempo todo

    Permite que o aplicativo cliente Marvis obtenha os dados de roaming de Wi-Fi e funcione conforme o esperado.

    Obrigatório

    Bluetooth

    Permite que o aplicativo obtenha as coordenadas x e y do local.

    Obrigatório

    Dispositivos próximos

    Permite que o aplicativo determine a localização relativa de dispositivos próximos. O Android 12 precisa dessa permissão ativada para executar o serviço de localização em dispositivos móveis.

    Obrigatório

    Notificações

    Habilita notificações se você quiser ser notificado quando o cliente Marvis estiver sendo executado ativamente em segundo plano.

    Opcionais

    Câmera — Definir como Permitir uma vez

    Permite que você escaneie o código QR durante o registro. Você não precisa habilitar essa permissão se estiver instalando o aplicativo por meio do ADB ou MDM.

    Opcionais

  • Defina as configurações do firewall de rede para permitir que o cliente Marvis se conecte à sua organização.

    Se sua organização residir na nuvem da Amazon Web Services (AWS) (padrão), use as seguintes configurações:

    • wss://client-terminator.mistsys.net:443/ws ou protocolo WSS (websocket) porta 443 para domínio/caminho

    • https://api.mist.com ou a porta 443 do protocolo HTTPS para domínio

    Se sua organização residir na nuvem do Google Cloud Platform (GCP), use as seguintes configurações:

    • wss://client-terminator.gc1.mist.com/ws ou protocolo WSS (websocket) porta 443 para domínio/caminho

    • https://api.gc1.mist.com/ ou a porta 443 do protocolo HTTPS para domínio

    Observação:

    Se sua organização residir em uma nuvem diferente da AWS ou do GCP, entre em contato com a equipe de suporte para obter os URLs apropriados para definir as configurações de firewall.

  • Obtenha seu token secreto ou código QR para integrar o cliente Marvis.

    1. Selecione Organização > Administrador > SDK Móvel no menu à esquerda.

    2. Clique em Token na parte superior da página do SDK para dispositivos móveis.

    3. Crie um novo token ou use um token existente:

      • Para um novo token, clique em Criar convite. Insira um nome para esse convite e clique em Criar. Quando o token aparecer na página, clique em Exibir para ver o código QR.

      • Para um token existente: consulte os nomes dos tokens para localizar aquele que você deseja usar. Clique no link Exibir no lado direito da página para ver o código QR.

    Observação: Para obter o token secreto usando a API, consulte Criar convite do SDK.

Como prática recomendada, recomendamos que você desative o endereço MAC aleatório. Isso evita a necessidade de registrar novamente seu dispositivo toda vez que ele se conectar à rede. Para desativar o endereço MAC aleatório:

  1. Navegue até a página Configurações no seu dispositivo.

  2. Toque em Rede e Internet ou Conexões e, em seguida, toque em Wi-Fi.

  3. Toque no ícone de engrenagem (configurações) ao lado da conexão sem fio.

  4. Toque em Tipo de endereço MAC e, em seguida, toque em Phone MAC.

Modos operacionais

O cliente Marvis opera nos seguintes modos:

  • Modo de integração: modo padrão quando você instala o aplicativo cliente Marvis usando o método GUI. Nesse modo, você pode integrar dispositivos por meio de um portal NAC.

  • Modo de telemetria — Modo quando você instala o aplicativo cliente Marvis usando o método CLI. Esse modo é o modo operacional padrão para ambientes ao vivo.

Configurar o cliente Android Marvis para integração

Você pode usar o aplicativo Cliente Marvis para integrar dispositivos à rede Juniper Mist Access Assurance por meio de um portal personalizado de Controle de acesso à rede (NAC). Para obter mais informações, consulte Integração de clientes por meio de um portal NAC usando o aplicativo Cliente Marvis.

Configurar o cliente Android do Marvis para operar no modo de telemetria

Para permitir que o cliente Marvis opere no modo de telemetria, instale o cliente Marvis usando um MDM (Implantar o Cliente Marvis Usando o MDM SOTI) ou adb comando (Implantar Cliente Android Marvis Usando Outros MDMs).

Modo de administrador no cliente Android do Marvis

Ao abrir o cliente Marvis no modo de integração ou telemetria, você verá apenas as opções Integração de Rede e Sobre . Para ver outras opções de menu, você precisará alternar para o modo Admin:

  1. Toque no ícone de hambúrguer e, em seguida, toque no ícone do cliente Marvis 7 vezes.

  2. Digite a senha como AIDriven. Agora você pode ver que está no modo Admin e pode ver opções de menu adicionais.

    No modo Admin, a página Sobre exibe o UUID, o nome do dispositivo, o ID da organização e o nome da organização.

    Você pode usar a opção Configuração para atualizar ou verificar o nome do cliente, o acesso ao local e o token do SDK móvel.

Estados de conexão

O status do cliente Marvis é indicado pelos seguintes indicadores visuais e estados de conexão. Observe que você só poderá visualizar esses estados se o cliente Marvis estiver no modo de telemetria.

  • Desconectado — o cliente não está conectado à nuvem da Juniper Mist.

  • Conectado — o cliente está conectado à nuvem Juniper Mist.

  • Suspensão — O cliente está conectado à nuvem Juniper Mist por meio de um AP que não é da Juniper.

Implantar o Cliente Marvis usando o MDM SOTI

Para implantar o cliente Marvis usando uma solução de gerenciamento de dispositivos móveis (MDM), você deve personalizar a implantação do pacote do kit de pacotes do Android (APK). Você personaliza a implantação do APK com a ação de intenção de definir o token secreto do kit de desenvolvimento de software (SDK) na instalação. Quando você inicia o pacote de aplicativos personalizado, o cliente é totalmente pré-configurado e integrado para operação.

Você pode integrar o cliente Marvis usando o MDM SOTI.

Observação:

Não apresentamos o processo geral de implantação de aplicativos Android genéricos com o SOTI. Apresentamos apenas as informações necessárias para personalizar o aplicativo Android para concluir a implantação do cliente Marvis.

Antes de começar:

  1. Verifique se você tem um dispositivo Windows ou uma VM (máquina virtual). Você executará o Package Studio, que é executado apenas em dispositivos Windows.

  2. Baixe o MobiControl Package Studio da SOTI (McStudio.exe).

Para implantar o cliente Marvis usando o MDM SOTI:

  1. Em seu dispositivo Windows ou VM, inicie o Package Studio e crie um projeto de pacote com as seguintes configurações:

    • Processador—All (a menos que você esteja segmentando tipos específicos de CPU ou dispositivo)

    • Plataforma—Android

    • Versão do sistema operacional — 11 ou posterior

    • String de versão — igual à versão do APK

    • Fornecedor — Juniper Networks

    • Especificações opcionais de requisitos de espaço

  2. Adicione o APK do cliente Marvis.
  3. Adicione o seguinte arquivo de script:

    • Mecanismo de script — legado

    • Tipo de script — pós-instalação

  4. Importe o arquivo de script. O arquivo de script deve ter o seguinte conteúdo:

    Se você configurou uma porta específica em um dispositivo Zebra para chamadas de voz, o arquivo de script deve ter o seguinte conteúdo:

  5. Construa o pacote.

Quando você implanta o pacote personalizado com o SOTI, o cliente Marvis é pré-configurado e integrado.

Implantar o Cliente Marvis usando o AirWatch ou o VMware Workspace ONE

Não cobrimos o processo geral de implantação de aplicativos Android genéricos com o AirWatch. Abordamos apenas as etapas específicas necessárias para concluir a implantação do cliente Marvis.

Use o seguinte comando intent para implantar o cliente:

Se você configurou uma porta específica em um dispositivo Zebra para chamadas de voz, use o seguinte comando intent:

Você pode usar as seguintes referências para implantar o comando intent:

Implantar o cliente Android Marvis usando o Intune

Siga o procedimento em Adicionar aplicativos gerenciados do Google Play a dispositivos Android Enterprise com Intune para implantar o cliente Marvis Android usando Intune.

Depois que o cliente Marvis for instalado com êxito, adicione os detalhes de configuração, como token secreto, modo de localização e nome do dispositivo:

  1. No portal do Intune, navegue até Aplicativos>Gerenciar Aplicativos.

  2. Selecione Configuração>Criar>Dispositivos gerenciados.

  3. Adicione detalhes básicos, como nome, plataforma e tipo de perfil. Selecione Cliente Marvis como o aplicativo de destino.

  4. Adicione as permissões de acesso ao local e as definições de configuração, como MOBILE_LOCATION_DURATION, MOBILE_LOCATION_MODE, MOBILE_CLIENT_NAME E MOBILE_SDK_SECRET.

  5. Adicione grupos.

  6. Clique em Criar.

Implantar o cliente Android Marvis usando outros MDMs

Se você estiver usando qualquer outro MDM, verifique se o MDM dá suporte à execução intencional. Aqui está um exemplo de implantação baseada no Android Debug Bridge (ADB) (desenvolvedor/depuração) que você pode usar para se adaptar a um MDM de sua escolha:

Ative o modo de localização e atualize o nome do cliente:

Se a solução MDM não der suporte à execução de intenções do Android, talvez seja necessário integrar cada dispositivo cliente implantado manualmente.

Verifique a instalação

Depois de instalar e integrar o cliente Marvis, verifique se esses processos foram executados corretamente. Certifique-se de que seu dispositivo esteja conectado à rede Wi-Fi da Mist.

Para verificar a instalação:

  • Confirme se o valor do token secreto foi aplicado corretamente. Navegue até a página Sobre ou Configuração (se você estiver no modo de não produção) no aplicativo cliente Marvis e verifique se o valor do token secreto ainda está armazenado no campo.

    Se os dados não persistirem e o campo de token secreto estiver vazio, insira o valor do token secreto manualmente. Talvez seja necessário configurar também a implantação do aplicativo para reter os dados do aplicativo.

  • Cerca de 15 minutos após a integração do cliente Marvis, confirme se os dados do cliente Marvis estão disponíveis no portal da Juniper Mist. Você precisa aguardar um mínimo de 10 a 15 minutos após a integração do cliente Marvis para que os dados se propaguem para a nuvem da Juniper Mist.

    Os dados do cliente não estão disponíveis no portal da Juniper Mist quando ocorre um problema no fluxo de trabalho do cliente de coleta e envio de dados para a nuvem da Juniper Mist. Entre em contato com a equipe de suporte. Você pode acessar os logs no aplicativo cliente Marvis. Consulte Exibir logs no cliente Android do Marvis. Como alternativa, você também pode usar ferramentas como o Logcat ou o Android Debug Bridge (ADB) para coletar os registros do cliente Marvis e compartilhá-los com a equipe de suporte.

    Para dispositivos Zebra, você pode usar a ferramenta RxLogger como um método alternativo para coletar logs.

    Ao entrar em contato com a equipe de suporte, você deve compartilhar o UUID do cliente Marvis. Você pode encontrar o UUID na página Sobre do aplicativo cliente Marvis. O UUID é usado para rastrear o fluxo de dados do cliente Marvis para a nuvem da Juniper Mist.

Exibir logs no cliente Android do Marvis

O cliente Marvis classifica os logs como:

  • Info — Informações gerais

  • Erro — Problemas críticos

  • Depurar — dados detalhados que você pode usar para depurar problemas

Para exibir os logs no aplicativo, você precisará habilitar o modo de depuração no aplicativo:
  1. Toque no ícone de hambúrguer e, em seguida, toque no ícone do Cliente Marvis 7 vezes.
    Você será solicitado a fornecer uma senha.
  2. Digite a senha como AIDriven.

    Você verá a opção Logs listada no menu.

  3. Toque em Logs.
  4. Ative Exibir logs para exibir os logs capturados pelo cliente Marvis. Você pode selecionar o tipo de informação que deseja exibir na lista suspensa Nível de Log.
    Você pode clicar no botão Copiar para copiar e enviar os detalhes do log para a equipe de suporte para solução de problemas.
    Observação:

    Se você entrar em contato com a equipe de suporte do Juniper Mist para resolver qualquer problema, poderá ser solicitado que você forneça detalhes como o ID da organização, o UUID e o nome da organização. Você pode encontrar esses detalhes listados na página Sobre. Observe que você precisará acessar esta página no modo Admin para visualizar as informações. Consulte Modo de administrador no cliente Android do Marvis.