iFrame sans contact

L'iFrame sans contact vous permet de l'intégrer directement dans votre console EMM pour permettre aux clients de configurer facilement des appareils compatibles sans contact avec votre DPC. L'iFrame vous permet de configurer le DPC et les extras de provisionnement utilisés lors de la configuration de l'appareil sans contact.

iFrame sans contact
Figure 1. L'iFrame sans contact affichant la page d'accueil sans contact.

La première fois qu'un administrateur informatique ouvre l'iFrame, il est invité à associer son compte sans contact à son entreprise.

Une fois qu'un administrateur informatique a associé un compte sans contact à son entreprise, l'iFrame affiche la liste des comptes sans contact associés. Ils peuvent également voir l'ensemble de configuration sans contact par défaut pour les appareils d'entreprise.


Fonctionnalités

Cette section décrit les fonctionnalités disponibles dans l'iFrame sans contact. Pour savoir comment intégrer l'iFrame et implémenter ces fonctionnalités, consultez Ajouter l'iFrame à votre console.

L'iFrame permet à un administrateur informatique d'associer son compte sans contact à son entreprise. Dans le cadre de ce processus, l'administrateur informatique crée un profil sans contact par défaut à utiliser pour les appareils du compte sans contact. Ce flux est détaillé ci-dessous.

Si l'administrateur informatique n'a pas déjà associé de compte sans contact à son entreprise, il est invité à le faire lorsqu'il ouvre l'iFrame.

L'administrateur informatique voit une liste de comptes sans contact et peut choisir un ou plusieurs comptes à associer à son entreprise.

Écran de la liste des comptes iFrame sans contact
Figure 3. Écran de la liste des comptes
Écran de configuration iFrame sans contact
Figure 4. Écran de configuration

L'iFrame sans contact génère automatiquement une configuration sans contact. Cette configuration ne peut pas être modifiée par l'administrateur informatique. Vous pouvez personnaliser le DPC ou les extras de provisionnement à utiliser dans cette configuration. Pour savoir comment procéder, consultez la section Paramètres d'URL iFrame.

Écran d'informations sur la compatibilité des cadres iFrame sans contact
Figure 5. Écran de saisie des informations d'assistance

L'administrateur informatique saisit les informations d'assistance qui s'affichent lors de la configuration des appareils compatibles avec l'enregistrement sans contact. Lorsque l'administrateur informatique clique sur "Enregistrer", le processus d'association se termine et l'utilisateur est redirigé vers la page d'accueil de l'iFrame sans contact, où il peut gérer ses comptes associés.

Afficher et gérer les comptes sans contact associés

L'iFrame permet à un administrateur informatique d'afficher les comptes sans contact associés, ainsi que leur profil sans contact par défaut et leurs informations d'assistance. En outre, ils peuvent associer des comptes sans contact supplémentaires et dissocier des comptes sans contact.

Reportez-vous à la figure 1 pour voir un exemple de page d'accueil d'un iFrame sans contact.

Afficher les appareils des comptes associés sur le portail sans contact

Lorsqu'un compte sans contact est associé à une entreprise, tous les appareils du compte sans contact qui ne sont pas configurés avec un profil sans contact sont automatiquement configurés avec le profil sans contact Enterprise.

Dans la console sans contact, ces appareils affichent la configuration "Profil par défaut de l'entreprise". L'administrateur informatique peut définir et désactiver ce profil sur n'importe quel appareil du compte sans contact. Cependant, le profil ne peut pas être modifié.

Si le compte sans contact est dissocié, ce profil n'est pas défini sur tous les appareils configurés avec le "Profil par défaut de l'entreprise". Ces appareils peuvent être configurés avec un profil différent.


Ajouter l'iFrame à votre console

Étape 1: Générez un jeton Web

Pour générer un jeton Web qui identifie l'entreprise, appelez Enterprises.createWebToken. L'exemple suivant montre comment récupérer le jeton à l'aide de la bibliothèque cliente de l'API EMM Google Play pour Java. Notez que l'iFrame sans contact doit être activé séparément de l'iFrame Google Play d'entreprise.

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();
}

Vous devez inclure le jeton renvoyé ainsi que d'autres paramètres lors de l'affichage de l'iFrame dans votre console.

Étape 2: Affichez l'iFrame

Voici un exemple d'affichage de l'iFrame sans contact:

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

Ce code génère un iFrame à l'intérieur du tag div du conteneur. Les attributs à appliquer au tag iFrame peuvent être définis à l'aide de l'option "attributes", comme ci-dessus.

Paramètres d'URL iFrame

Le tableau ci-dessous liste tous les paramètres disponibles pour l'iFrame qui peuvent être ajoutés à l'URL en tant que paramètres d'URL.Exemples:

https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.afwsamples.testdpc
Paramètres Obligatoire Description
token Oui Jeton renvoyé par l'étape 1.
dpcId Oui Nom du package de l'application DPC, par exemple com.example.app. Veuillez définir ce paramètre. L'outil de contrôle des règles relatives aux appareils doit déjà être associé à votre EMM.
dpcExtras Non Objet JSON encodé au format URL contenant des extras de provisionnement. Ils sont transmis au DPC lors de la configuration de l'appareil.

Exemple d'URL, en supposant que:

  • Jeton Web de l'API: abcde
  • DPC: com.example
  • Options DPC supplémentaires: {“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”}

URL encodée, elle se présentera comme suit:

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