KidRoles
Experimentar (abre num novo separador)

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.

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 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:

Valor da política: uma só linha, tal como a cola no Intune, numa GPO e no registo
[{"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://policy ou chrome://policy → «Recarregar políticas» e depois a lista de aplicações 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 terminar a sessão).

Opcional: VideoCaptureAllowedUrls (Edge e Chrome): câmara 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 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_SZ chamado WebAppInstallForceList em HKLM\SOFTWARE\Policies\Microsoft\Edge ou HKLM\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:

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

/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 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:

Edge: uma só página em ecrã inteiro (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: 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.

Chrome: KidRoles em ecrã inteiro
# 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).

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 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 é adicionar shop.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/pulse na 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

← Voltar ao início