Iframe zero-touch

Dengan iframe zero-touch, Anda dapat menyematkan zero-touch langsung ke konsol EMM agar pelanggan dapat mengonfigurasi perangkat yang mendukung zero-touch dengan mudah menggunakan Android Device Policy. Iframe memungkinkan Anda menetapkan tambahan penyediaan yang digunakan selama penyiapan perangkat zero-touch.

iframe zero-touch
Gambar 1. Iframe zero-touch yang menampilkan halaman beranda zero-touch.

Saat pertama kali admin IT membuka iframe, admin akan diminta untuk menautkan akun zero-touch mereka ke perusahaan.

Setelah admin IT menautkan akun zero-touch ke perusahaan, iframe akan menampilkan daftar akun zero-touch yang tertaut. Mereka 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 ini, lihat Menambahkan iframe ke konsol.

Dengan iframe, admin IT dapat menautkan akun zero-touch dan perusahaan mereka. Sebagai bagian dari proses ini, admin IT membuat profil zero-touch default yang akan digunakan untuk perangkat di dalam akun zero-touch. Alur ini dijelaskan di bawah.

Jika sebelumnya admin IT belum menautkan akun zero-touch ke perusahaannya, admin tersebut akan diminta untuk melakukannya saat membuka iframe.

Admin IT melihat daftar akun zero-touch dan dapat memilih satu atau beberapa link untuk ditautkan ke perusahaan.

layar daftar akun iframe zero-touch
Gambar 3. Layar daftar akun
layar konfigurasi iframe zero-touch
Gambar 4. Layar konfigurasi

Iframe zero-touch secara otomatis membuat konfigurasi zero-touch. Konfigurasi ini tidak dapat diubah oleh admin IT. Anda dapat menyesuaikan tambahan penyediaan yang akan digunakan dalam konfigurasi ini. Untuk informasi selengkapnya tentang cara melakukannya, lihat parameter URL iframe.

layar informasi dukungan iframe zero-touch
Gambar 5. Layar entri info dukungan

Admin IT memasukkan informasi dukungan yang muncul saat perangkat berkemampuan zero-touch disiapkan. Saat admin IT mengklik “simpan”, proses penautan akan selesai dan pengguna akan dialihkan ke halaman beranda iframe zero-touch, tempat mereka dapat mengelola akun tertautnya.

Melihat dan mengelola akun zero-touch yang tertaut

Dengan iframe, admin IT dapat melihat akun zero-touch tertaut serta profil dukungan dan profil zero-touch default-nya. 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 dikonfigurasi secara otomatis dengan profil zero-touch Enterprise.

Di dalam konsol zero-touch, perangkat ini ditampilkan dengan konfigurasi “Profil default perusahaan”. Admin IT dapat menetapkan dan membatalkan penetapan profil ini pada 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" akan membatalkan setelan profil ini. Perangkat ini dapat dikonfigurasi dengan profil yang berbeda.

Menambahkan iframe ke konsol

Langkah 1: Buat token web

Panggil enterprises.webTokens.create untuk membuat token web yang mengidentifikasi perusahaan. Respons ini berisi value token.

  • Tetapkan parentFrameUrl ke URL frame induk yang menghosting iframe.
  • Gunakan iframeFeature untuk menentukan fitur yang akan diaktifkan di iframe: 'ZERO_TOUCH'. Jika iframeFeature tidak ditetapkan, iframe akan mengaktifkan semua fitur secara default.

Anda harus menyertakan token yang ditampilkan, beserta parameter lainnya, saat merender iframe di konsol.

Langkah 2: Render iframe

Berikut 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 dalam div penampung. Atribut yang akan diterapkan ke tag iframe dapat ditetapkan dengan opsi 'atribut', seperti di atas.

Parameter URL iframe

Tabel di bawah 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 menetapkan ini ke ID Android Device Policy, com.google.android.apps.work.clouddpc.
dpcExtras Tidak Objek JSON berenkode URL yang berisi tambahan penyediaan. Hal ini akan diteruskan ke DPC selama penyiapan perangkat.

Contoh URL, dengan asumsi:

  • Token Web dari API: abcde
  • DPC: com.google.android.apps.work.clouddpc
  • Tambahan DPC: {“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 yang 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