Przejdź do głównej zawartości

Zarządzana konfiguracja aplikacji

Skonfiguruj zachowanie Vylos przez standardowy kanał zarządzanej konfiguracji aplikacji Apple udostępniany przez usługę MDM.

Etapy wdrożenia

  1. Zainstaluj lub przypisz Vylos (io.cbnventures.vylos) jako aplikację zarządzaną.
  2. Utwórz słownik konfiguracji aplikacji w usłudze MDM.
  3. Dodaj tylko te klucze ograniczeń, preferencji i danych organizacji, którymi chcesz zarządzać.
  4. Przypisz słownik do docelowych urządzeń lub użytkowników.
  5. Uruchom Vylos lub przywróć aplikację na pierwszy plan, a następnie sprawdź wartości w sekcji Zarządzana konfiguracja.

Usunięcie opcjonalnego klucza preferencji przywraca użytkownikowi kontrolę nad danym ustawieniem. Po usunięciu całego słownika Vylos wyłączy zarządzaną konfigurację aplikacji przy następnym odświeżeniu.

Wymagania dotyczące dostarczania

Zarządzana konfiguracja aplikacji to słownik przypisany przez MDM do aplikacji Vylos (io.cbnventures.vylos). Vylos odczytuje go ze standardowej lokalizacji Apple com.apple.configuration.managed.

Słownik nie jest instalowalnym plikiem .mobileconfig i nie można go wprowadzić przez otwarcie profilu na urządzeniu. Do instalowania zarządzanych tuneli VPN używaj profili .mobileconfig.

W zależności od produktu MDM funkcja może nazywać się Zarządzana konfiguracja aplikacji, Konfiguracja aplikacji, Niestandardowe ustawienia aplikacji lub Ustawienia aplikacji zarządzanej. Aby iOS, macOS lub visionOS dostarczył słownik, Vylos musi najpierw zostać zainstalowany lub przypisany jako aplikacja zarządzana.

Obsługiwane klucze

Ograniczenia

KluczTypDomyślnieZastosowanie
allowManualTunnelslogicznytrueZezwala na tunele użytkownika oraz ich tworzenie, modyfikowanie i aktywowanie.
allowSettingslogicznytrueZezwala na dostęp do ustawień Vylos.
blockJailbrokenDeviceslogicznyfalseCałkowicie blokuje działanie Vylos po wykryciu jailbreaku w iOS.

Pełne zachowanie każdego ograniczenia opisuje strona Zarządzanie ograniczeniami, a proces pełnej blokady strona Egzekwowanie zasad jailbreaku.

Zarządzane preferencje

KluczTypDozwolone wartościDziałanie
notificationsEnabledlogicznytrue, 1, false lub 0Zastępuje główny przełącznik powiadomień Vylos i wszystkie cztery typy powiadomień o rozłączeniu. Nie nadaje systemowego uprawnienia Apple; jeśli administrator włączy powiadomienia i zablokuje ustawienia aplikacji, Vylos poprosi o zgodę z ekranu głównego.
appearanceciągsystem, light lub darkWymusza wskazany wygląd w iOS i macOS. visionOS pokazuje dostarczoną wartość do kontroli administratora, ale nadal używa adaptacyjnego wyglądu szkła systemowego.
appIconciągdefault, midnight, slate, steel, ocean, carbon, arctic, ember, forest lub obsidianWymusza alternatywną ikonę aplikacji w iOS. macOS i visionOS pokazują dostarczoną wartość do kontroli administratora, ale nie zmieniają ikony aplikacji.

Vylos zachowuje wcześniejsze wybory użytkownika i przywraca je po usunięciu odpowiedniego nadpisania przez administratora. Gdy opcjonalnego klucza brakuje lub ma nieprawidłowy format, dana preferencja pozostaje pod kontrolą użytkownika, nawet jeśli inne zarządzane klucze są prawidłowe.

Język nie jest zarządzaną preferencją Vylos. Użytkownik lub administrator wybiera język aplikacji za pomocą systemowych ustawień języka dla aplikacji.

Ustawienia Vylos z zarządzanymi preferencjami ochrony aplikacji, ikony, wyglądu i powiadomień

Dane organizacji

KluczTypWyświetlany jako
companyNameciągFirma
contactEmailciągE-mail
contactPhoneciągTelefon
contactAddressciągAdres

Vylos usuwa początkowe i końcowe odstępy oraz pomija puste wartości danych organizacji. Podane wartości pojawiają się w sekcji Zarządzana konfiguracja, aby użytkownik wiedział, kto zarządza aplikacją i jak uzyskać pomoc.

Wartości logiczne

