Verwaltete App-Konfiguration

Steuern Sie das Verhalten von Vylos über den standardmäßigen Apple-Kanal für verwaltete App-Konfigurationen, den Ihr MDM-Dienst bereitstellt.

Bereitstellungsschritte

Installieren Sie Vylos (io.cbnventures.vylos) als verwaltete App oder weisen Sie die App als verwaltet zu.
Erstellen Sie in Ihrem MDM-Dienst ein App-Konfigurations-Dictionary.
Fügen Sie nur die Einschränkungs-, Einstellungs- und Organisationsschlüssel hinzu, die Sie verwalten möchten.
Weisen Sie das Dictionary den Zielgeräten oder Benutzern zu.
Starten Sie Vylos oder bringen Sie die App in den Vordergrund und prüfen Sie anschließend die Werte unter Verwaltete Konfiguration.

Wenn Sie einen optionalen Einstellungsschlüssel entfernen, kann der Benutzer diese Einstellung wieder selbst steuern. Wenn Sie das gesamte Dictionary entfernen, wird die verwaltete App-Konfiguration deaktiviert, sobald Vylos sie das nächste Mal aktualisiert.

Voraussetzungen für die Bereitstellung

Eine verwaltete App-Konfiguration ist ein Dictionary, das per MDM der Vylos-App (io.cbnventures.vylos) zugewiesen wird. Vylos liest es aus Apples standardmäßigem Speicherort com.apple.configuration.managed.

Dieses Dictionary ist keine installierbare .mobileconfig-Datei und kann nicht durch Öffnen eines Profils auf dem Gerät eingespeist werden. Verwenden Sie .mobileconfig-Profile, wenn Sie stattdessen einen verwalteten VPN-Tunnel installieren möchten.

Je nach MDM kann die Funktion Verwaltete App-Konfiguration, App-Konfiguration, Benutzerdefinierte App-Einstellungen oder Verwaltete App-Einstellungen heißen. Vylos muss als verwaltete App installiert oder zugewiesen sein, bevor iOS, macOS oder visionOS das Dictionary zustellen kann.

Unterstützte Schlüssel

Einschränkungen

Schlüssel	Typ	Standard	Zweck
`allowManualTunnels`	Boolean	`true`	Erlaubt selbst erstellte Tunnel sowie Aktionen zum Erstellen, Ändern oder Aktivieren dieser Tunnel.
`allowSettings`	Boolean	`true`	Erlaubt den Zugriff auf die Vylos-Einstellungen.
`blockJailbrokenDevices`	Boolean	`false`	Sperrt Vylos unter iOS vollständig, wenn die Jailbreak-Erkennung ein positives Ergebnis liefert.

Unter Einschränkungen verwalten finden Sie das vollständige Verhalten der einzelnen Einschränkungen. Jailbreak-Richtlinie durchsetzen erläutert den Lebenszyklus der vollständigen Sperre.

Verwaltete Einstellungen

