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 com esse recurso ativado com o Android Device Policy. O iframe permite definir os extras de provisionamento usados durante a configuração do dispositivo 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.
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.
O administrador de TI vê uma lista de contas sem toque e pode escolher uma ou mais para vincular à empresa.
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 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.
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
Chame enterprises.webTokens.create
para gerar um token da Web que identifique a empresa. A resposta contém o value
do token.
- Defina
parentFrameUrl
como o URL do frame pai que hospeda o iframe. - Use
iframeFeature
para especificar quais recursos serão ativados no iframe: "ZERO_TOUCH". SeiframeFeature
não estiver definido, o iframe ativará todos os recursos por padrão.
É 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.google.android.apps.work.clouddpc',
'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.google.android.apps.work.clouddpc
Parâmetro | Obrigatório | Descrição |
---|---|---|
token |
Sim | O token retornado da Etapa 1. |
dpcId |
Sim | O nome do pacote do app do DPC. Defina sempre como o ID do Android Device Policy, com.google.android.apps.work.clouddpc .
|
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.google.android.apps.work.clouddpc
- Extras do DPC:
{“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.google.android.apps.work.clouddpc&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.google.android.apps.work.clouddpc&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