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](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-home.png?authuser=6&hl=pt-br)
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.
Vincular uma conta sem toque a uma empresa
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.
![Fluxo de vinculação do iframe sem toque](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-link.png?authuser=6&hl=pt-br)
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](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-choose-accounts.png?authuser=6&hl=pt-br)
![Tela de configuração do iframe sem toque](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-show-dpc.png?authuser=6&hl=pt-br)
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](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-support-info.png?authuser=6&hl=pt-br)
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