Schlüssel	Typ	Zulässige Werte	Wirkung
`notificationsEnabled`	Boolean	`true`, `1`, `false` oder `0`	Überschreibt den Hauptschalter für Vylos-Mitteilungen und alle vier Arten von Trennungsmitteilungen. Die Apple-Systemberechtigung kann dadurch nicht erteilt werden. Sind Mitteilungen aktiviert und die App-Einstellungen gesperrt, fordert Vylos die Berechtigung auf dem Home-Bildschirm an.
`appearance`	String	`system`, `light` oder `dark`	Erzwingt die Darstellung unter iOS und macOS. visionOS zeigt den gelieferten Wert zur administrativen Kontrolle an, verwendet jedoch weiterhin adaptives Systemglas.
`appIcon`	String	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` oder `obsidian`	Erzwingt unter iOS ein alternatives App-Symbol. macOS und visionOS zeigen den gelieferten Wert zur administrativen Kontrolle an, ändern ihr App-Symbol jedoch nicht.

Vylos bewahrt die vorherigen Entscheidungen des Benutzers auf und stellt sie wieder her, nachdem die Administration die jeweilige Vorgabe entfernt hat. Ein fehlender oder fehlerhafter optionaler Schlüssel lässt die betreffende Einstellung unter Benutzerkontrolle, selbst wenn andere verwaltete Schlüssel aktiv bleiben.

Die Sprache ist keine von Vylos verwaltete Einstellung. Benutzer und Administratoren wählen die App-Sprache über die app-spezifische Sprachsteuerung des Betriebssystems.

Vylos-Einstellungen mit verwalteten Vorgaben für App-Schutz, App-Symbol, Darstellung und Mitteilungen

Organisationsinformationen

Schlüssel	Typ	Anzeige als
`companyName`	String	Unternehmen
`contactEmail`	String	E-Mail
`contactPhone`	String	Telefon
`contactAddress`	String	Adresse

Vylos entfernt umgebende Leerzeichen und blendet leere Organisationswerte aus. Gelieferte Werte erscheinen unter Verwaltete Konfiguration, damit Benutzer erkennen können, wer die App verwaltet und an wen sie sich wenden können.

Boolean-Werte

Vylos akzeptiert Boolean-Werte, Zahlen oder Strings, da MDM-Produkte Konfigurationswerte unterschiedlich serialisieren. Jeder Wert wird in einen String umgewandelt, von umgebenden Leerzeichen bereinigt und ohne Beachtung der Groß- und Kleinschreibung verglichen.

true und 1 bedeuten wahr.
false und 0 bedeuten falsch.
Bei einer fehlenden Einschränkung gilt der dokumentierte Standardwert.
Bei einer fehlenden oder fehlerhaften Einstellungsvorgabe bleibt die Benutzereinstellung wirksam.

So werden beispielsweise " False ", "FALSE" und die Zahl 0 als falsch ausgewertet. Ein Wert wie "yes" ist ungültig und aktiviert einen Schlüssel nicht stillschweigend.

Vorrang der Konfiguration

Eine gültige verwaltete Einstellung überschreibt die entsprechende manuelle Einstellung, solange der Schlüssel vorhanden ist. Vylos speichert die Auswahl des Benutzers getrennt, statt sie zu überschreiben.

Einschränkungen werden unabhängig voneinander ausgewertet. Ein einzelner verwalteter Schlüssel ändert die Standardwerte der ausgelassenen Schlüssel nicht.

Jede nicht leere verwaltete Konfiguration überspringt den integrierten Authentifizierungsschritt der Vylos-App-Sperre. Die verwalteten Einschränkungen gelten weiterhin: allowManualTunnels=false setzt selbst erstellte Tunnel aus und lehnt deren gespeicherte Kurzbefehle ab; allowSettings=false sperrt weiterhin die Einstellungen.

Aktualisierungszeitpunkt

Vylos liest das verwaltete Dictionary beim Start der App sowie jedes Mal, wenn eine Szene in den Vordergrund zurückkehrt oder aktiv wird. Wird das Dictionary entfernt, werden benutzergesteuerte Einstellungen bei der nächsten Aktualisierung wiederhergestellt.

Dieser Zeitpunkt ist unabhängig von der Aktualisierung des Tunnelstatus und der Statistiken. Sobald ein verwalteter Tunnel in Vylos erscheint, werden die Live-Statistiken seiner geöffneten Detailansicht wie bei einem selbst erstellten Tunnel jede Sekunde aktualisiert. Ein neu installiertes oder ersetztes VPN-Profil kann trotzdem später erscheinen, da Apple verwaltete Profile nach einem eigenen Zeitplan veröffentlicht. Weitere Informationen finden Sie unter Verwaltete Tunnel bereitstellen.

Vollständiges Beispiel

Dieses Beispiel enthält alle unterstützten Schlüssel und dient als vollständige, kopierbare Schemareferenz. Fügen Sie das Property-List-Dictionary in einen MDM-Editor ein, der XML akzeptiert, oder tragen Sie dieselben Schlüssel und Typen einzeln in einen Schlüssel-Wert-Editor ein:

xml

<?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">
<plist version="1.0">
<dict>
    <key>allowManualTunnels</key>
    <false/>
    <key>allowSettings</key>
    <false/>
    <key>blockJailbrokenDevices</key>
    <true/>
    <key>notificationsEnabled</key>
    <true/>
    <key>appearance</key>
    <string>dark</string>
    <key>appIcon</key>
    <string>ocean</string>
    <key>companyName</key>
    <string>Example Company</string>
    <key>contactEmail</key>
    <string>[email protected]</string>
    <key>contactPhone</key>
    <string>+1 (212) 555-0100</string>
    <key>contactAddress</key>
    <string>100 Example Street, New York, NY</string>
</dict>
</plist>

Das Beispiel erzeugt folgende Richtlinie:

Schlüssel	Beispielwert	Ergebnis in Vylos
`allowManualTunnels`	`false`	Blendet benutzererstellte Tunnel aus, setzt sie aus und verhindert ihre Verwendung. Verwaltete Tunnel bleiben verfügbar.
`allowSettings`	`false`	Sperrt den Einstellungsbereich der App.
`blockJailbrokenDevices`	`true`	Sperrt Vylos und seine Tunnel unter iOS, wenn ein Jailbreak erkannt wird.
`notificationsEnabled`	`true`	Aktiviert die übergeordnete Vylos-Benachrichtigungseinstellung und alle vier Benachrichtigungstypen.
`appearance`	`dark`	Erzwingt unter iOS und macOS das dunkle Erscheinungsbild; visionOS protokolliert den Wert, verwendet aber weiterhin adaptives Systemglas.
`appIcon`	`ocean`	Wählt unter iOS das Ocean-Symbol; macOS und visionOS zeigen nur den verwalteten Wert an.
`companyName`	`Example Company`	Benennt die verwaltende Organisation unter Verwaltete Konfiguration.
`contactEmail`	`[email protected]`	Zeigt die Support-E-Mail-Adresse der Organisation.
`contactPhone`	`+1 (212) 555-0100`	Zeigt die Support-Telefonnummer der Organisation.
`contactAddress`	Beispieladresse	Zeigt die Postanschrift der Organisation.

Entfernen Sie optionale Schlüssel, die Ihre Organisation nicht steuern möchte. Senden Sie keinen leeren String, um eine Einstellung freizugeben, sondern entfernen Sie den Schlüssel.

Schlüssel-Wert-Editoren in MDM-Systemen

Verwenden Sie exakt die oben angegebene Schreibweise und den Werttyp. Fügen Sie allowSettings beispielsweise als Boolean und nicht als Text "false" hinzu, wenn Ihr MDM typisierte Felder unterstützt. Für Konsolen, die Werte anders serialisieren, akzeptiert Vylos auch die dokumentierten String- und Zahlenformen für Boolean-Werte.

Was Benutzer sehen

Wenn eine Konfiguration aktiv ist, zeigt Verwaltete Konfiguration zuerst die Organisation und anschließend die gelieferten Einschränkungen und verwalteten Einstellungen. Die Ansicht dient nur zur Information; verwaltete Werte können dort nicht geändert werden.

Aktive Ansicht der verwalteten Konfiguration mit Organisationskontakt, Einschränkungen und verwalteten Einstellungen

Wenn kein Dictionary vorhanden ist, können Benutzer in den App-Schutz-Einstellungen Informationen zur verwalteten App-Konfiguration öffnen. Der dort angezeigte deaktivierte Status bedeutet nicht, dass ein VPN-Konfigurationsprofil fehlt; beide Bereitstellungskanäle sind voneinander unabhängig.