Iframe de Zero-touch

Con el iframe de inscripción automática, puedes incorporar la inscripción automática directamente en tu consola de EMM para permitir que los clientes configuren fácilmente los dispositivos habilitados para la inscripción automática con Android Device Policy. El iframe te permite establecer los elementos adicionales de aprovisionamiento que se usan durante la configuración del dispositivo de inscripción automática.

iframe de inscripción automática
Figura 1: El iframe de inscripción automática muestra la página principal de inscripción automática.

La primera vez que un administrador de TI abra el iframe, se le solicitará que vincule su cuenta de inscripción automática a su empresa.

Una vez que un administrador de TI haya vinculado una cuenta de inscripción automática a su empresa, el iframe mostrará la lista de cuentas de inscripción automática vinculadas. También puede ver la configuración de inscripción automática predeterminada para dispositivos empresariales.


Atributos

En esta sección, se describen las funciones disponibles en el iframe de inscripción automática. Si deseas obtener información para incorporar el iframe e implementar estas funciones, consulta Agrega el iframe a tu consola.

El iframe permite que un administrador de TI vincule su cuenta de inscripción automática y su empresa. Como parte de este proceso, el administrador de TI crea un perfil de inscripción automática predeterminado para usar con los dispositivos dentro de la cuenta de inscripción automática. Este flujo se detalla a continuación.

Si el administrador de TI no vinculó anteriormente una cuenta de inscripción automática a su empresa, se le solicitará que lo haga cuando abra el iframe.

El administrador de TI ve una lista de cuentas de inscripción automática y puede elegir una o más para vincularlas a su empresa.

Pantalla de lista de cuentas de iframe de inscripción automática
Figura 3: Pantalla de lista de cuentas
Pantalla de configuración de iframe de inscripción automática
Figura 4: Pantalla de configuración

El iframe de inscripción automática genera una configuración de inscripción automática automáticamente. El administrador de TI no puede modificar esta configuración. Puedes personalizar los elementos adicionales de aprovisionamiento que se usarán en esta configuración. Para obtener más información sobre cómo hacerlo, consulta Parámetros de URL de iframe.

Pantalla de información de compatibilidad con iframe de inscripción automática
Figura 5: Pantalla de entrada de información de asistencia

El administrador de TI ingresa información de asistencia que aparece cuando se configuran dispositivos habilitados para la inscripción automática. Cuando el administrador de TI hace clic en "Guardar", se completa el proceso de vinculación y se redirecciona al usuario a la página principal del iframe de inscripción automática, donde puede administrar sus cuentas vinculadas.

Ver y administrar cuentas de inscripción automática vinculadas

El iframe permite que un administrador de TI vea sus cuentas de inscripción automática vinculadas y su perfil predeterminado y la información de asistencia. Además, pueden vincular cuentas de inscripción automática adicionales y desvincular cuentas de inscripción automática.

Consulta la Figura 1 para ver una vista de ejemplo de la página principal de iframe de inscripción automática.

Visualización de dispositivos de cuentas vinculadas en el portal de inscripción automática

Cuando una cuenta de inscripción automática se vincula a una empresa, todos los dispositivos de la cuenta de inscripción automática que no están configurados con un perfil de inscripción automática se configuran automáticamente con el perfil de inscripción automática empresarial.

Dentro de la consola de inscripción automática, estos dispositivos se muestran con la configuración “Perfil predeterminado de empresa”. El administrador de TI puede configurar y desactivar este perfil en cualquier dispositivo de la cuenta de inscripción automática. Sin embargo, el perfil no se puede modificar.

Si se desvincula la cuenta de inscripción automática, este perfil se desactivará en todos los dispositivos configurados con el “Perfil predeterminado para empresas”. Estos dispositivos se pueden configurar con un perfil diferente.


Agrega el iframe a tu consola

Paso 1: Genera un token web

Llama a enterprises.webTokens.create para generar un token web que identifique a la empresa. La respuesta contiene el value del token.

  • Establece parentFrameUrl en la URL del marco superior que aloja el iframe.
  • Usa iframeFeature para especificar qué funciones habilitar en el iframe: "ZERO_TOUCH". Si iframeFeature no está configurado, el iframe habilita todas las funciones de forma predeterminada.

Debes incluir el token que se muestra, junto con otros parámetros, cuando renderices el iframe en tu consola.

Paso 2: Renderiza el iframe

Este es un ejemplo de cómo renderizar el iframe de inscripción automática:

<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>

Este código genera un iframe dentro del div del contenedor. Los atributos que se aplicarán a la etiqueta de iframe se pueden configurar con la opción "Attributes", como se indicó anteriormente.

Parámetros de URL de iframe

En la siguiente tabla, se enumeran todos los parámetros disponibles para el iframe que se pueden agregar a la URL como parámetros de URL, p.ej.:

https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.google.android.apps.work.clouddpc
Parámetro Obligatorias Descripción
token El token que se muestra en el Paso 1.
dpcId Es el nombre del paquete de la app de DPC. Siempre debes establecerlo con el ID de Android Device Policy, com.google.android.apps.work.clouddpc.
dpcExtras No Objeto JSON con codificación URL que contiene elementos adicionales de aprovisionamiento. Estos se pasan al DPC durante la configuración del dispositivo.

URL de ejemplo, suponiendo lo siguiente:

  • Token web de la API: abcde
  • DPC: com.google.android.apps.work.clouddpc
  • Adicionales del 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”}

URL codificada, esta sería la siguiente:

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