Produkty MDM różnie serializują wartości konfiguracji, dlatego Vylos przyjmuje wartość logiczną, liczbę lub ciąg. Każdą wartość zamienia na ciąg, usuwa odstępy z obu stron i porównuje bez uwzględniania wielkości liter.

  • true i 1 oznaczają prawdę.
  • false i 0 oznaczają fałsz.
  • Brak klucza ograniczenia powoduje użycie wartości domyślnej podanej w dokumentacji.
  • Brak lub błędny format nadpisania preferencji pozostawia ustawienie użytkownika.

Na przykład " False ", "FALSE" i liczba 0 są interpretowane jako fałsz. Wartość taka jak "yes" jest nieprawidłowa i nie włączy klucza po cichu.

Pierwszeństwo konfiguracji

Dopóki istnieje prawidłowy klucz zarządzanej preferencji, zastępuje on odpowiednie ustawienie ręczne. Vylos przechowuje wybór użytkownika osobno, zamiast go nadpisywać.

Każde ograniczenie jest oceniane niezależnie. Podanie jednego zarządzanego klucza nie zmienia wartości domyślnych pominiętych kluczy.

Każda niepusta zarządzana konfiguracja pomija uwierzytelnianie wbudowanej blokady aplikacji Vylos. Ograniczenia nadal obowiązują: allowManualTunnels=false wstrzymuje tunele użytkownika i odrzuca zapisane skróty, a allowSettings=false nadal blokuje dostęp do ustawień.

Czas odświeżania

Vylos odczytuje zarządzany słownik podczas uruchamiania aplikacji oraz gdy scena powraca na pierwszy plan lub staje się aktywna. Po usunięciu słownika preferencje użytkownika wracają przy następnym odświeżeniu.

Ten moment jest niezależny od odświeżania stanu i statystyk tunelu. Gdy zarządzany tunel pojawi się w Vylos, otwarty widok szczegółów odświeża statystyki na żywo co sekundę, tak samo jak w tunelu użytkownika. Apple publikuje zarządzane profile według własnego harmonogramu, więc nowy lub zastąpiony profil VPN może pojawić się później; zobacz Wdrażanie zarządzanych tuneli.

Pełny przykład

Wklej poniższy słownik listy właściwości do edytora konfiguracji aplikacji w MDM albo wprowadź równoważne klucze w formularzu klucz-wartość:

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>it@example.com</string>
    <key>contactPhone</key>
    <string>+1 (212) 555-0100</string>
    <key>contactAddress</key>
    <string>100 Example Street, New York, NY</string>
</dict>
</plist>

Przykład stosuje następujące zasady:

KluczWartość przykładowaWynik w Vylos
allowManualTunnelsfalseUkrywa i wstrzymuje tunele utworzone przez użytkownika oraz uniemożliwia ich używanie. Tunele zarządzane pozostają dostępne.
allowSettingsfalseBlokuje sekcję ustawień w aplikacji.
blockJailbrokenDevicestrueW systemie iOS blokuje Vylos i jego tunele po wykryciu jailbreaku.
notificationsEnabledtrueWłącza główne ustawienie powiadomień Vylos oraz wszystkie cztery typy powiadomień.
appearancedarkWymusza ciemny wygląd w iOS i macOS; visionOS zapisuje wartość, ale nadal używa adaptacyjnego szkła systemowego.
appIconoceanWybiera ikonę Ocean w iOS; macOS i visionOS tylko wyświetlają zarządzaną wartość.
companyNameExample CompanyWyświetla nazwę organizacji zarządzającej w sekcji Konfiguracja zarządzana.
contactEmailit@example.comWyświetla adres e-mail pomocy technicznej.
contactPhone+1 (212) 555-0100Wyświetla numer telefonu pomocy technicznej.
contactAddressPrzykładowy adresWyświetla adres pocztowy organizacji.

Usuń każdy opcjonalny klucz, którego organizacja nie chce kontrolować. Nie wysyłaj pustego ciągu, aby oddać użytkownikowi kontrolę nad preferencją; usuń klucz.

Edytory klucz-wartość w MDM

Używaj dokładnej pisowni klucza i typu wartości podanych powyżej. Jeśli MDM obsługuje pola z typami, dodaj na przykład allowSettings jako wartość logiczną, a nie tekst "false". Vylos akceptuje też udokumentowane tekstowe i liczbowe formy wartości logicznych w konsolach, które serializują dane inaczej.

Co widzi użytkownik

Po włączeniu konfiguracji sekcja Zarządzana konfiguracja pokazuje najpierw dane organizacji, a następnie podane ograniczenia i zarządzane preferencje. Ekran ma charakter informacyjny — użytkownik nie może zmienić zarządzanych wartości.

Ekran aktywnej zarządzanej konfiguracji z kontaktem organizacji, ograniczeniami i zarządzanymi preferencjami

Gdy nie ma słownika, użytkownik może otworzyć Zarządzana konfiguracja aplikacji — informacje w ustawieniach ochrony aplikacji. Wartość „Nieaktywna” nie oznacza braku profilu konfiguracji VPN; są to dwa niezależne kanały wdrożenia.