Product Documentation

Provisionando o modo Proprietário do Dispositivo no Android for Work

Oct 06, 2016

Para provisionar o Android for Work no modo Proprietário do Dispositivo, você deve transferir dados por meio de um aumento de Comunicação a Curta Distância (NFC) entre dois dispositivos, um executando a Worx Provisioning Tool e um restaurado para as configurações de fábrica, seguindo as etapas explicadas neste documento. O modo Proprietário do Dispositivo está disponível somente para dispositivos de propriedade da empresa.

Por que o NFC? Bluetooth, WiFi e outros meios de comunicação estão desativados em um dispositivo que sofreu uma redefinição de fábrica. O NFC é o único protocolo de comunicação que o dispositivo compreende nesse estado.

Para obter uma visão geral da implantação do Android for Work no ambiente XenMobile, consulte Gerenciando dispositivos com o Android for Work no XenMobile.

Pré-requisitos

  • Um servidor XenMobile ativado para o Android for Work – versões 10.1 e 10.3.
  • Um dispositivo com redefinição de fábrica, provisionado para o Android for Work no modo Proprietário do Dispositivo. As etapas para fazer isso são descritas abaixo.
  • Outro dispositivo com recursos NFC executando a Worx Provisioning Tool configurada. A Worx Provisioning Tool está disponível no Worx Home 10.3 ou na página de downloads da Citrix.

Cada dispositivo pode ter somente um perfil do Android for Work, gerenciado por um aplicativo de gerenciamento de mobilidade empresarial (EMM). No XenMobile, o Worx Home é o aplicativo de EMM. Somente um perfil é permitido em cada dispositivo. Tentar adicionar um segundo aplicativo de EMM excluirá o primeiro.

Você pode iniciar o modo Proprietário do Dispositivo em dispositivos para uso imediato ou restaurados para as configurações de fábrica. Você administrará o dispositivo inteiro usando o XenMobile.

Aumento de NFC no modo Proprietário do Dispositivo

Provisionar um dispositivo com redefinição de fábrica requer que você envie os seguintes dados por meio de um aumento de NFC para iniciar o Android for Work:

  • O nome do pacote do aplicativo do provedor EMM que atuará como o Proprietário do Dispositivo (Worx Home).
  • A localização de Intranet/Internet do qual o dispositivo pode baixar o aplicativo do provedor EMM.
  • O hash SHA1 do aplicativo do provedor EMM para verificar se o download foi bem-sucedido.
  • Os detalhes da conexão WiFi para que um dispositivo com redefinição de fábrica possa se conectar e baixar o aplicativo do provedor EMM. (No momento, o Android não é compatível com WiFi 802.1x para esse fluxo).
  • O fuso horário do dispositivo (opcional).
  • A localização geográfica do dispositivo (opcional).

Quando os dois dispositivos são aumentados, os dados da Worx Provisioning Tool são enviados para o dispositivo com redefinição de fábrica. Esses dados são usados para baixar o Worx Home com as configurações do administrador. Se você não inserir os valores de localização e fuso horário, o Android os configurará automaticamente no novo dispositivo.

Configuração da Worx Provisioning Tool

Antes de realizar um aumento de NFC, você deve configurar a Worx Provisioning Tool. Em seguida, essa configuração é transferida para o dispositivo com redefinição de fábrica durante o aumento de NFC.

localized image

Você pode inserir dados nos campos obrigatórios ou preenchê-los usando um arquivo de texto. O aplicativo não salva as informações depois que elas são inseridas, portanto, convém criar um arquivo de texto para manter as informações para uso futuro.

Configuração com um arquivo de texto

Nomeie o arquivo como nfcprovisioning.txt e coloque-o no cartão SD do dispositivo na pasta /sdcard/Downloads. Em seguida, o aplicativo poderá ler o arquivo de texto e preencher os valores.

