Управляемая конфигурация приложения

Настройте поведение Vylos через стандартный канал управляемой конфигурации приложений Apple, предоставляемый вашей службой MDM.

Порядок развёртывания

1. Установите или назначьте Vylos (io.cbnventures.vylos) как управляемое приложение.
2. Создайте словарь конфигурации приложения в службе MDM.
3. Добавьте только те ключи ограничений, параметров и данных организации, которыми нужно управлять.
4. Назначьте словарь целевым устройствам или пользователям.
5. Запустите Vylos или верните приложение на передний план, затем проверьте значения в разделе Управляемая конфигурация.

Удаление необязательного ключа возвращает соответствующий параметр под управление пользователя. После удаления всего словаря Vylos отключит управляемую конфигурацию при следующем обновлении.

Требования к доставке

Управляемая конфигурация приложения — это словарь, который MDM назначает приложению Vylos (io.cbnventures.vylos). Vylos считывает его из стандартного расположения Apple com.apple.configuration.managed.

Этот словарь не является устанавливаемым файлом .mobileconfig, и его нельзя добавить, открыв профиль на устройстве. Для установки управляемых VPN-туннелей используйте профили .mobileconfig.

В вашем продукте MDM эта функция может называться Управляемая конфигурация приложения, Конфигурация приложения, Пользовательские настройки приложения или Настройки управляемого приложения. Чтобы iOS, macOS или visionOS мог доставить словарь, Vylos сначала нужно установить или назначить как управляемое приложение.

Поддерживаемые ключи

Ограничения

Полное поведение описано в разделе Управление ограничениями, а процесс полной блокировки — в разделе Применение политики jailbreak.

Управляемые параметры

Vylos хранит прежний выбор пользователя и восстанавливает его после удаления соответствующего переопределения администратором. Если необязательный ключ отсутствует или неверен, параметр остаётся под управлением пользователя, даже когда другие управляемые ключи действительны.

Язык не относится к управляемым параметрам Vylos. Пользователь или администратор выбирает язык через системные настройки языка отдельного приложения.

Данные организации

Vylos удаляет пробелы в начале и конце и не показывает пустые значения. Указанные данные отображаются в разделе Управляемая конфигурация, чтобы пользователь знал, кто управляет приложением и куда обратиться за помощью.

Логические значения

Продукты MDM по-разному сериализуют значения, поэтому Vylos принимает логическое значение, число или строку. Каждое значение преобразуется в строку, окружающие пробелы удаляются, а сравнение выполняется без учёта регистра.

• true и 1 означают истину.
• false и 0 означают ложь.
• При отсутствии ключа ограничения используется указанное в документации значение по умолчанию.
• При отсутствии или ошибке переопределения сохраняется настройка пользователя.

Например, " False ", "FALSE" и число 0 интерпретируются как ложь. Значение "yes" недопустимо и не включает ключ автоматически.

Приоритет конфигурации

Пока существует допустимый ключ управляемого параметра, он переопределяет соответствующую ручную настройку. Vylos хранит выбор пользователя отдельно и не затирает его.

Каждое ограничение оценивается независимо. Наличие одного управляемого ключа не меняет значения по умолчанию для остальных пропущенных ключей.

Любая непустая управляемая конфигурация пропускает проверку встроенной блокировки Vylos. Ограничения продолжают действовать: allowManualTunnels=false приостанавливает пользовательские туннели и отклоняет их сохранённые команды, а allowSettings=false по-прежнему блокирует настройки.

Момент обновления

Vylos считывает управляемый словарь при запуске приложения и при возвращении сцены на передний план или в активное состояние. После удаления словаря пользовательские параметры возвращаются при следующем обновлении.

Этот момент не связан с обновлением состояния и статистики туннеля. После появления управляемого туннеля в Vylos открытый экран сведений обновляет статистику каждую секунду, как и для пользовательского туннеля. Apple публикует управляемые профили по собственному графику, поэтому новый или заменённый VPN-профиль может появиться позднее; см. Развёртывание управляемых туннелей.

Полный пример

Вставьте следующий словарь списка свойств в редактор конфигурации приложения MDM или введите те же ключи в форме «ключ — значение»:

<?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>

Пример применяет следующую политику:

Удалите каждый необязательный ключ, которым организация не должна управлять. Не передавайте пустую строку, чтобы вернуть параметр под контроль пользователя; удалите ключ.

Что видит пользователь

При активной конфигурации раздел Управляемая конфигурация сначала показывает данные организации, затем ограничения и управляемые параметры. Экран носит справочный характер; пользователь не может изменить управляемые значения.

Если словаря нет, пользователь может открыть Об управляемой конфигурации приложения в настройках защиты приложения. Состояние «Неактивна» не означает отсутствие VPN-профиля; эти два канала развёртывания независимы.