受管理 App 配置

通过你的MDM服务提供的 Apple 标准受管理 App 配置通道来配置 Vylos 的行为。

部署步骤

将 Vylos（io.cbnventures.vylos）安装或分配为受管理 App。
在 MDM 服务中创建 App 配置字典。
只添加你打算管理的限制、偏好设置和组织信息键。
将字典分配给目标设备或用户。
启动 Vylos 或将其切回前台，然后在受管理配置中核对各项值。

删除可选偏好设置键后，该设置会重新由用户控制。删除整个字典后，Vylos 在下次刷新时会停用受管理 App 配置。

下发要求

受管理 App 配置是由 MDM 分配给 Vylos App（io.cbnventures.vylos）的字典。Vylos 从 Apple 标准位置 com.apple.configuration.managed 读取该字典。

此字典不是可安装的 .mobileconfig 文件，不能通过在设备上打开描述文件来注入。需要安装受管理 VPN 隧道时，请使用 .mobileconfig 描述文件。

你的 MDM 可能将此功能称为受管理 App 配置、App 配置、自定义 App 设置或受管理 App 设置。必须先将 Vylos 安装或分配为受管理 App，iOS、macOS 或 visionOS 才能向其下发字典。

支持的键

限制

键	类型	默认值	用途
`allowManualTunnels`	布尔值	`true`	允许用户创建的隧道以及创建、修改或激活这些隧道的操作。
`allowSettings`	布尔值	`true`	允许访问 Vylos 设置。
`blockJailbrokenDevices`	布尔值	`false`	在 iOS 上检测到越狱时完全阻止 Vylos 运行。

有关每项限制的完整行为，请参阅管理限制；有关完全阻止的执行流程，请参阅执行越狱策略。

受管理偏好设置

键	类型	可接受的值	效果
`notificationsEnabled`	布尔值	`true`、`1`、`false` 或 `0`	覆盖 Vylos 通知总开关和全部四种断开连接通知。此设置无法授予 Apple 系统通知权限；如果管理员启用通知但又禁止访问 App 内设置，Vylos 会从主屏幕请求权限。
`appearance`	字符串	`system`、`light` 或 `dark`	在 iOS 和 macOS 上强制使用指定外观。visionOS 会显示所下发的值供管理员核对，但仍使用系统的自适应玻璃外观。
`appIcon`	字符串	`default`、`midnight`、`slate`、`steel`、`ocean`、`carbon`、`arctic`、`ember`、`forest` 或 `obsidian`	在 iOS 上强制使用替代 App 图标。macOS 和 visionOS 会显示所下发的值供管理员核对，但不会更改 App 图标。

Vylos 会保留用户之前的选择，并在管理员删除相应覆盖后恢复这些选择。如果可选键缺失或格式错误，即使其他受管理键仍然有效，该偏好设置也仍由用户控制。

语言不是 Vylos 的受管理偏好设置。用户和管理员通过操作系统的 App 专用语言控制来选择 App 语言。

Vylos 设置，其中显示 App 保护、App 图标、外观和通知的受管理偏好设置

组织信息

键	类型	显示为
`companyName`	字符串	公司
`contactEmail`	字符串	电子邮件
`contactPhone`	字符串	电话
`contactAddress`	字符串	地址

Vylos 会去除首尾空白，并省略空白的组织信息值。所提供的值会显示在受管理配置中，让用户知道谁在管理 App 以及如何寻求帮助。

布尔值

不同 MDM 产品序列化配置值的方式不同，因此 Vylos 接受布尔值、数字或字符串。Vylos 会将每个值转换为字符串，去除首尾空白，并在不区分大小写的情况下进行比较。

true 和 1 表示真。
false 和 0 表示假。
缺少限制键时，会使用文档中列出的默认值。
偏好设置覆盖缺失或格式错误时，会继续使用用户的设置。

例如，" False "、"FALSE" 和数字 0 都会被解释为假。"yes" 等值格式无效，不会静默启用相应键。

配置优先级

只要有效的受管理偏好设置键仍然存在，它就会覆盖对应的手动设置。Vylos 会单独保存用户的选择，而不是将其覆盖。

各项限制会独立评估。提供一个受管理键不会改变其他省略键的默认值。

任何非空的受管理配置都会绕过 Vylos 内置 App 锁的认证步骤。受管理限制仍然生效：allowManualTunnels=false 会暂停用户创建的隧道并拒绝其已保存的快捷指令，allowSettings=false 则继续阻止访问设置。

刷新时机

Vylos 会在 App 启动时，以及场景返回前台或变为活跃状态时读取受管理字典。删除字典后，用户控制的偏好设置会在下一次刷新时恢复。

此时机与隧道状态和统计数据的刷新相互独立。受管理隧道出现在 Vylos 中之后，其已打开的详细信息视图会像用户创建的隧道一样每秒刷新实时统计数据。由于 Apple 会按自己的时机发布受管理描述文件，新安装或替换的 VPN 描述文件仍可能稍后才出现；请参阅部署受管理隧道。

完整示例

将以下属性列表字典粘贴到 MDM 的 App 配置编辑器中，或者在其键值表单中输入等效键：

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>

此示例会应用以下策略：

键	示例值	在 Vylos 中的结果
`allowManualTunnels`	`false`	隐藏并暂停用户创建的隧道，且禁止使用这些隧道。受管理隧道仍然可用。
`allowSettings`	`false`	阻止访问 App 内的“设置”区域。
`blockJailbrokenDevices`	`true`	在 iOS 上检测到越狱时，阻止使用 Vylos 及其隧道。
`notificationsEnabled`	`true`	开启 Vylos 通知总开关和全部四种通知类型。
`appearance`	`dark`	在 iOS 和 macOS 上强制使用深色外观；visionOS 会记录该值，但继续使用系统自适应玻璃效果。
`appIcon`	`ocean`	在 iOS 上选择 Ocean 图标；macOS 和 visionOS 仅显示受管理值。
`companyName`	`Example Company`	在受管理配置中显示管理组织的名称。
`contactEmail`	`[email protected]`	显示组织的支持邮箱。
`contactPhone`	`+1 (212) 555-0100`	显示组织的支持电话号码。
`contactAddress`	示例地址	显示组织的邮寄地址。

请删除组织不打算控制的可选键。不要通过发送空字符串来将偏好设置交还用户控制；应删除该键。

MDM 键值编辑器

请严格使用上方所示的键拼写和值类型。例如，如果 MDM 支持带类型的字段，请将 allowSettings 添加为布尔值，而不是文本 "false"。对于以不同方式序列化值的控制台，Vylos 也接受文档中列出的字符串和数字布尔值形式。

用户看到的内容

配置生效后，受管理配置会先显示组织信息，然后显示所提供的限制和受管理偏好设置。此屏幕仅用于提供信息，用户不能更改受管理值。

没有字典时，用户可以在 App 保护设置中打开关于受管理 App 配置。该视图显示“已停用”并不表示缺少 VPN 配置描述文件；这两种部署通道相互独立。