KidRoles dla działu IT placówki

Wszystko, czego potrzebuje administrator, żeby zainstalować KidRoles: Sklep na komputerach szkoły, przedszkola albo świetlicy — bez instalatora, bez kont i bez zbierania danych dzieci.

Instrukcje sprawdzone z dokumentacją Microsoft, Google i Apple: 2026-10-10

Wymuszona instalacja: WebAppInstallForceList

Microsoft Edge i Google Chrome instalują aplikację w tle, bez udziału użytkownika, gdy ustawisz politykę WebAppInstallForceList. Użytkownik nie może jej wyłączyć ani odinstalować aplikacji. Ta sama wartość działa w obu przeglądarkach:

Wartość polityki — jedna linia, tak wklejasz ją w Intune, GPO i rejestrze

[{"url":"https://shop.kidroles.com/","default_launch_container":"window","create_desktop_shortcut":true}]

"default_launch_container": "window" — aplikacja otwiera się we własnym oknie, nie w karcie.
"create_desktop_shortcut": true — skrót na pulpicie (Windows i Linux).
Adres w polityce musi być końcowy, bez przekierowań — wpisz dokładnie https://shop.kidroles.com/.
Sprawdzenie na komputerze: edge://policy albo chrome://policy → „Załaduj ponownie zasady”, potem lista aplikacji w edge://apps / chrome://apps.

Edge nie stosuje tej polityki w profilach zalogowanych prywatnym kontem Microsoft — potrzebny jest profil służbowy/szkolny albo lokalny. Microsoft nie obsługuje też aplikacji PWA w Edge w środowiskach FSLogix (znikają po wylogowaniu).

Opcjonalnie: VideoCaptureAllowedUrls (Edge i Chrome) — kamera do skanowania kodów bez pytania o zgodę

https://shop.kidroles.com/

Windows: Intune i zasady grupy (GPO)

Intune — Edge: Urządzenia → Konfiguracja → nowa zasada dla Windows 10 i nowszych, typ „Wykaz ustawień”. Z kategorii Microsoft Edge dodaj „Configure list of force-installed Web Apps”, włącz je i wklej wartość polityki.
Intune — Chrome: w tym samym wykazie ustawień kategoria Google Chrome ma to samo ustawienie; import szablonów ADMX nie jest potrzebny.
GPO — Edge: po dodaniu szablonów administracyjnych Edge (MSEdge.admx): Szablony administracyjne → Microsoft Edge → „Configure list of force-installed Web Apps”.
GPO — Chrome: po dodaniu szablonów Chrome: Szablony administracyjne → Google → Google Chrome → „Configure list of force-installed web apps”.
Rejestr (komputer bez domeny i MDM): wartość REG_SZ o nazwie WebAppInstallForceList w kluczu HKLM\SOFTWARE\Policies\Microsoft\Edge albo HKLM\SOFTWARE\Policies\Google\Chrome.

Google Workspace i Chromebooki: w konsoli administracyjnej Google wybierz Urządzenia → Chrome → Aplikacje i rozszerzenia → Użytkownicy i przeglądarki, dodaj aplikację z adresu URL i ustaw wymuszoną instalację. Tak samo KidRoles trafi na Chromebooki.

macOS i Linux

macOS: dodaj klucz WebAppInstallForceList do profilu konfiguracyjnego w MDM (np. Intune albo Jamf), w domenie com.microsoft.Edge albo com.google.Chrome:

