Dengan iframe zero-touch, Anda dapat menyematkan zero-touch langsung ke konsol EMM untuk memungkinkan pelanggan mengonfigurasi perangkat yang mendukung zero-touch dengan mudah menggunakan Android Device Policy. iframe memungkinkan Anda menyetel tambahan penyediaan yang digunakan selama penyiapan perangkat zero-touch.
![iframe zero-touch](https://developers.google.cn/static/android/management/images/zt-iframe-home-amapi.png?authuser=19&hl=id)
Saat pertama kali membuka iframe, admin IT akan diminta untuk menautkan akun zero-touch ke perusahaan mereka.
Setelah admin IT menautkan akun zero-touch ke perusahaan mereka, iframe akan menampilkan daftar akun zero-touch tertaut. Pengguna juga dapat melihat konfigurasi zero-touch default yang ditetapkan untuk perangkat perusahaan.
Fitur
Bagian ini menjelaskan fitur yang tersedia di iframe zero-touch. Untuk mengetahui informasi cara menyematkan iframe dan menerapkan fitur tersebut, lihat Menambahkan iframe ke konsol Anda.
Menautkan akun zero-touch ke perusahaan
iframe ini memungkinkan admin IT menautkan akun zero-touch dan perusahaan mereka. Sebagai bagian dari proses ini, admin IT membuat profil zero-touch default untuk digunakan pada perangkat dalam akun zero-touch. Alur ini diuraikan di bawah ini.
Jika admin IT belum pernah menautkan akun zero-touch ke perusahaannya, mereka akan diminta untuk melakukannya saat membuka iframe.
![Alur penautan iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-link.png?authuser=19&hl=id)
Admin IT akan melihat daftar akun zero-touch dan dapat memilih satu atau beberapa akun untuk menautkan ke perusahaannya.
![layar daftar akun iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-choose-accounts.png?authuser=19&hl=id)
![layar konfigurasi iframe zero-touch](https://developers.google.cn/static/android/management/images/zt-iframe-show-dpc-amapi.png?authuser=19&hl=id)
Iframe zero-touch secara otomatis menghasilkan konfigurasi zero-touch. Konfigurasi ini tidak dapat diubah oleh admin IT. Anda dapat menyesuaikan tambahan penyediaan untuk digunakan dalam konfigurasi ini. Untuk informasi lebih lanjut tentang cara melakukannya, lihat parameter URL iframe.
![layar informasi dukungan iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-support-info.png?authuser=19&hl=id)
Admin IT memasukkan informasi dukungan yang muncul saat perangkat yang mendukung zero-touch disiapkan. Saat admin IT mengklik “simpan”, proses penautan akan selesai dan pengguna dialihkan ke halaman beranda iframe zero-touch, tempat mereka dapat mengelola akun tertaut.
Melihat dan mengelola akun zero-touch tertaut
iframe memungkinkan admin IT melihat akun zero-touch yang tertaut serta profil zero-touch default dan informasi dukungan mereka. Selain itu, mereka dapat menautkan akun zero-touch tambahan dan membatalkan tautan akun zero-touch.
Lihat Gambar 1 untuk contoh tampilan halaman beranda iframe zero-touch.
Melihat perangkat untuk akun tertaut di portal zero-touch
Jika akun zero-touch ditautkan ke perusahaan, semua perangkat di akun zero-touch yang tidak dikonfigurasi dengan profil zero-touch akan otomatis dikonfigurasi dengan profil zero-touch Enterprise.
Di dalam konsol zero-touch, perangkat ini ditampilkan dengan konfigurasi "Profil default perusahaan". Admin IT dapat menyetel dan membatalkan penetapan profil ini di perangkat apa pun di akun zero-touch. Namun, profil tidak dapat diubah.
Jika akun zero-touch dibatalkan tautannya, semua perangkat yang dikonfigurasi dengan “Profil default perusahaan” tidak akan menyetel profil ini. Perangkat ini dapat dikonfigurasi dengan profil yang berbeda.
Menambahkan iframe ke konsol Anda
Langkah 1: Buat token web
Panggil enterprises.webTokens.create
untuk membuat token web yang mengidentifikasi perusahaan. Respons akan berisi
value
token.
- Tetapkan
parentFrameUrl
ke URL frame induk yang menghosting iframe. - Gunakan
iframeFeature
untuk menentukan fitur yang akan diaktifkan di iframe: 'ZERO_TOUCH'. JikaiframeFeature
tidak ditetapkan, iframe akan mengaktifkan semua fitur secara default.
Anda perlu menyertakan token yang ditampilkan, bersama dengan parameter lainnya, saat merender iframe di konsol Anda.
Langkah 2: Render iframe
Berikut adalah contoh cara merender iframe zero-touch:
<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
gapi.load('gapi.iframes', function() {
var options = {
'url': 'https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=web_token&dpcId=com.google.android.apps.work.clouddpc',
'where': document.getElementById('container'),
'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
}
var iframe = gapi.iframes.getContext().openChild(options);
});
</script>
Kode ini menghasilkan iframe di dalam div penampung. Atribut yang akan diterapkan ke tag iframe dapat ditetapkan dengan opsi 'atribut', seperti di atas.
parameter URL iframe
Tabel di bawah ini mencantumkan semua parameter yang tersedia untuk iframe yang dapat ditambahkan ke URL sebagai parameter URL, misalnya:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.google.android.apps.work.clouddpc
Parameter | Wajib | Deskripsi |
---|---|---|
token |
Ya | Token yang ditampilkan dari Langkah 1. |
dpcId |
Ya | Nama paket aplikasi DPC. Anda harus selalu menyetelnya ke ID Android Device Policy, com.google.android.apps.work.clouddpc .
|
dpcExtras |
Tidak | Objek JSON berenkode URL yang berisi tambahan penyediaan. Elemen ini diteruskan ke DPC selama penyiapan perangkat. |
Contoh URL, dengan asumsi:
- Token Web dari API:
abcde
- DPC:
com.google.android.apps.work.clouddpc
- DPC Tambahan:
{“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.google.android.apps.work.clouddpc&dpcExtras={“server”:“www.example.com”,“enterprise”:”example_id”}
URL dienkode, URL ini akan menjadi:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.google.android.apps.work.clouddpc&dpcExtras=%7B%E2%80%9Cserver%E2%80%9D%3A%E2%80%9Cwww.example.com%E2%80%9D%2C%E2%80%9Centerprise%E2%80%9D%3A%E2%80%9Dexample_id%E2%80%9D%7D