KidRoles para o departamento de TI
Tudo o que um administrador precisa para instalar o KidRoles: Loja nos computadores de uma escola, de uma escola de educação infantil ou de uma brinquedoteca: sem instalador, sem conta e sem coleta de dados das crianças.
Instalação forçada: WebAppInstallForceList
O Microsoft Edge e o Google Chrome instalam o app em segundo plano, sem ação do usuário, assim que configurar a política WebAppInstallForceList. O usuário não a pode desativar nem desinstalar o app. 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": o app abre na sua própria janela, não numa aba."create_desktop_shortcut": true: um atalho no desktop (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 apps 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 encerrar 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 configuraçõ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 configuraçõ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”.
- Registro (sem domínio nem MDM): um valor
REG_SZchamadoWebAppInstallForceListemHKLM\SOFTWARE\Policies\Microsoft\EdgeouHKLM\SOFTWARE\Policies\Google\Chrome.
Google Workspace e Chromebooks: na console de administração da Google, vá para Dispositivos → Chrome → Aplicativos e extensões → Usuários e navegadores, adicione o app 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 arquivos 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 produtos, as moedas e o histórico desaparecem, e o app precisa de internet em cada inicialização.
Para o jogo diário, recomendamos por isso a instalação normal (a política acima) numa conta compartilhada 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: tela inteira 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 Configurações → Contas → Outros usuários → “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
O app 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 uso anônimo (ver o ponto abaixo). A única exceção: uma sugestão opcional de nomes de produtos, desativada por padrã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 salva o app (service worker). Depois, o caixa funciona sem internet e baixa as atualizações quando há rede.
- Parear um celular como leitor liga o caixa e o celular 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 salva. - Um proxy com inspeção TLS deve deixar passar os links 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 pareamento deixa de funcionar. - O celular não é indispensável: a câmera do computador ou do tablet também lê os códigos (botão “Leitor” na Loja).
- Contador de uso anônimo: o app envia ao mesmo host de onde é carregado um pedido curto
POST https://shop.kidroles.com/api/pulse: ao iniciar, ao voltar à janela e a cada poucos minutos enquanto estiver visível. Contém contadores anônimos: a versão do app, o tipo de instalação, o idioma, o canal, o layout da tela, 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 em um desses pedidos ao ocultar ou fechar a janela. Está ativado por padrão; desativa-se em Configurações → Geral com “Enviar estatísticas de uso anônimas” (ao desativar, o app envia um último sinal sobre o próprio interruptor, sem outros dados). Bloquear/api/pulsena firewall também é inofensivo: o app 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 Configurações → Leitor “Sugerir nomes a partir da internet (modo pais)”. Quando se adiciona um produto depois de ler o seu código, o app 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 do app funciona normalmente.
Dados e privacidade
- Sem conta nem login: as crianças não digitam nome nem e-mail; um caixa é um emoji ou uma foto salva no próprio aparelho.
- Os dados do app ficam no armazenamento do navegador (
localStorage), no perfil do usuário deste computador. Os caixas, o catálogo e o histórico não são salvos no nosso servidor; o app não tem publicidade nem rastreamento. Fora das funções da seção “Rede e firewall” (pareamento, opinião, sugestão opcional de nomes), envia apenas um contador de uso anônimo, desativável em Configurações → Geral. - Cada perfil do navegador e cada conta do sistema é uma loja distinta. No computador compartilhado de um grupo, basta uma só conta: as crianças têm os seus próprios caixas no app.
Estas configurações apagam os dados do app: 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 produtos sobrevivem a um reinício.
Um catálogo para toda a instituição: no modo de edição, “Salvar o catálogo” salva os produtos num arquivo 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