Fragment profilu konfiguracyjnego (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: Chrome czyta polityki z plików JSON w katalogu /etc/opt/chrome/policies/managed/. Microsoft nie wymienia Linuksa wśród platform tej polityki w Edge — tam użyj Chrome.

/etc/opt/chrome/policies/managed/kidroles.json

{
  "WebAppInstallForceList": [
    {
      "url": "https://shop.kidroles.com/",
      "default_launch_container": "window",
      "create_desktop_shortcut": true
    }
  ]
}

Tryb kiosku

Uwaga na dane: tryb kiosku Microsoft Edge — także kiosk Windows („Przypisany dostęp”) z Edge — działa w sesji InPrivate. Po zamknięciu przeglądarki albo resecie po bezczynności znikają kasjerzy, produkty, monety i historia, a aplikacja przy każdym starcie potrzebuje internetu.

Do codziennej zabawy polecamy więc zwykłą instalację (polityka wyżej) na wspólnym koncie komputera. Kiosk Edge pasuje do pokazu albo dnia otwartego, kiedy każda sesja ma startować od zera:

Edge: jedna strona na pełnym ekranie (Windows)

msedge.exe --kiosk https://shop.kidroles.com/ --edge-kiosk-type=fullscreen --no-first-run

Kiosk z zachowaniem danych da Chrome uruchomiony z --kiosk na zwykłym profilu: pełny ekran bez paska adresu, a dane zostają między uruchomieniami. Przed startem zamknij inne okna Chrome — flaga działa tylko przy nowym uruchomieniu przeglądarki.

Chrome: KidRoles na pełnym ekranie

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

Kiosk Windows skonfigurujesz w Ustawienia → Konta → Inni użytkownicy → „Skonfiguruj kiosk”, w Intune albo poleceniem PowerShell Set-AssignedAccess. Z Edge działa w trybie kiosku Edge, więc obowiązuje to samo zastrzeżenie InPrivate.

Sieć i zapora

Aplikacja łączy się z jednym adresem i niczego nie ładuje z innych domen: bez CDN, fontów Google, reklam i analityki w aplikacji. Jedyny wyjątek to opcjonalna podpowiedź nazw produktów, domyślnie wyłączona (ostatni punkt niżej).

Adresy do przepuszczenia (port 443)

https://shop.kidroles.com/    (HTTPS, 443)
wss://shop.kidroles.com/pair    (WebSocket, 443)

Pierwsze otwarcie wymaga internetu — przeglądarka zapisuje wtedy aplikację (service worker). Potem kasa działa offline, a z internetem pobiera aktualizacje.
Parowanie telefonu jako skanera łączy kasę i telefon przez WebSocket wss://shop.kidroles.com/pair. Oba urządzenia potrzebują internetu, ale nie muszą być w tej samej sieci Wi-Fi. Serwer tylko przekazuje zeskanowane kody między nimi i ich nie zapisuje.
Serwer proxy z inspekcją TLS musi przepuszczać połączenia WebSocket (nagłówek Upgrade) do tego adresu — najprościej dodać shop.kidroles.com do wyjątków inspekcji. Gdy WebSocket jest zablokowany, nie działa tylko parowanie.
Telefon nie jest konieczny: kamera komputera albo tabletu też skanuje kody (przycisk „Skaner” w Sklepie).
Opcjonalnie: https://world.openfoodfacts.org (HTTPS, 443) — tylko gdy rodzic włączy w Ustawienia → Skaner „Podpowiadaj nazwy z internetu (tryb rodzica)”. Przy dodawaniu produktu po zeskanowaniu kodu aplikacja wysyła tam sam kod i pobiera nazwę z bazy Open Food Facts. Gdy adres jest zablokowany, nazwę wpisuje się ręcznie; reszta aplikacji działa bez zmian.

Dane i prywatność

Bez kont i logowania — dzieci nie podają imion ani adresów e-mail; kasjer to emoji albo zdjęcie zapisane lokalnie.
Wszystkie dane zostają w pamięci przeglądarki (localStorage), w profilu użytkownika na danym komputerze. Nic nie trafia na nasz serwer; w aplikacji nie ma reklam ani śledzenia.
Każdy profil przeglądarki i każde konto w systemie to osobny sklep. Na wspólnym komputerze grupy wystarczy jedno konto — dzieci mają w aplikacji własnych kasjerów.

Te ustawienia kasują dane aplikacji: ClearBrowsingDataOnExit (Edge), ClearBrowsingDataOnExitList (Chrome), BrowsingDataLifetime z typem cookies_and_other_site_data (Edge i Chrome), ForceEphemeralProfiles, pliki cookie „tylko na czas sesji” (DefaultCookiesSetting = 4), a także konta gościa i profile tymczasowe. Nie stosuj ich na komputerach z KidRoles albo sprawdź na jednym komputerze, czy kasjerzy i produkty przetrwają ponowne uruchomienie.

Jeden katalog dla całej placówki: w trybie edycji „Zapisz katalog” zapisuje produkty do pliku, który wczytasz na pozostałych komputerach („Wczytaj katalog”).

Źródła — dokumentacja Microsoft, Google i Apple

← Wróć na stronę główną