Die SWOP-App kann über das Geräte-Management vorkonfiguriert werden, so dass Nutzer:innen beim ersten Start keinen SWOP-Server eintragen müssen, sondern direkt mit Benutzername und Passwort starten können.
Unterstützt wird das Standardverfahren der jeweiligen Plattform: iOS / iPadOS verwendet "Managed App Configuration" (PList-basiert, alle MDMs), Android verwendet "App Restrictions" via Android Enterprise / RestrictionsManager.
Anzeige bei App-Start oder nach Login hinzufügen:
Es gibt zwei Konfigurationswerte:
SwopServerURLs — Liste der erlaubten SWOP-URLs. Einträge können mit oder ohne Klartext-Bezeichnung (Label) ausgeliefert werden. Bei einem Eintrag wird die URL vorbelegt und Nutzer:in startet direkt mit Login. Bei mehreren Einträgen wählt Nutzer:in aus einer Liste (z.B. für Eltern mit Kindern an verschiedenen Schulen oder für Geräte-Pools, die zwischen Schulen wandern).
SwopRestrictToConfiguredURLs (Boolean, optional) — true bedeutet, dass Nutzer:in nur die vorgegebenen URLs verwenden kann. false oder fehlend bedeutet, dass Nutzer:in zusätzlich eine eigene SWOP-URL eintragen darf (Standardverhalten falls Schlüssel nicht gesetzt).
Daraus ergeben sich vier Modi:
A) 1 URL + Pflichtauswahl an: Die URL wird automatisch verbunden, Nutzer:in landet direkt auf dem Benutzername/Passwort-Schritt.
B) 1 URL + Pflichtauswahl aus: Die URL ist vorbelegt, Nutzer:in kann sie aber editieren bevor verbunden wird.
C) Mehrere URLs + Pflichtauswahl an: Nutzer:in wählt aus den vorgegebenen Schulen (Klartext-Labels werden angezeigt, falls hinterlegt). Eigene URL nicht möglich.
D) Mehrere URLs + Pflichtauswahl aus: Wie C, zusätzlich gibt es einen Button "Andere URL eingeben...", der zur klassischen URL-Eingabe wechselt.
Ohne MDM-Konfiguration arbeitet die App wie bisher (URL frei eintragen).
iOS / iPadOS - Beispiel-PList
Im MDM unter "Managed App Configuration" für die SWOP-App folgende Schlüssel hinterlegen:
Variante 1 — eine Schule, Pflichtauswahl:
<dict>
<key>SwopServerURLs</key>
<array>
<string>https://demo.swop.schule</string>
</array>
<key>SwopRestrictToConfiguredURLs</key>
<true/>
</dict>
Variante 2 — mehrere Schulen mit Klartext-Labels, Pflichtauswahl:
<dict>
<key>SwopServerURLs</key>
<array>
<dict>
<key>url</key>
<string>https://demo.swop.schule</string>
<key>label</key>
<string>SWOP Demoschule</string>
</dict>
<dict>
<key>url</key>
<string>https://demo2.swop.schule</string>
<key>label</key>
<string>SWOP Demoschule 2</string>
</dict>
</array>
<key>SwopRestrictToConfiguredURLs</key>
<true/>
</dict>
Variante 3 — mehrere Schulen, Nutzer darf eigene URL eintragen:
<dict>
<key>SwopServerURLs</key>
<array>
<string>https://schule-a.swop.schule</string>
<string>https://schule-b.swop.schule</string>
</array>
<key>SwopRestrictToConfiguredURLs</key>
<false/>
</dict>
In den meisten MDMs (Jamf, Mosyle, Intune, Apple Business Essentials, ...) werden diese Werte über eine Eingabemaske oder durch Hochladen einer .plist-Datei erfasst. Der Schlüsselname (z.B. SwopServerURLs) muss exakt so geschrieben werden.
Android (Android Enterprise / EMM)
Im MDM unter "App-Konfiguration" / "Managed Configuration" für die SWOP-App folgende Schlüssel hinterlegen: SwopServerURLs als Bundle-Array (siehe unten) und SwopRestrictToConfiguredURLs als Boolean.
Die SWOP-App akzeptiert SwopServerURLs in beiden Formen. Empfohlen ist ein Bundle-Array, jedes Bundle mit den Feldern url und label (mit Klartext-Bezeichnung):
[
{ "url": "https://demo.swop.schule", "label": "SWOP Demoschule" },
{ "url": "https://demo2.swop.schule", "label": "SWOP Demoschule 2" }
]
Alternativ akzeptiert die App auch ein einfaches String-Array (ohne Labels — die URL wird dann als Bezeichnung angezeigt):
[ "https://demo.swop.schule", "https://demo2.swop.schule" ]
Welche Form das jeweilige MDM unterstützt, ist herstellerabhängig. Beide werden von der App akzeptiert.
Hinweise
Die URL muss vollständig inkl. https:// angegeben werden, z.B. https://demo.swop.schule
Bei Fragen oder Problemen mit der MDM-Verteilung wenden Sie sich an den SWOP-Support.