KidRoles para o departamento de TI
Tudo o que um administrador precisa para instalar o KidRoles: Loja nos computadores de uma escola, de um jardim de infância ou de uma ludoteca: sem instalador, sem conta e sem recolha de dados das crianças.
Instalação forçada: WebAppInstallForceList
O Microsoft Edge e o Google Chrome instalam a aplicação em segundo plano, sem ação do utilizador, assim que configurar a política WebAppInstallForceList. O utilizador não a pode desativar nem desinstalar a aplicação. O mesmo valor serve para os dois navegadores:
[{"url":"https://shop.kidroles.com/","default_launch_container":"window","create_desktop_shortcut":true}]"default_launch_container": "window": a aplicação abre na sua própria janela, não num separador."create_desktop_shortcut": true: um atalho no ambiente de trabalho (Windows e Linux).- O endereço da política deve ser o endereço final, sem redirecionamento: use exatamente
https://shop.kidroles.com/. - Verificação no computador:
edge://policyouchrome://policy→ «Recarregar políticas» e depois a lista de aplicações emedge://apps/chrome://apps.
O Edge não aplica esta política a perfis iniciados com uma conta Microsoft pessoal: é preciso um perfil profissional/escolar ou local. Além disso, a Microsoft não suporta as PWA do Edge em ambientes FSLogix (desaparecem ao terminar a sessão).
https://shop.kidroles.com/Windows: Intune e políticas de grupo (GPO)
- Intune, Edge: Dispositivos → Configuração → nova política para Windows 10 e posteriores, tipo «Catálogo de definições». Na categoria Microsoft Edge, adicione «Configure list of force-installed Web Apps», ative-a e cole o valor.
- Intune, Chrome: no mesmo catálogo de definições, a categoria Google Chrome oferece a mesma definição; não é preciso importar modelos ADMX.
- GPO, Edge: depois de adicionar os modelos administrativos do Edge (
MSEdge.admx): Modelos administrativos → Microsoft Edge → «Configure list of force-installed Web Apps». - GPO, Chrome: depois de adicionar os modelos do Chrome: Modelos administrativos → Google → Google Chrome → «Configure list of force-installed web apps».
- Registo (sem domínio nem MDM): um valor
REG_SZchamadoWebAppInstallForceListemHKLM\SOFTWARE\Policies\Microsoft\EdgeouHKLM\SOFTWARE\Policies\Google\Chrome.
Google Workspace e Chromebooks: na consola de administração da Google, vá a Dispositivos → Chrome → Aplicações e extensões → Utilizadores e navegadores, adicione a aplicação por URL e escolha a instalação forçada. O KidRoles chega assim também aos Chromebooks.
macOS e Linux
macOS: adicione a chave WebAppInstallForceList a um perfil de configuração do seu MDM (por exemplo Intune ou Jamf), no domínio com.microsoft.Edge ou com.google.Chrome:
<key>WebAppInstallForceList</key>
<array>
<dict>
<key>url</key>
<string>https://shop.kidroles.com/</string>
<key>default_launch_container</key>
<string>window</string>
</dict>
</array>Linux: o Chrome lê as políticas em ficheiros JSON colocados em /etc/opt/chrome/policies/managed/. A Microsoft não conta o Linux entre as plataformas desta política do Edge: use lá o Chrome.
{
"WebAppInstallForceList": [
{
"url": "https://shop.kidroles.com/",
"default_launch_container": "window",
"create_desktop_shortcut": true
}
]
}Modo quiosque
Atenção aos dados: o modo quiosque do Microsoft Edge (incluindo um quiosque Windows de acesso atribuído com o Edge) funciona numa sessão InPrivate. Ao fechar o navegador ou ao repor por inatividade, os caixas, os artigos, as moedas e o histórico desaparecem, e a aplicação precisa de internet em cada arranque.
Para o jogo diário, recomendamos por isso a instalação normal (a política acima) numa conta partilhada do computador. O quiosque do Edge serve para uma demonstração ou um dia de portas abertas, quando cada sessão deve começar do zero:
msedge.exe --kiosk https://shop.kidroles.com/ --edge-kiosk-type=fullscreen --no-first-runUm quiosque que conserva os dados é o Chrome iniciado com --kiosk num perfil normal: ecrã inteiro sem barra de endereços, e os dados são mantidos entre reinícios. Feche primeiro as outras janelas do Chrome: o parâmetro só se aplica quando o navegador reinicia.
# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --kiosk https://shop.kidroles.com/
# macOS
open -na "Google Chrome" --args --kiosk https://shop.kidroles.com/
# Linux
google-chrome --kiosk https://shop.kidroles.com/O quiosque do Windows configura-se em Definições → Contas → Outros utilizadores → «Configurar um quiosque», no Intune ou com o comando PowerShell Set-AssignedAccess. Com o Edge, funciona no modo quiosque do Edge: aplica-se o mesmo aviso sobre o InPrivate.
Rede e firewall
A aplicação liga-se a um único endereço e não carrega nada de outros domínios: nem CDN, nem Google Fonts, nem publicidade. É para esse mesmo endereço que envia também um contador de utilização anónimo (ver o ponto abaixo). A única exceção: uma sugestão opcional de nomes de artigos, desativada por omissão (último ponto).
https://shop.kidroles.com/ (HTTPS, 443)
wss://shop.kidroles.com/pair (WebSocket, 443)- Na primeira abertura, a internet é necessária: é aí que o navegador guarda a aplicação (service worker). Depois, a caixa funciona sem internet e descarrega as atualizações quando há rede.
- Emparelhar um telemóvel como leitor liga a caixa e o telemóvel pelo WebSocket
wss://shop.kidroles.com/pair. Os dois aparelhos precisam de internet, mas não necessariamente da mesma rede wi-fi. O servidor limita-se a transmitir os códigos lidos de um para o outro e não os guarda. - Um proxy com inspeção TLS deve deixar passar as ligações WebSocket (cabeçalho
Upgrade) para este endereço; o mais simples é adicionarshop.kidroles.comàs exceções da inspeção. Se o WebSocket for bloqueado, só o emparelhamento deixa de funcionar. - O telemóvel não é indispensável: a câmara do computador ou do tablet também lê os códigos (botão «Leitor» na Loja).
- Contador de utilização anónimo: a aplicação envia ao mesmo anfitrião de onde é carregada um pedido curto
POST https://shop.kidroles.com/api/pulse: ao arrancar, ao voltar à janela e de poucos em poucos minutos enquanto estiver visível. Contém contadores anónimos: a versão da aplicação, o tipo de instalação, o idioma, o canal, a disposição do ecrã, a vista aberta, quantas vezes as funções foram usadas (p. ex. uma venda, uma leitura de código) e se ocorreu um erro (só o tipo), sem identificador, sem dados das crianças, dos caixas ou do catálogo e sem valores. Os últimos contadores seguem num desses pedidos ao ocultar ou fechar a janela. Está ativado por omissão; desativa-se em Definições → Geral com «Enviar estatísticas de utilização anónimas» (ao desativar, a aplicação envia um último sinal sobre o próprio interruptor, sem outros dados). Bloquear/api/pulsena firewall também é inofensivo: a aplicação não espera resposta e funciona da mesma forma. Detalhes: política de privacidade. - Opcional:
https://world.openfoodfacts.org(HTTPS, 443): apenas se um adulto ativar em Definições → Leitor «Sugerir nomes a partir da internet (modo pais)». Quando se adiciona um artigo depois de ler o seu código, a aplicação envia para lá apenas o código e obtém o nome da base Open Food Facts. Se o endereço estiver bloqueado, o nome escreve-se à mão; o resto da aplicação funciona normalmente.
Dados e privacidade
- Sem conta nem início de sessão: as crianças não introduzem nome nem e-mail; um caixa é um emoji ou uma fotografia guardada no próprio aparelho.
- Os dados da aplicação ficam no armazenamento do navegador (
localStorage), no perfil do utilizador deste computador. Os caixas, o catálogo e o histórico não são guardados no nosso servidor; a aplicação não tem publicidade nem rastreio. Fora das funções da secção «Rede e firewall» (emparelhamento, opinião, sugestão opcional de nomes), envia apenas um contador de utilização anónimo, desativável em Definições → Geral. - Cada perfil do navegador e cada conta do sistema é uma loja distinta. No computador partilhado de um grupo, basta uma só conta: as crianças têm os seus próprios caixas na aplicação.
Estas definições apagam os dados da aplicação: ClearBrowsingDataOnExit (Edge), ClearBrowsingDataOnExitList (Chrome), BrowsingDataLifetime com o tipo cookies_and_other_site_data (Edge e Chrome), ForceEphemeralProfiles, os cookies «apenas durante a sessão» (DefaultCookiesSetting = 4), bem como as contas de convidado e os perfis temporários. Não as aplique aos computadores com o KidRoles, ou verifique num deles que os caixas e os artigos sobrevivem a um reinício.
Um catálogo para todo o estabelecimento: no modo de edição, «Guardar o catálogo» guarda os artigos num ficheiro que carrega nos outros computadores («Carregar o catálogo»).
Fontes: documentação da Microsoft, da Google e da Apple
- Microsoft Edge — WebAppInstallForceList
- Microsoft Edge — VideoCaptureAllowedUrls
- Microsoft Edge — ClearBrowsingDataOnExit
- Microsoft Edge — BrowsingDataLifetime
- Microsoft Edge — kiosk mode
- Microsoft Edge — PWA: install, manage, uninstall
- Windows — single-app kiosk (Assigned Access)
- Intune — settings catalog
- Google Chrome Enterprise — automatically install web apps
- Google Chrome Enterprise — BrowsingDataLifetime, ClearBrowsingDataOnExitList
- Google Chrome — use web apps
- Apple — use Safari web apps on Mac