Beberapa aplikasi yang didesain untuk perusahaan menyertakan setelan bawaan yang disebut konfigurasi terkelola yang dapat dikonfigurasi oleh admin IT dari jarak jauh. Misalnya, aplikasi mungkin memiliki opsi untuk hanya menyinkronkan data saat perangkat terhubung ke Wi-Fi. Semua set solusi harus dapat diberikan kepada admin IT untuk menentukan konfigurasi terkelola dan menerapkannya ke perangkat. Ada dua cara untuk mendukung konfigurasi terkelola di konsol EMM:
- Buat UI Anda sendiri dan terapkan setelan melalui
managedConfiguration
di ApplicationPolicy. - Tambahkan iframe konfigurasi terkelola ke konsol Anda (petunjuk dijelaskan di bawah) dan terapkan setelan melalui
managedConfigurationTemplate
di ApplicationPolicy
Iframe konfigurasi terkelola adalah UI yang dapat disematkan yang memungkinkan admin IT menyimpan, mengedit, dan menghapus setelan konfigurasi terkelola aplikasi. Misalnya, Anda dapat menampilkan tombol (atau elemen UI serupa) di halaman detail atau setelan aplikasi yang membuka iframe.
Tindakan yang tersedia untuk admin IT dari iframe
Menetapkan dan menyimpan profil konfigurasi
iframe mengambil dan menampilkan skema konfigurasi terkelola untuk
aplikasi yang ditentukan. Dalam iframe, admin IT dapat menetapkan konfigurasi dan menyimpannya
sebagai profil konfigurasi. Setiap kali admin IT menyimpan profil konfigurasi baru, iframe akan menampilkan ID unik yang disebut mcmId
.
Hal ini memungkinkan admin IT membuat beberapa profil untuk aplikasi
yang sama.
Mengedit profil konfigurasi
Iframe dapat menampilkan profil konfigurasi yang tersimpan. Admin IT dapat memperbarui setelan dalam profil dan menyimpan perubahan mereka.
Menghapus profil konfigurasi
Admin IT dapat menghapus profil konfigurasi dari iframe. Fitur ini dinonaktifkan secara default.
Menambahkan iframe ke konsol Anda
Membuat token web
Gunakan enterprises.webTokens.create
untuk membuat token web yang mengidentifikasi perusahaan, dan tetapkan iframeFeature
ke
MANAGED_CONFIGURATIONS
. Anda harus menyertakan token yang ditampilkan, bersama dengan parameter lainnya, saat merender iframe di konsol Anda.
Merender iframe
Berikut adalah contoh cara merender iframe konfigurasi terkelola:
<script src="https://apis.google.com/js/api.js"></script>
<div id="container" style="width: 1000px; height: 1000px"></div>
<script>
gapi.load('gapi.iframes', function() {
var options = {
'url': 'https://play.google.com/managed/mcm?token=web_token&packageName=app_package_name',
'where': document.getElementById('container'),
'attributes': { style: 'height:1000px', scrolling: 'yes'}
}
var iframe = gapi.iframes.getContext().openChild(options);
});
</script>
Parameter URL
Tabel di bawah ini mencantumkan semua parameter yang tersedia untuk URL iframe.
Parameter | Wajib | Deskripsi |
---|---|---|
token |
Ya | Token yang ditampilkan dari Enterprises.createWebToken . |
packageName |
Ya | ID produk aplikasi. Misalnya,
com.google.android.gm . |
mcmId |
Tidak | ID profil konfigurasi terkelola. |
canDelete |
Tidak | Jika TRUE, akan mengaktifkan tombol di iframe yang memungkinkan admin IT menghapus profil konfigurasi terkelola. Jika FALSE (nilai default), tombol akan dinonaktifkan. |
locale |
Tidak | Tag bahasa BCP 47 yang tersusun dengan baik dan digunakan untuk melokalkan konten dalam iframe. Jika tidak ditentukan, nilai defaultnya adalah en_US. |
Acara iframe
Anda juga harus menangani peristiwa berikut sebagai bagian dari integrasi Anda.
Event | Deskripsi |
---|---|
onconfigupdated |
Pengguna memperbarui profil konfigurasi terkelola yang ada atau membuat profil
baru. Tindakan ini akan menampilkan objek yang berisi:
{ "mcmId": The ID of the managed configurations profile. "name": The name of the updated or newly created managed configurations profile. } |
onconfigdeleted |
Pengguna menghapus profil konfigurasi terkelola yang ada. Tindakan ini akan menampilkan objek yang berisi:{ "mcmId": The ID of the managed configurations profile. } |
Contoh di bawah menunjukkan cara memproses onconfigupdated
, sebagai contoh:
iframe.register('onconfigupdated', function(event) {
console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);
Pembaruan pada skema konfigurasi terkelola aplikasi
Jika developer memperbarui skema konfigurasi terkelola aplikasi, profil konfigurasi yang tersimpan akan otomatis diperbarui. Misalnya, jika developer menghapus opsi, opsi tersebut akan dihapus dari semua profil konfigurasi yang ada untuk aplikasi tersebut. Jika developer menambahkan opsi, nilai default untuk opsi tersebut (ditentukan oleh developer) akan ditambahkan ke semua profil konfigurasi yang ada untuk aplikasi tersebut.
Menerapkan profil konfigurasi pada kebijakan
Setiap profil konfigurasi disimpan sebagai mcmId
unik. Untuk menerapkan
profil konfigurasi ke suatu kebijakan, tentukan mcmId
di
managedConfigurationTemplate
.
Memahami perilaku pilih/batalkan pilihan
Iframe konfigurasi terkelola kini memungkinkan admin IT untuk secara eksplisit membatalkan pilihan pembatasan aplikasi dari konfigurasi terkelola saat mereka tidak membutuhkannya. Ini adalah perubahan dari perilaku sebelumnya dan mungkin berdampak pada pembatasan yang dikirim ke aplikasi Anda berdasarkan pilihan admin.
Bagian di bawah ini menguraikan perilaku iframe konfigurasi terkelola terhadap pola pembatalan pilihan baru ini dan hal yang diharapkan developer untuk dikirim sebagai bagian dari konfigurasi terkelola mereka.
Menggunakan nilai default untuk pembatasan aplikasi
Jika pembatasan aplikasi dengan jenis bool, choice, integer, multi-pilihan atau string diberikan dengan nilai default, nilai default akan diterapkan sebagai nilai pembatasan aplikasi saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan apa pun pada batasan aplikasi tersebut.
Misalnya, dengan skema pembatasan aplikasi berikut:
"restrictions": [{
"key": "bool_key",
"restrictionType": "bool",
"defaultValue": {
"type": "bool",
"valueBool": false
}
}]
Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [{
"key": "bool_key",
"restrictionType": "bool",
"value": {
"type": "bool",
"valueBool": false
}
}]
Tanpa menggunakan nilai default untuk pembatasan aplikasi
Jika pembatasan aplikasi dengan jenis bool, choice, integer, multi-pilihan atau string tidak diberi nilai default, pembatasan aplikasi ini tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan pada pembatasan aplikasi tersebut.
Misalnya, dengan skema pembatasan aplikasi berikut:
"restrictions": [{
"key": "bool_key",
"restrictionType": "bool"
// defaultValue absent.
}]
Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [
// Empty
]
Menggunakan paket dalam skema
Bagian ini berlaku untuk pembatasan aplikasi paket:
Memiliki minimal satu pembatasan aplikasi turunan dengan nilai default dalam pembatasan aplikasi paket
Jika dalam pembatasan aplikasi paket setidaknya salah satu pembatasan aplikasi turunan dengan jenis bool, pilihan, bilangan bulat, multi-pilihan, atau string diberikan dengan nilai default, nilai default akan diterapkan sebagai nilai pembatasan aplikasi dan nilai default akan dikecualikan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan apa pun pada batasan aplikasi tersebut.
"restrictions": [{
"key": "bundle_key",
"restrictionType": "bundle",
"nestedRestriction": [{
"key": "bool_key_1",
"restrictionType": "bool",
"defaultValue": {
"type": "bool",
"valueBool": false
}
},
{
"key": "bool_key_2",
"restrictionType": "bool"
// defaultValue absent.
}
]
}]
Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [{
"key": "bundle_key",
"restrictionType": "bundle",
"nestedRestriction": [{
"key": "bool_key_1",
"restrictionType": "bool",
"value": {
"type": "bool",
"valueBool": false
}
},
// The bool_key_2 child app restriction is not included.
]
}]
Semua pembatasan aplikasi turunan tanpa nilai default
Jika dalam pembatasan aplikasi paket, semua pembatasan aplikasi turunan dengan jenis bool, pilihan, bilangan bulat, multi-pilihan, atau string tidak diberi nilai default, pembatasan aplikasi paket tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan apa pun pada batasan aplikasi tersebut.
Misalnya, dengan skema pembatasan aplikasi berikut:
"restrictions": [{
"key": "bundle_key",
"restrictionType": "bundle",
"nestedRestriction": [{
"key": "bool_key_1",
"restrictionType": "bool",
// defaultValue absent.
},
{
"key": "bool_key_2",
"restrictionType": "bool"
// defaultValue absent.
}
]
}]
Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [
// Empty
]
Menggunakan bundle_array dalam skema Anda
Bagian ini berlaku untuk pembatasan aplikasi bundle_array. Hal ini tidak relevan jika pembatasan aplikasi turunan dengan jenis bool, choice, integer, multi-pilihan atau string memiliki nilai default.
Misalnya, dengan skema pembatasan aplikasi berikut:
"restrictions": [{
"key": "bundle_array_key",
"restrictionType": "bundleArray",
"nestedRestriction": [{
"key": "bundle_key",
"restrictionType": "bundle",
"nestedRestriction": [{
"key": "bool_key",
"restrictionType": "bool",
"defaultValue": {
"type": "bool",
"valueBool": true
}
}]
}]
}]
Memiliki setidaknya satu grup paket dalam pembatasan aplikasi bundle_array
Jika setidaknya satu grup bundle ditetapkan, pembatasan aplikasi bundle_array akan disertakan saat admin menyimpan konfigurasi terkelola.
Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [{
"key": "bundle_array_key",
"restrictionType": "bundleArray",
"nestedRestriction": [{
"key": "bundle_key",
"restrictionType": "bundle",
"nestedRestriction": [{
"key": "bool_key",
"restrictionType": "bool",
"value": {
"type": "bool",
"valueBool": true
}
}]
}]
}]
Jika satu pembatasan atau grup paket disimpan, semua batasan/paket dalam seluruh bundle_array
akan ditetapkan berdasarkan prioritas berikut:
- nilai yang dipilih admin
- nilai default yang tercantum untuk paket/pembatasan tersebut.
- nilai yang ditampilkan di iFrame jika tidak ada nilai default
Tidak ada grup paket dalam pembatasan aplikasi bundle_array
Pembatasan aplikasi bundle_array tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menambahkan grup paket. Pembatasan aplikasi yang dikirim ke perangkat adalah:
"restrictions": [
// Empty
]