Detecção do modo quiosque

Os aplicativos de quiosque de PWA podem implementar a detecção de quiosque do ChromeOS com a API Verified Access do Chrome. Ele se baseia na tecnologia atual da API Verified Access, com apenas algumas diferenças importantes detalhadas neste guia.

Configuração

As etapas de configuração necessárias para usar a API Verified Access para fazer a detecção no modo quiosque são as mesmas listadas nos pré-requisitos do acesso verificado. Existem algumas etapas adicionais para configurar e iniciar seu aplicativo de quiosque no dispositivo Chromebook gerenciado.

No Google Admin Console, faça o seguinte:

  • Siga este guia para instalar seu aplicativo de quiosque (etapa 1) e adicionar a extensão complementar ao aplicativo de quiosque (etapa 3).
  • Para a extensão complementar de quiosque, ative a configuração Permitir desafio empresarial em Gerenciamento de certificados

Implementação

Há três componentes principais para implementar a detecção de quiosque do "Acesso verificado": um aplicativo de quiosque de PWA, uma extensão complementar do Chrome e um serviço de rede.

Aplicativo de quiosque PWA

O PWA é seu aplicativo de quiosque principal. Ele inicia o processo de detecção do modo de quiosque enviando uma mensagem para a extensão complementar, informando que o processo de verificação foi iniciado.

Extensão complementar do Chrome

A extensão complementar do Chrome é executada com o PWA de quiosque e detecta as mensagens recebidas do PWA. Ao receber a mensagem para iniciar o processo de verificação,

  1. Chamar a API Verified Access para criar um desafio
  2. Chamar a API enterprise.platformKeys no desafio gerado para criar uma resposta de desafio com uma chave de usuário empresarial (usar o escopo "USER" para o usuário)
  3. Envie uma solicitação com a resposta de desafio ao serviço de rede a ser verificado.

Consulte o guia para desenvolvedores para mais informações e exemplos de código.

Serviço de rede

Quando seu serviço de rede receber a solicitação da extensão para verificar a resposta do desafio, use o método verify. Para a detecção do modo quiosque, defina expectedIdentity como "KIOSK_MODE". Se tudo der certo, você vai ver um corpo de resposta com uma string vazia ou um JSON vazio, o que significa que o dispositivo está no modo quiosque. Se o dispositivo não estiver no modo quiosque, um código 404 será retornado no corpo da resposta com a mensagem de erro "Requested entity was not found".