Iframe zero-touch

Dengan Zero-touch iframe, Anda dapat menyematkan zero-touch langsung ke konsol EMM agar pelanggan dapat dengan mudah mengonfigurasi perangkat yang mendukung zero-touch dengan DPC Anda. iframe memungkinkan Anda mengonfigurasi DPC dan menyediakan tambahan yang digunakan selama penyiapan perangkat zero-touch.

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

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.

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.

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
Gambar 3. Layar daftar akun
layar konfigurasi iframe zero-touch
Gambar 4. Layar konfigurasi

Iframe Zero-touch secara otomatis menghasilkan konfigurasi zero-touch. Konfigurasi ini tidak dapat diubah oleh admin IT. Anda dapat menyesuaikan DPC atau tambahan penyediaan yang akan digunakan dalam konfigurasi ini. Untuk informasi lebih lanjut 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 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

Untuk membuat token web yang mengidentifikasi perusahaan, panggil Enterprises.createWebToken. Contoh berikut menunjukkan cara mengambil token menggunakan Library Klien Google Play EMM API untuk Java. Perhatikan bahwa iframe Zero-touch harus diaktifkan secara terpisah dari iframe Play yang terkelola.

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setZeroTouch(new AdministratorWebTokenSpecZeroTouch());
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

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.example.app',,
      '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.afwsamples.testdpc
Parameter Wajib Deskripsi
token Ya Token yang ditampilkan dari Langkah 1.
dpcId Ya Nama paket aplikasi DPC, yaitu com.example.app. Setelan ini wajib diisi. DPC harus sudah dikaitkan dengan EMM Anda.
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.example
  • DPC Tambahan: {“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&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.example&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