Aplikasi Web Terisolasi (IWA) menawarkan lingkungan runtime yang sangat tepercaya, aman, dan memiliki versi terpisah di atas platform web. Di lingkungan produksi—terutama dalam perusahaan terkelola—administrator dan developer memerlukan kontrol yang mendetail atas deployment software.
Untuk memenuhi persyaratan ini, Chrome menyediakan kemampuan pengelolaan versi yang komprehensif untuk IWA, termasuk Saluran Update, Penyematan Versi, dan Downgrade Versi. Fitur ini memungkinkan prediktabilitas deployment, dan kontrol pemulihan cepat di seluruh basis pengguna Anda.
Ketersediaan
Perilaku pengelolaan versi bergantung pada apakah IWA dikelola oleh administrator atau diinstal langsung oleh pengguna:
- IWA terkelola: Fitur administratif (termasuk penyematan dan downgrade berbasis kebijakan) tersedia mulai Chrome 133.
- IWA Tidak Terkelola (Diinstal Pengguna): Fitur yang ditampilkan kepada pengguna (seperti pemilihan saluran manual) tersedia mulai Chrome 150.
Kompatibilitas jenis sesi
Semua fungsi pengelolaan versi—termasuk saluran update dan penyematan versi—kompatibel sepenuhnya di semua jenis sesi ChromeOS. Hal ini mencakup:
- Sesi Pengguna terkelola standar
- Sesi Tamu Terkelola (MGS)
- Lingkungan Mode kios khusus
Perbarui saluran
Dengan menggunakan saluran update, developer dapat menyegmentasikan build aplikasi tertentu untuk
audiens deployment dan pengujian yang berbeda. Untuk mengonfigurasi saluran, tambahkan kolom array saluran opsional ke setiap entri versi dalam manifes pembaruan aplikasi. Nama channel ini tidak dibatasi pada kata kunci platform tetap (seperti canary atau stable), tetapi merupakan ID arbitrer yang ditentukan developer dan harus diformat sebagai string alfanumerik ASCII huruf kecil (yang dapat menyertakan tanda hubung atau garis bawah, tetapi tanpa spasi).
Jika entri versi menghilangkan kolom saluran sepenuhnya, Chrome secara implisit menetapkan ketersediaannya secara default ke saluran "default". Pada akhirnya, nama saluran
yang ditetapkan dalam kebijakan administratif harus sama persis dengan string yang ditentukan dalam
manifes; kesalahan ketik atau konfigurasi yang tidak cocok akan menyebabkan
tidak ada versi yang memenuhi syarat yang diidentifikasi, sehingga menghentikan update untuk klien
tersebut.
Konfigurasi manifes
Untuk mengonfigurasi saluran, tambahkan array channels opsional ke setiap entri versi di
Manifes Aplikasi Web Anda.
Berikut beberapa pertimbangan yang perlu diperhatikan:
- Pemetaan saluran: Jika entri versi menentukan array
channels, versi tersebut hanya memenuhi syarat untuk diinstal di saluran yang ditentukan. - Penggantian default: Jika entri versi menghilangkan kolom
channelssama sekali, Chrome akan mengasumsikan bahwa versi tersebut secara eksklusif milik salurandefault. - Pencocokan string persis: Nama channel yang ditentukan dalam konfigurasi kebijakan sisi klien harus sama persis dengan string yang ditentukan dalam manifes pembaruan (peka huruf besar/kecil). Jika tidak ada versi yang cocok dengan nama channel yang ditargetkan, aplikasi akan gagal menemukan update yang memenuhi syarat.
Contoh manifes pembaruan
Contoh berikut menunjukkan manifes pembaruan yang mendukung beberapa saluran rilis:
{
"versions": [
{
"version": "0.1.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.1.0/iwa-sink.swbn",
"channels": ["delta"]
},
{
"version": "0.2.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.2.0/iwa-sink.swbn",
"channels": ["delta", "default"]
},
{
"version": "0.3.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.3.0/iwa-sink.swbn",
"channels": ["beta", "delta"]
},
{
"version": "0.4.0",
"src": "https://github.com/chromeos/iwa-sink/releases/download/v0.4.0/iwa-sink.swbn"
}
]
}
Berdasarkan manifes ini, versi berikut tersedia per saluran yang ditargetkan:
- default:
0.2.0,0.4.0(yang tidak memiliki saluran eksplisit dan ditetapkan ke default) - delta:
0.1.0,0.2.0,0.3.0 - beta:
0.3.0
Mesin update IWA mendukung penargetan saluran rilis tertentu dengan mencari kolom saluran di dalam Manifes Pembaruan aplikasi.
Penyematan versi
Dalam lingkungan perusahaan yang sangat stabil atau memiliki kepatuhan tinggi, administrator harus memastikan perangkat menjalankan versi software penting bisnis yang tepat. Penyematan versi memungkinkan administrator mengunci IWA ke versi tertentu, sehingga menghentikan semua update latar belakang berikutnya. Hal ini memberi perusahaan cara yang sangat andal untuk mempertahankan konfigurasi yang stabil dan mematuhi peraturan internal atau industri yang ketat.
Untuk membekukan Aplikasi Web Terisolasi (IWA) pada build rilis tertentu, administrator
perusahaan dapat mengonfigurasi properti pinned_version dalam
kebijakan
IsolatedWebAppInstallForceList. Kemampuan ini terutama dikelola melalui kontrol UI interaktif
di Konsol Google
Admin di bagian
panel detail aplikasi mengikuti alur kerja penginstalan
IWA standar, meskipun
administrator juga memiliki fleksibilitas untuk men-deploy nilai kebijakan ini
secara langsung menggunakan konfigurasi JSON mentah. Setelah string versi yang valid
berhasil ditargetkan oleh administrator, Chrome akan mengambil paket eksplisit tersebut
dan memblokir semua update otomatis berikutnya.
Perilaku dan batasan khusus
- Melanjutkan update (Melepas pin): Untuk memulihkan update otomatis, hapus
properti
pinned_versionatau ubah nilainya ke versi target yang lebih baru. - Tidak ada downgrade secara default: Menyetel
pinned_versionke versi yang lebih rendah dari versi yang saat ini diinstal tidak akan memicu rollback kecuali jikaallow_downgradesdiaktifkan secara eksplisit. - Target penyematan tidak tersedia: Jika
pinned_versionyang dikonfigurasi tidak ada dari saluran update yang ditetapkan, atau lebih lama dari versi yang diinstal (dengan downgrade dinonaktifkan), Chrome akan mempertahankan versi yang saat ini diinstal dan memblokir update lebih lanjut. - Deployment baru: Jika IWA belum diinstal di perangkat terkelola, dan pinned_version yang ditentukan tidak dapat diambil atau tidak ada dalam manifes pembaruan, IWA akan gagal diinstal.
Downgrade versi
Jika update yang baru di-deploy menimbulkan bug atau kerentanan kritis, administrator mungkin perlu melakukan rollback perangkat ke status stabil sebelumnya. Chrome mendukung penurunan versi IWA terkelola yang sudah diinstal ke versi yang lebih rendah—kemampuan yang sebelumnya tidak tersedia di platform saat hanya update ke versi yang lebih baru yang diizinkan.
Downgrade hanya dapat dilakukan jika kedua kondisi kebijakan berikut terpenuhi:
pinned_versiondisetel ke versi lama yang valid.allow_downgradesditetapkan secara eksplisit ke true.
Cara kerja downgrade
- Mekanisme pemicu: Rollback diproses selama siklus pemeriksaan update reguler (yang berjalan setiap 4–6 jam).
- Di balik layar: Chrome melakukan penginstalan ulang penuh IWA menggunakan paket web lama (.swbn) yang ditentukan dalam manifes pembaruan.
Logika transisi saluran
Saat beralih saluran yang ditargetkan aplikasi dengan kebijakan, mesin update mematuhi perilaku tertentu:
Skenario A: Beralih ke saluran dengan versi yang lebih lama
- Jika downgrade diizinkan: Jika pinned_version cocok dengan versi yang lebih lama di
saluran target dan
allow_downgradesbernilai benar (true), rollback akan terjadi (dan data pengguna lokal akan dihapus). - Jika downgrade tidak diizinkan: Downgrade tidak akan terjadi. Perangkat akan tetap menggunakan versi lebih tinggi yang saat ini diinstal dan hanya akan diupdate jika versi yang lebih baru tersedia di saluran yang baru dipilih.
Skenario B: Beralih ke saluran dengan versi yang sama
- Tidak ada perubahan: Jika saluran yang baru dipilih mengarah ke nomor versi yang sama dengan yang saat ini diinstal, Chrome tidak akan melakukan modifikasi pada paket yang diinstal.
- Prinsip identitas Byte-by-Byte: Developer harus menjamin bahwa nomor versi yang sama di berbagai saluran berisi tanda tangan kode yang identik dan cocok byte-nya. Men-deploy codebase yang berbeda di bawah string versi yang sama di seluruh saluran dapat menyebabkan status aplikasi yang tidak terduga dan tidak menentu.
Konfigurasi kebijakan administratif
Kontrol versi Enterprise diterapkan dengan platform Konsol Google Admin terpusat menggunakan skema kebijakan IsolatedWebAppInstallForceList. Setelan ini dapat dikelola langsung melalui kontrol UI di
Konsol Admin, atau di-deploy menggunakan konfigurasi kebijakan JSON mentah.
Contoh konfigurasi kebijakan administratif berikut menunjukkan saluran update, penyematan versi, dan downgrade:
Representasi nilai kebijakan
[
{
"update_manifest_url": "https://awesome-kitchen-sink.glitch.me/update.json",
"web_bundle_id": "aiv4bxauvcu3zvbu6r5yynoh4atkzqqaoeof5mwz54b4zfywcrjuoaacai",
"channel": "beta",
"pinned_version": "0.7.0",
"allow_downgrades": true
}
]
Penjelasan parameter skema
channel(string, opsional): Menginstruksikan Chrome untuk hanya mengevaluasi versi yang ditetapkan ke saluran ini dalam manifes pembaruan. Jika dihilangkan, Chrome akan mengevaluasi saluran "default".pinned_version(string, opsional): Mengunci perangkat secara eksplisit ke string versi yang ditentukan. Update latar belakang otomatis berikutnya akan diblokir.allow_downgrades(boolean, opsional): Mengaktifkan kemampuan rollback. Jika benar dan dipasangkan denganpinned_versionyang valid dan lebih lama, Chrome akan memicu penginstalan ulang downgrade. Peringatan: Menetapkan parameter ini ke true akan memblokir semua update penerusan standar meskipun kolompinned_versiondihilangkan.
IWA tidak terkelola (diinstal pengguna) (dari 150)
Untuk Aplikasi Web Terisolasi yang tidak dikelola dan diinstal pengguna, pembuatan versi beroperasi dengan interaksi pengguna manual:
Paket Penginstalan ──► Pengguna Memilih Saluran ──► Pemeriksaan Otomatis di Saluran yang Dipilih
Prasyarat manifes untuk update otomatis
Agar IWA yang diinstal pengguna dapat memeriksa dan menerima update berkala otomatis di
latar belakang, Manifes Aplikasi Web lokal aplikasi (metadata yang dipaketkan di dalam
paket di /.well-known/manifest.webmanifest) harus berisi kolom
update_manifest_url yang valid.
Jika URL ini dihilangkan dari file manifes lokal aplikasi, mesin update yang tidak dikelola tidak akan pernah melakukan pemeriksaan latar belakang, dan aplikasi akan tetap dibekukan secara permanen pada versi penginstalan awalnya.
Pemilihan saluran manual
Selama penginstalan awal IWA yang tidak dikelola, browser akan memeriksa manifes pembaruan dan menampilkan opsi saluran yang tersedia (misalnya, "Stabil", "Beta") langsung kepada pengguna jika developer telah mengonfigurasi beberapa saluran.
Aturan siklus proses kunci
- Asal penginstalan pertama: Terlepas dari saluran yang dipilih oleh pengguna saat penginstalan, penginstalan awal selalu men-deploy file yang dipaketkan di dalam paket penginstalan yang disediakan.
- Update berikutnya: Setelah diinstal, update mendatang akan dikueri secara eksklusif dari saluran yang dipilih. Aplikasi hanya akan diupdate jika versi yang lebih tinggi dari versi yang diinstal dipublikasikan ke saluran yang ditargetkan tersebut.
- Beralih saluran: Untuk beralih ke saluran update lain setelah penginstalan, pengguna harus meng-uninstal IWA dan menginstalnya kembali, dengan memilih saluran yang dipilih selama alur penginstalan.
Cara menguji deployment terkelola
Untuk administrator yang mengelola perangkat melalui Konsol Admin Chrome Enterprise atau mengonfigurasi kebijakan secara langsung:
- Buka panel Detail Aplikasi di bagian setelan organisasi.
- Terapkan properti konfigurasi untuk menguji penyematan dan target saluran. Karena kontrol ini sepenuhnya kompatibel dengan Sesi Pengguna standar, Sesi Tamu Terkelola (MGS), dan Kios, Anda dapat memverifikasi perilaku di semua lingkungan deployment target.
- Untuk memeriksa pemeriksaan update secara lokal, buka
chrome://web-app-internalsdi klien pengujian untuk memaksa pemeriksaan update secara manual dan menganalisis paket manifes yang masuk.
Kesimpulan
Arsitektur keamanan Aplikasi Web Terisolasi dirancang untuk memberdayakan developer sekaligus mempertahankan prediktabilitas dan kontrol yang ketat atas perilaku siklus proses aplikasi. Dengan memanfaatkan fitur pengelolaan versi Chrome, developer dan admin IT dapat membangun pipeline deployment yang tangguh dan selaras dengan standar kepatuhan yang ketat serta sasaran operasional.
Saat Anda mendesain dan mengelola strategi update aplikasi, ingatlah prinsip-prinsip inti berikut:
- Gunakan saluran progresif: Saluran update (seperti
beta,dev, atau ring kustom) memungkinkan Anda mengumpulkan telemetri dan masukan secara progresif. Hal ini memastikan update utama menjalani verifikasi yang ketat sebelum menjangkau populasi umum di saluran default. - Sematkan untuk stabilitas: Di lingkungan perusahaan yang sangat terstruktur atau berbasis kepatuhan, kunci endpoint penting ke pinned_version yang diverifikasi dan tepat untuk melindungi operasi dari kerusakan yang tidak terduga atau gangguan alur kerja.
- Cadangkan downgrade untuk keadaan darurat: Ketahuilah bahwa downgrade versi adalah katup pengaman korektif yang efektif dan sebelumnya tidak mungkin dilakukan. Namun, karena rollback memicu penginstalan ulang lengkap dan menghapus semua penyimpanan klien lokal (IndexedDB, LocalStorage, cookie), rollback harus benar-benar digunakan untuk perbaikan keamanan yang penting. Untuk patch biasa, men-deploy update kecil yang berorientasi ke masa depan selalu merupakan strategi yang ideal.
- Memahami tanda kebijakan: Perhatikan tombol administratif; mengaktifkan
allow_downgradesakan menghentikan semua update ke depan meskipun pin tidak ditentukan secara aktif. - Tetapkan Integritas Byte-by-Byte: Pastikan nomor versi identik yang di-deploy di berbagai saluran dipetakan ke paket yang identik dan cocok dengan byte untuk menghindari status aplikasi yang tidak menentu saat klien beralih antar-saluran.
Dengan mengintegrasikan fitur ini langsung ke Manifes Pembaruan dan skema kebijakan perusahaan, Anda dapat memastikan alur update yang andal, dapat diaudit, dan aman yang mempertahankan jaminan kepercayaan tinggi dari ekosistem Aplikasi Web Terisolasi.