Détection du mode Kiosque

Les applications kiosque PWA peuvent implémenter la détection des kiosques ChromeOS à l'aide de l'API Chrome Verified Access. Elle s'appuie sur la technologie existante de l'API Verified Access avec seulement quelques différences clés détaillées dans ce guide.

Prérequis

La procédure de configuration requise pour détecter le mode Kiosque à l'aide de l'API Verified Access est identique à celle décrite dans les conditions préalables à l'utilisation du service Verified Access. Des étapes supplémentaires sont nécessaires pour configurer et lancer votre application kiosque sur l'appareil Chromebook géré.

Dans la console d'administration Google, procédez comme suit:

  • Suivez ce guide pour installer votre application kiosque (étape 1) et ajouter votre extension associée à l'application kiosque (étape 3).
  • Pour l'extension Kiosk Companion, activez le paramètre Autoriser la demande des clés d'entreprise sous Gestion des certificats.

Implémentation

La mise en œuvre de la détection des kiosques avec accès validé repose sur trois composants principaux: une application kiosque PWA, une extension Chrome associée et un service réseau.

Application kiosque PWA

La PWA est votre application kiosque principale. Elle lance le processus de détection du mode Kiosque en envoyant un message à l'extension associée pour l'informer qu'elle doit lancer le processus de validation.

Extension Chrome associée

L'extension Chrome associée s'exécute avec la PWA de kiosque et doit écouter les messages entrants provenant de cette PWA. À la réception du message pour commencer le processus de vérification,

  1. Appeler l'API Verified Access pour créer un test
  2. Appelez l'API enterprise.platformKeys sur le défi généré pour créer un défi-réponse avec une clé utilisateur d'entreprise (utilisateur avec le champ d'application "USER").
  3. Envoyer une requête avec la question "challenge-response" au service réseau pour qu'il soit validé

Pour en savoir plus et obtenir des exemples de code, consultez le guide du développeur.

Assistance Internet

Lorsque votre service réseau reçoit la requête de l'extension pour vérifier la réponse au défi, utilisez la méthode verify. Pour la détection en mode Kiosque, définissez expectedIdentity sur "KIOSK_MODE". Si la requête aboutit, vous devriez voir un corps de réponse d'une chaîne vide ou d'un fichier JSON vide, ce qui signifie que l'appareil est en mode Kiosque. Si l'appareil n'est pas en mode Kiosque, un code 404 est renvoyé dans le corps de la réponse avec le message d'erreur "Requested entity was not found".