管理対象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設定などと呼ばれます。iOS、macOS、visionOSが辞書を配信するには、Vylosが管理対象Appとしてインストールまたは割り当てられている必要があります。

対応するキー

制限

キー	型	既定値	目的
`allowManualTunnels`	Boolean	`true`	ユーザー作成トンネルと、それを作成、変更、有効化する操作を許可します。
`allowSettings`	Boolean	`true`	Vylos設定へのアクセスを許可します。
`blockJailbrokenDevices`	Boolean	`false`	iOSでJailbreak検出が陽性になった場合、Vylosを完全に使用できない状態にします。

各制限の詳しい動作は制限を管理する、完全にブロックする仕組みはJailbreakポリシーを適用するを参照してください。

管理対象設定

キー	型	使用できる値	効果
`notificationsEnabled`	Boolean	`true`、`1`、`false`、`0`	Vylos通知の主設定と4種類すべての切断通知を上書きします。Appleのシステム通知権限を付与することはできません。通知が有効でApp内設定が禁止されている場合、Vylosはホーム画面から権限を要求します。
`appearance`	String	`system`、`light`、`dark`	iOSとmacOSで外観を強制します。visionOSは管理者が確認できるよう値を表示しますが、引き続きシステムの適応型ガラスを使用します。
`appIcon`	String	`default`、`midnight`、`slate`、`steel`、`ocean`、`carbon`、`arctic`、`ember`、`forest`、`obsidian`	iOSで代替Appアイコンを強制します。macOSとvisionOSは管理者が確認できるよう値を表示しますが、Appアイコンは変更しません。

Vylosはユーザーの以前の選択を保持し、管理者が該当する上書きを削除すると復元します。任意キーがない、または形式が正しくない場合は、ほかの管理対象キーが有効でもその設定はユーザーが変更できます。

言語はVylosの管理対象設定ではありません。ユーザーと管理者は、OSのAppごとの言語コントロールでAppの言語を選択します。

組織情報

キー	型	表示名
`companyName`	String	会社
`contactEmail`	String	メール
`contactPhone`	String	電話
`contactAddress`	String	住所

Vylosは前後の空白を取り除き、空の組織情報は表示しません。指定された値は管理対象構成に表示されるため、ユーザーはAppの管理者と問い合わせ先を確認できます。

Boolean値

MDM製品によって構成値のシリアル化方法が異なるため、VylosはBoolean、数値、文字列を受け付けます。各値を文字列化して前後の空白を削除し、大文字と小文字を区別せず比較します。

trueと1は真です。
falseと0は偽です。
制限キーがない場合は、記載された既定値を使用します。
設定の上書きがない、または形式が正しくない場合は、ユーザーの設定が有効です。

たとえば、" False "、"FALSE"、数値の0はいずれも偽として評価されます。"yes"のような値は不正で、キーを暗黙的に有効化しません。

構成の優先順位

有効な管理対象設定は、そのキーが存在する間、対応する手動設定より優先されます。Vylosはユーザーの保存済み選択を上書きせず、別に保持します。

制限は個別に評価されます。1つの管理対象キーを指定しても、省略したキーの既定値は変わりません。

空でない管理対象構成がある場合、Vylosに組み込まれたAppロック認証手順は省略されます。管理対象の制限は引き続き適用されます。allowManualTunnels=falseはユーザー作成トンネルを一時停止し、保存済みショートカットを拒否します。allowSettings=falseは設定を引き続きブロックします。

更新のタイミング

VylosはAppの起動時と、シーンが前面に戻ったとき、またはアクティブになったときに管理対象辞書を読み取ります。辞書を削除すると、次回の更新時にユーザー管理の設定へ戻ります。

このタイミングは、トンネル状態や統計の更新とは別です。管理対象トンネルがVylosに表示された後は、ユーザー作成トンネルと同様に、開いている詳細画面のライブ統計が1秒ごとに更新されます。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でJailbreakが検出された場合、Vylosとそのトンネルをブロックします。
`notificationsEnabled`	`true`	Vylosの通知の主設定と4種類の通知をすべて有効にします。
`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"ではなくBooleanとして追加します。Vylosは、値を別の方法でシリアル化するコンソール向けに、記載された文字列形式と数値形式のBooleanも受け付けます。

ユーザーに表示される内容

構成が有効な場合、管理対象構成には最初に組織、その後に指定された制限と管理対象設定が表示されます。この画面は情報表示専用で、管理対象の値は変更できません。

辞書がない場合、ユーザーはAppの保護設定から管理対象App構成についてを開けます。そこで無効と表示されても、VPN構成プロファイルがないという意味ではありません。2つの配信経路は独立しています。