iframe sem toque

Com o iframe sem toque, você pode incorporar o registro sem toque diretamente ao seu console de EMM para permitir que os clientes configurem facilmente dispositivos sem toque com seu DPC. O iframe permite configurar o DPC e o provisionamento de extras usados durante a configuração do dispositivo sem toque.

iframe sem toque
Figura 1. O iframe sem toque mostrando a página inicial sem toque.

Na primeira vez que um administrador de TI abrir o iframe, ele receberá uma solicitação para vincular a conta sem toque à empresa dele.

Quando um administrador de TI vincula uma conta sem toque à empresa, o iframe exibirá a lista de contas sem toque vinculadas. Eles também podem conferir a configuração padrão do registro sem toque definida para dispositivos corporativos.


Recursos

Esta seção descreve os recursos disponíveis no iframe sem toque. Para saber mais sobre como incorporar o iframe e implementar esses recursos, consulte Adicionar o iframe ao seu console.

O iframe permite que um administrador de TI vincule a conta sem toque à empresa. Como parte desse processo, o administrador de TI cria um perfil padrão sem toque a ser usado para dispositivos dentro da conta sem toque. Esse fluxo está detalhado abaixo.

Se o administrador de TI não tiver vinculado uma conta sem toque à empresa, ele será solicitado a fazer isso quando abrir o iframe.

O administrador de TI vê uma lista de contas sem toque e pode escolher uma ou mais para vincular à empresa.

Tela de lista de contas do iframe sem toque
Figura 3. Tela da lista de contas
Tela de configuração do iframe sem toque
Figura 4. Tela de configuração

O iframe sem toque gera automaticamente uma configuração sem toque. Essa configuração não pode ser modificada pelo administrador de TI. É possível personalizar o DPC ou os extras de provisionamento a serem usados nessa configuração. Para mais informações sobre como fazer isso, consulte Parâmetros de URL do iframe.

tela de informações sobre o suporte do iframe sem toque
Figura 5. Tela de entrada de informações de suporte

O administrador de TI insere informações de suporte que aparecem quando os dispositivos com o recurso sem toque são configurados. Quando o administrador de TI clica em "Salvar", o processo de vinculação é concluído e o usuário é redirecionado para a página inicial do iframe sem toque, onde pode gerenciar as contas vinculadas.

Acessar e gerenciar contas sem toque vinculadas

O iframe permite que um administrador de TI confira as contas sem toque vinculadas e o perfil sem toque padrão e as informações de suporte. Além disso, eles podem vincular outras contas sem toque e desvincular contas sem toque.

Veja na Figura 1 um exemplo da página inicial do iframe sem toque.

Visualização de dispositivos de contas vinculadas no portal de registro sem toque

Quando uma conta sem toque é vinculada a uma empresa, todos os dispositivos dessa conta que não estão configurados com um perfil sem toque são configurados automaticamente com o perfil sem toque empresarial.

Dentro do console de registro sem toque, esses dispositivos são mostrados com a configuração "Perfil padrão da empresa". O administrador de TI pode definir e cancelar a definição do perfil em qualquer dispositivo na conta sem toque. No entanto, não é possível modificar o perfil.

Se a conta sem toque for desvinculada, todos os dispositivos configurados com o "Perfil padrão da empresa" terão esse perfil definido. Esses dispositivos podem ser configurados com um perfil diferente.


Adicionar o iframe ao seu console

Etapa 1: gerar um token da Web

Para gerar um token da Web que identifique a empresa, chame Enterprises.createWebToken. O exemplo a seguir mostra como recuperar o token usando a biblioteca de cliente da API Google Play EMM para Java. O iframe sem toque precisa ser ativado separadamente do iframe do Google Play gerenciado.

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setZeroTouch(new AdministratorWebTokenSpecZeroTouch());
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

É necessário incluir o token retornado, junto com outros parâmetros, ao renderizar o iframe no console.

Etapa 2: renderizar o iframe

Confira um exemplo de como renderizar o iframe sem toque:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=web_token&dpcId=com.example.app',,
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Esse código gera um iframe dentro do div do contêiner. Os atributos a serem aplicados à tag de iframe podem ser definidos com a opção "attributes", como mostrado acima.

Parâmetros de URL de iframe

A tabela abaixo lista todos os parâmetros disponíveis para o iframe que podem ser adicionados ao URL como parâmetros de URL, por exemplo:

https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.afwsamples.testdpc
Parâmetro Obrigatório Descrição
token Sim O token retornado da Etapa 1.
dpcId Sim O nome do pacote do app do DPC, ou seja, com.example.app. É necessário definir essa opção. O DPC já precisa estar associado ao seu EMM.
dpcExtras Não Objeto JSON codificado em URL que contém extras de provisionamento. Eles são transmitidos para o DPC durante a configuração do dispositivo.

Exemplo de URL, supondo que:

  • Token da Web da API: abcde
  • DPC: com.example
  • Extras do DPC: {“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras={“server”:“www.example.com”,“enterprise”:”example_id”}

codificado, o URL será:

https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras=%7B%E2%80%9Cserver%E2%80%9D%3A%E2%80%9Cwww.example.com%E2%80%9D%2C%E2%80%9Centerprise%E2%80%9D%3A%E2%80%9Dexample_id%E2%80%9D%7D