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.
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.
Associer un compte sans contact à une entreprise
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.
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.
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