Konfigurasi Aplikasi Terkelola

Konfigurasikan perilaku Vylos melalui saluran konfigurasi aplikasi terkelola standar Apple yang disediakan layanan MDM Anda.

Langkah Penerapan

Pasang atau tetapkan Vylos (io.cbnventures.vylos) sebagai aplikasi terkelola.
Buat kamus konfigurasi aplikasi di layanan MDM.
Tambahkan hanya kunci pembatasan, preferensi, dan informasi organisasi yang ingin Anda kelola.
Tetapkan kamus ke perangkat atau pengguna target.
Buka Vylos atau bawa kembali ke latar depan, lalu verifikasi nilai di Konfigurasi Terkelola.

Menghapus kunci preferensi opsional mengembalikan pengaturan tersebut ke kontrol pengguna. Setelah seluruh kamus dihapus, Vylos menonaktifkan konfigurasi aplikasi terkelola pada penyegaran berikutnya.

Persyaratan Pengiriman

Konfigurasi aplikasi terkelola adalah kamus yang ditetapkan MDM ke aplikasi Vylos (io.cbnventures.vylos). Vylos membacanya dari lokasi standar Apple com.apple.configuration.managed.

Kamus ini bukan file .mobileconfig yang dapat dipasang dan tidak dapat disuntikkan dengan membuka profil di perangkat. Untuk memasang tunnel VPN terkelola, gunakan profil .mobileconfig.

Produk MDM Anda mungkin menamainya Konfigurasi Aplikasi Terkelola, Konfigurasi Aplikasi, Pengaturan Aplikasi Khusus, atau Pengaturan Aplikasi Terkelola. Vylos harus lebih dulu dipasang atau ditetapkan sebagai aplikasi terkelola agar iOS, macOS, atau visionOS dapat mengirimkan kamus.

Kunci yang Didukung

Pembatasan

Kunci	Jenis	Bawaan	Kegunaan
`allowManualTunnels`	Boolean	`true`	Mengizinkan tunnel buatan pengguna serta tindakan membuat, mengubah, atau mengaktifkannya.
`allowSettings`	Boolean	`true`	Mengizinkan akses ke pengaturan Vylos.
`blockJailbrokenDevices`	Boolean	`false`	Memblokir seluruh Vylos saat jailbreak terdeteksi di iOS.

Lihat Mengelola Pembatasan untuk perilaku lengkap dan Menerapkan Kebijakan Jailbreak untuk alur pemblokiran penuh.

Preferensi Terkelola