O arquivo de texto deve conter os seguintes dados:

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION=<localização_de_download>
Esse é o local da Intranet/Internet do aplicativo do provedor EMM. Depois que o dispositivo com redefinição de fábrica se conectar ao WiFi em seguida ao aumento de NFC — usando o SSID, o tipo de segurança e a senha inseridos na tela acima —, ele deverá ter acesso a esse local para fazer o download. A URL é uma URL regular, sem necessidade de formatação especial.

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_CHECKSUM=<hash SHA1>
Essa é a soma de verificação do aplicativo do provedor EMM. Ela é usada para verificar se o download foi bem-sucedido. As etapas para obtê-la são discutidas abaixo.

android.app.extra.PROVISIONING_WIFI_SSID=<SSID do WiFi>
Esse é o SSID WiFi conectado do dispositivo no qual a Worx Provisioning Tool está em execução.

android.app.extra.PROVISIONING_WIFI_SECURITY_TYPE=<tipo de segurança WiFi>
Os valores aceitos são WEP e WPA2. Se o WiFi estiver desprotegido, esse campo deverá estar vazio.

android.app.extra.PROVISIONING_WIFI_PASSWORD=<senha wifi>
Se o WiFi estiver desprotegido, esse campo deverá estar vazio.

android.app.extra.PROVISIONING_LOCALE=<localidade>
Insira os códigos de idioma e país. Os códigos de idioma são códigos de idioma ISO com duas letras minúsculas (por exemplo, en), conforme definido pela ISO 639-1. Os códigos de país são códigos de país ISO com duas letras maiúsculas (por exemplo, US), conforme definido pelo ISO 3166-1. Por exemplo, insira en_US para o inglês falado nos Estados Unidos. Se você não inserir nenhum código, o país e o idioma serão preenchidos automaticamente.

android.app.extra.PROVISIONING_TIME_ZONE=<fuso horário>
O fuso horário no qual o dispositivo está em execução. Insira um nome Olson da área/localização do formulário. Por exemplo, America/Los_Angeles para o horário do Pacífico. Se você não inserir um, o fuso horário será preenchido automaticamente.

android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_NAME=<nome do pacote>
Isso não é necessário, pois o valor é inserido em código fixo no aplicativo, como o Worx Home. Ele é mencionado aqui somente por uma questão de conclusão.

Obtendo a soma de verificação do Worx Home

Para obter a soma de verificação de qualquer aplicativo, adicione o aplicativo como um aplicativo empresarial.

1. No console XenMobile, navegue até Configurar > Aplicativos > Adicionar.

localized image

A janela Adicionar Aplicativo é exibida.

2. Clique em Empresarial.

localized image

A tela Informações do Aplicativo é exibida.

3. Selecione a configuração a seguir e clique em Avançar.

localized image

A tela Aplicativo Empresarial do Android for Work é exibida.

4. Forneça o caminho até o arquivo .apk e clique em Avançar para carregá-lo.

localized image

Depois que a instalação for concluída, você verá os detalhes do pacote carregado.

localized image

5. Clique em Avançar para abrir uma tela para baixar o arquivo JSON, que você usará para carregar no Google Play. Para o Worx Home, não é necessário carregar para Google Play, mas você precisa do arquivo JSON para ler o valor SHA1 dele.

localized image

Um arquivo JSON típico tem esta aparência:

localized image

6. Copie o valor file_sha1_base64 e use-o no campo Hash na Worx Provisioning Tool.Observação: o hash deve ser seguro para URLs.

  • Converta todos os símbolos + em -
  • Converta todos os símbolos / em _
  • Substitua o \u003d à direita por =

O aplicativo realizará a conversão de segurança se você armazenar o hash no arquivo nfcprovisioning.txt no cartão SD do dispositivo. No entanto, se você optar por inserir o hash manualmente, será sua responsabilidade garantir a segurança da URL.

Bibliotecas usadas

A Worx Provisioning Tool faz uso das seguintes bibliotecas no respectivo código-fonte: