KidRoles
Experimentar (abre em uma nova aba)

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.

Instruções verificadas com a documentação da Microsoft, da Google e da Apple: 2026-10-10

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:

Valor da política: uma só linha, tal como a cola no Intune, numa GPO e no registro
[{"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://policy ou chrome://policy → “Recarregar políticas” e depois a lista de apps em edge://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).

Opcional: VideoCaptureAllowedUrls (Edge e Chrome): câmera para ler códigos sem pedido de autorizaçã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_SZ chamado WebAppInstallForceList em HKLM\SOFTWARE\Policies\Microsoft\Edge ou HKLM\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:

Excerto do perfil de configuração (plist)
<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.

/etc/opt/chrome/policies/managed/kidroles.json
{
  "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:

Edge: uma só página em tela inteira (Windows)
msedge.exe --kiosk https://shop.kidroles.com/ --edge-kiosk-type=fullscreen --no-first-run

Um 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.

Chrome: KidRoles em tela inteira
# 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).

Endereços a autorizar (porta 443)
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 é adicionar shop.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/pulse na 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

← Voltar ao início