Kunci	Jenis	Nilai yang diterima	Efek
`notificationsEnabled`	Boolean	`true`, `1`, `false`, atau `0`	Menggantikan sakelar utama pemberitahuan Vylos dan keempat jenis pemberitahuan terputus. Pengaturan ini tidak dapat memberi izin sistem Apple; jika administrator mengaktifkan pemberitahuan dan memblokir pengaturan aplikasi, Vylos meminta izin dari layar utama.
`appearance`	String	`system`, `light`, atau `dark`	Memaksakan tampilan yang dipilih di iOS dan macOS. visionOS menampilkan nilai yang dikirim untuk verifikasi administrator, tetapi tetap menggunakan tampilan kaca adaptif sistem.
`appIcon`	String	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest`, atau `obsidian`	Memaksakan ikon aplikasi alternatif di iOS. macOS dan visionOS menampilkan nilai yang dikirim untuk verifikasi, tetapi tidak mengubah ikon aplikasi.

Vylos menyimpan pilihan pengguna sebelumnya dan memulihkannya ketika administrator menghapus penggantian terkait. Jika kunci opsional tidak ada atau formatnya salah, preferensi tersebut tetap dikontrol pengguna meskipun kunci terkelola lainnya valid.

Bahasa bukan preferensi terkelola Vylos. Pengguna dan administrator memilih bahasa aplikasi melalui kontrol bahasa per aplikasi pada sistem operasi.

Pengaturan Vylos yang menampilkan preferensi terkelola untuk perlindungan aplikasi, ikon, tampilan, dan pemberitahuan

Informasi Organisasi

Kunci	Jenis	Ditampilkan sebagai
`companyName`	String	Perusahaan
`contactEmail`	String	Email
`contactPhone`	String	Telepon
`contactAddress`	String	Alamat

Vylos menghapus spasi awal dan akhir serta tidak menampilkan nilai organisasi yang kosong. Nilai yang diberikan muncul di Konfigurasi Terkelola agar pengguna mengetahui siapa yang mengelola aplikasi dan cara meminta bantuan.

Nilai Boolean

Produk MDM menserialisasi nilai konfigurasi dengan cara berbeda, jadi Vylos menerima Boolean, angka, atau string. Vylos mengubah setiap nilai menjadi string, menghapus spasi di sekelilingnya, lalu membandingkannya tanpa membedakan huruf besar-kecil.

true dan 1 berarti benar.
false dan 0 berarti salah.
Jika kunci pembatasan tidak ada, nilai bawaan dalam dokumentasi digunakan.
Jika penggantian preferensi tidak ada atau tidak valid, pengaturan pengguna tetap digunakan.

Misalnya, " False ", "FALSE", dan angka 0 semuanya ditafsirkan sebagai salah. Nilai seperti "yes" tidak valid dan tidak diam-diam mengaktifkan kunci.

Prioritas Konfigurasi

Selama kunci preferensi terkelola yang valid ada, kunci tersebut menggantikan pengaturan manual terkait. Vylos menyimpan pilihan pengguna secara terpisah, bukan menimpanya.

Setiap pembatasan dinilai secara independen. Memberikan satu kunci terkelola tidak mengubah nilai bawaan kunci lain yang dihilangkan.

Konfigurasi terkelola apa pun yang tidak kosong melewati langkah autentikasi Kunci App bawaan Vylos. Pembatasan tetap berlaku: allowManualTunnels=false menangguhkan tunnel buatan pengguna dan menolak pintasan tersimpannya, sedangkan allowSettings=false tetap memblokir pengaturan.

Waktu Penyegaran

Vylos membaca kamus terkelola saat aplikasi dibuka serta ketika scene kembali ke latar depan atau aktif. Setelah kamus dihapus, preferensi yang dikontrol pengguna kembali pada penyegaran berikutnya.

Waktu ini terpisah dari penyegaran status dan statistik tunnel. Setelah tunnel terkelola muncul di Vylos, layar detail yang terbuka menyegarkan statistik langsung setiap detik seperti tunnel pengguna. Apple menerbitkan profil terkelola sesuai waktunya sendiri, jadi profil VPN baru atau pengganti mungkin baru muncul kemudian; lihat Menerapkan Tunnel terkelola.

Contoh Lengkap

Tempelkan kamus daftar properti berikut ke editor konfigurasi aplikasi MDM atau masukkan kunci yang setara di formulir kunci-nilai:

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>

Contoh ini menerapkan kebijakan berikut:

Kunci	Nilai contoh	Hasil di Vylos
`allowManualTunnels`	`false`	Menyembunyikan dan menangguhkan tunnel buatan pengguna serta mencegah penggunaannya. Tunnel terkelola tetap tersedia.
`allowSettings`	`false`	Memblokir area Pengaturan dalam aplikasi.
`blockJailbrokenDevices`	`true`	Di iOS, memblokir Vylos dan tunnelnya saat jailbreak terdeteksi.
`notificationsEnabled`	`true`	Mengaktifkan pengaturan utama notifikasi Vylos dan keempat jenis notifikasi.
`appearance`	`dark`	Memaksa tampilan Gelap di iOS dan macOS; visionOS mencatat nilainya tetapi tetap menggunakan kaca adaptif sistem.
`appIcon`	`ocean`	Memilih ikon Ocean di iOS; macOS dan visionOS hanya menampilkan nilai terkelola.
`companyName`	`Example Company`	Menamai organisasi pengelola pada Konfigurasi Terkelola.
`contactEmail`	`[email protected]`	Menampilkan email dukungan organisasi.
`contactPhone`	`+1 (212) 555-0100`	Menampilkan nomor telepon dukungan.
`contactAddress`	Alamat contoh	Menampilkan alamat surat organisasi.

Hapus kunci opsional yang tidak ingin dikontrol organisasi. Jangan kirim string kosong untuk mengembalikan kendali preferensi kepada pengguna; hapus kuncinya.

Editor kunci-nilai MDM

Gunakan ejaan kunci dan tipe nilai persis seperti yang ditampilkan. Misalnya, tambahkan allowSettings sebagai Boolean, bukan teks "false", jika MDM mendukung bidang bertipe. Vylos juga menerima bentuk Boolean teks dan angka yang didokumentasikan untuk konsol yang melakukan serialisasi nilai secara berbeda.

Yang Dilihat Pengguna

Saat konfigurasi aktif, Konfigurasi Terkelola menampilkan informasi organisasi terlebih dahulu, lalu pembatasan dan preferensi terkelola yang diberikan. Layar ini hanya untuk informasi; pengguna tidak dapat mengubah nilai terkelola.

Layar informasi konfigurasi terkelola aktif dengan kontak organisasi, pembatasan, dan preferensi terkelola

Jika tidak ada kamus, pengguna dapat membuka Tentang Konfigurasi Aplikasi Terkelola di pengaturan Perlindungan App. Status “Tidak Aktif” tidak berarti profil konfigurasi VPN tidak ada; keduanya merupakan saluran penerapan yang terpisah.