MDM-dokumentasjon
Kioskys støtter administrert appkonfigurasjon (Managed App Configuration). MDM-løsningen din leverer en plist med nøkler til appen; hver nøkkel du angir, går foran det brukeren har skrevet, og brukeren kan ikke endre den. Alle nøkler er valgfrie.
Dette trenger du
- En overvåket iPad som er registrert i MDM-løsningen din (kreves for Single App Mode).
- Kioskys kjøpt i volum i Apple Business Manager (betalt app, tildelt enhetene eller brukerne dine) og installert av MDM som administrert app: konfigurasjonen leveres bare til administrerte apper.
- Appens Bundle ID: app.consulenza.kioskys (det samme for alle, du trenger ikke endre det).
Nøkler
| Nøkkel | Type | Verdier | Hva den gjør |
|---|---|---|---|
kioskURL | streng | adresse | Kiosk-nettstedet. Uten skjema legges https:// til (http:// for IP-adresser og lokalt nettverk). |
autoStartSeconds | heltall | 0, eller 3–120 | Sekunder for nedtellingen ved oppstart. 0 = ingen innstillingsskjerm, kiosken starter umiddelbart. Standard 10. |
settingsPIN | streng | 4–8 sifre | PIN-kode som beskytter innstillingene. Brukeren kan ikke endre eller fjerne den. Skriv den som en streng for å beholde innledende nuller. |
allowUserConfiguration | boolsk | true / false | false = innstillingsskjermen er skrivebeskyttet. Standard true. |
allowedHosts | array av strenger | vertsnavn | Ekstra domener siden kan navigere til (for eksempel en ekstern innlogging). Bare vertsnavn, uten skjema eller sti. |
allowCamera | boolsk | true / false | Gir sidene på det konfigurerte nettstedet tilgang til kameraet. Standard true. |
allowLocation | boolsk | true / false | Gir tilgang til posisjonen. Ved false svarer navigator.geolocation «denied». Standard true. |
staleReloadMinutes | heltall | 0–1440 | Minutter i bakgrunnen etter som siden lastes på nytt ved retur. 0 = aldri. Standard 0 (av). |
orientation | streng | auto, portrait, landscape | Orienteringslås (portrait og landscape tillater også 180°-vending). Standard auto. |
energySaverEnabled | boolsk | true / false | Strømsparing: etter de angitte minuttene uten berøring dimmes skjermen til 5 %; en berøring gjenoppretter 100 %. Standard true. |
energySaverMinutes | heltall | 1–120 | Minutter uten berøring før skjermen dimmes. Standard 5. |
deviceName | streng | 1–80 tegn | Enhetsnavn, synlig for sider som window.Kioskys.deviceName. |
openingHours | dictionary | mon … sun, daily | Åpningstider. Hver dag er "HH:mm-HH:mm", "24h" eller "closed"; dager som ikke er oppgitt, er stengt med mindre daily er angitt. Tom dictionary = alltid åpent. Stenging før åpning = åpent etter midnatt. |
closedMessage | streng | opptil 200 tegn | Tekst som vises på stengt-skjermen. |
idleResetSeconds | heltall | 0, eller 10–3600 | Etter så mange sekunder uten berøring (eller tastetrykk) går kiosken tilbake til første side. 0 = av. Standard av. |
idleResetClearData | boolsk | true / false | Sletter også informasjonskapsler og nettstedsdata ved tilbakestilling. Standard true. |
playlist | array av dictionaries | type, url, seconds, muted | Spillelistemodus: sider, bilder og videoer etter tur i en løkke (opptil 50). type: page, image eller video; seconds: 3–3600 (0 for en video = til slutten); muted: true demper en video. Bilder og videoer lastes ned og lagres på iPad-en, så de spilles uten forsinkelse. Erstatter kioskURL. Tom array = klassisk kiosk. |
closedBrightness | heltall | 0–100 | Skjermens lysstyrke når det er stengt (prosent). Standard 5. |
closedMedia | dictionary | type, url | Et bilde eller en video som vises når det er stengt: {type: image eller video, url}. Det lastes ned og lagres på iPad-en; en video gjentas. Tom dictionary = standard stengt-skjerm. |
bridgeEnabled | boolsk | true / false | JavaScript-broen (window.Kioskys.scan, beep). Standard true. |
disablePageZoom | boolsk | true / false | Blokkerer sidezoom: klyping, dobbelttrykk og sidens viewport. Standard true. |
scannerCamera | streng | front, back | Kamera som brukes av Kioskys.scan(). Standard front. |
energySaverBrightness | heltall | 0–100 | Skjermens lysstyrke (prosent) når strømsparing har dempet skjermen. Standard 5. Øk den hvis du bruker en skjermsparer. |
screensaverEnabled | boolsk | true / false | Skjermsparer: når strømsparing demper skjermen, vises et bilde eller en video i stedet for kiosken; en berøring bringer kiosken tilbake. Den har ingen egen tidtaker eller lysstyrke. Standard av (slås på av seg selv hvis du sender screensaverMedia uten denne nøkkelen). |
screensaverMedia | dictionary | type, url | Skjermsparerens bilde eller video: {type: image eller video, url}. Lastes ned og lagres på iPaden; en video gjentas, uten lyd. Tom dictionary = ikke noe innhold (skjermspareren starter ikke). |
customCSS | streng | ≤ 100 000 | CSS som legges til på hver side på kiosknettstedet (og på domenene i allowedHosts), ikke på tredjepartssider som nettstedet omdirigerer til. Brukes før siden vises. |
customJS | streng | ≤ 100 000 | JavaScript som kjøres på hver side på kiosknettstedet (og på domenene i allowedHosts) når den er lastet; window.Kioskys er tilgjengelig. Feil havner i sidens konsoll. Med customJS bestemmer MDM-en din hva som kjører i kiosken: skriv det som koden på ditt eget nettsted. |
Greit å vite
- Tall og boolske verdier sendt som strenger ("10", "true") godtas. Ugyldige verdier ignoreres og rapporteres, de ødelegger aldri appen.
- settingsPIN står i klartekst i profilen (administratorer i MDM kan se den). Appen lagrer den ikke på enheten.
- Endringer i MDM brukes mens appen er åpen; en ny adresse laster siden på nytt.
- Appen rapporterer status i com.apple.feedback.managed (versjon, adresse, siden lastet, status for kamera- og posisjonstillatelser, konfigurasjonsproblemer).
- Kioskys holder iPad-en våken mens appen er i forgrunnen. For å hindre at noen forlater appen, bruk Single App Mode.
- Fem raske trykk i øvre venstre hjørne åpner innstillingene igjen (skrivebeskyttet hvis allowUserConfiguration er false; en eventuell settingsPIN spørres om først).
- De samme nøklene fungerer også uten MDM: siden QR-konfigurator gjør dem om til en QR-kode som kopierer innstillingene til en iPad. Det en MDM angir, gjelder alltid, og brukeren kan ikke endre det.
Ferdige filer
Profilene har allerede Bundle ID app.consulenza.kioskys. Opprett nye UUID-er (uuidgen) før bruk. Kommentarene i filene er på engelsk.
- Appkonfigurasjon (alle nøkler)
- Profil for Single App Mode (MDM låser iPad-en til Kioskys)
- Profil for Autonomous Single App Mode (appen låser seg selv)
Eksempelkonfigurasjon
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<!--
Kioskys - Managed App Configuration
Paste this dictionary into the "App Configuration" field of your MDM, for the app with the Bundle ID
app.consulenza.kioskys. All keys are optional: keep only the ones you need.
A key that is present wins over what the user set by hand, and the user cannot change it.
-->
<plist version="1.0">
<dict>
<!-- Kiosk address. Without a scheme https:// is added (http:// for IPs and local network). -->
<key>kioskURL</key>
<string>https://example.org/kiosk</string>
<!-- Seconds of the start countdown: 0 = no settings screen, the kiosk starts immediately; otherwise 3-120. -->
<key>autoStartSeconds</key>
<integer>0</integer>
<!-- PIN protecting the settings (string of 4-8 digits). The user cannot change or remove it.
Note: it is in clear text inside the profile (MDM administrators can see it). It is not stored on the device. -->
<key>settingsPIN</key>
<string>4821</string>
<!-- false = the settings screen is read-only (no local changes). Default: true. -->
<key>allowUserConfiguration</key>
<true/>
<!-- Extra domains the page may navigate to (e.g. an external login). Host names only, no https:// and no paths. -->
<key>allowedHosts</key>
<array>
<string>login.example.com</string>
</array>
<!-- Camera and location granted to the pages of the configured site. Default: true. -->
<key>allowCamera</key>
<true/>
<key>allowLocation</key>
<true/>
<!-- Minutes in the background after which the page reloads on return (0 = never). Default: 0. -->
<key>staleReloadMinutes</key>
<integer>0</integer>
<!-- Screen orientation lock: auto (free), portrait or landscape.
Portrait and landscape also allow the 180-degree flip. Default: auto. -->
<key>orientation</key>
<string>landscape</string>
<!-- Energy Saver: after energySaverMinutes without touches the brightness drops to energySaverBrightness (default 5%); a touch restores 100%.
Default: on, 5 minutes. Minutes: 1 to 120. Brightness: 0 to 100. -->
<key>energySaverEnabled</key>
<true/>
<key>energySaverMinutes</key>
<integer>5</integer>
<key>energySaverBrightness</key>
<integer>30</integer>
<!-- Device name, visible to pages as window.Kioskys.deviceName (max 80 characters). -->
<key>deviceName</key>
<string>Warehouse iPad 1</string>
<!-- Opening hours: mon..sun (or daily) as "HH:mm-HH:mm", "24h" or "closed". Days not listed are closed unless daily is given.
An empty dictionary means always open. Outside the hours the kiosk shows a closed screen at minimum brightness. -->
<key>openingHours</key>
<dict>
<key>daily</key>
<string>08:00-20:00</string>
<key>sun</key>
<string>closed</string>
</dict>
<key>closedMessage</key>
<string>We are closed. See you tomorrow!</string>
<!-- Closed screen: brightness in percent (default 5) and an optional photo or video that is downloaded and saved on the iPad.
Use <dict/> for the standard closed screen (moon and message). -->
<key>closedBrightness</key>
<integer>40</integer>
<key>closedMedia</key>
<dict>
<key>type</key><string>image</string>
<key>url</key><string>https://example.org/closed.jpg</string>
</dict>
<!-- Inactivity reset: after this many seconds without touches the kiosk returns to its first page (0 = off; 10-3600). -->
<key>idleResetSeconds</key>
<integer>120</integer>
<key>idleResetClearData</key>
<true/>
<!-- Playlist: pages, photos and videos shown in turn, in a loop (up to 50). It replaces kioskURL when present; an empty array = no playlist.
seconds: 3-3600; for a video 0 means "until it ends". -->
<key>playlist</key>
<array>
<dict>
<key>type</key><string>page</string>
<key>url</key><string>https://example.org/menu</string>
<key>seconds</key><integer>30</integer>
</dict>
<dict>
<key>type</key><string>image</string>
<key>url</key><string>https://example.org/offer.jpg</string>
<key>seconds</key><integer>10</integer>
</dict>
<dict>
<key>type</key><string>video</string>
<key>url</key><string>https://example.org/promo.mp4</string>
<key>seconds</key><integer>0</integer>
<key>muted</key><true/>
</dict>
</array>
<!-- JavaScript bridge (window.Kioskys.scan / beep) and the camera used for scanning: front or back. -->
<key>bridgeEnabled</key>
<true/>
<!-- Blocks page zoom: pinch, double-tap and the page's own viewport. Default: true. -->
<key>disablePageZoom</key>
<true/>
<key>scannerCamera</key>
<string>front</string>
<!-- Screensaver: while the Energy Saver has dimmed the screen (energySaverMinutes/energySaverBrightness) this photo or video is shown; a touch brings the kiosk back. It has no timer of its own. -->
<key>screensaverEnabled</key>
<true/>
<key>screensaverMedia</key>
<dict>
<key>type</key><string>video</string>
<key>url</key><string>https://example.org/screensaver.mp4</string>
</dict>
<!-- Custom CSS and JavaScript, applied to the pages of the kiosk site (not to third-party pages). Up to 100000 characters each. -->
<key>customCSS</key>
<string>.cookie-banner { display: none !important; }</string>
<key>customJS</key>
<string>document.documentElement.classList.add('kiosk');</string>
</dict>
</plist>