Element iframe do rejestracji typu zero-touch pozwala umieścić taką rejestrację bezpośrednio w konsoli EMM, aby ułatwić klientom konfigurowanie za pomocą kontrolera DPC urządzeń obsługujących taką rejestrację. Element iframe umożliwia skonfigurowanie kontrolera DPC i akcesoriów obsługi administracyjnej używanych podczas konfiguracji urządzenia obsługującego rejestrację typu zero-touch.
Gdy administrator IT otworzy element iframe po raz pierwszy, pojawi się prośba o połączenie konta do rejestracji zero-touch z firmą.
Gdy administrator IT połączy konto do rejestracji zero-touch z firmą, w elemencie iframe pojawi się lista połączonych kont do rejestracji zero-touch. Mogą też zobaczyć domyślną konfigurację rejestracji typu zero-touch ustawioną dla urządzeń firmowych.
Funkcje
W tej sekcji opisujemy funkcje dostępne w elementach iframe do rejestracji typu zero-touch. Informacje o umieszczaniu elementu iframe i stosowaniu tych funkcji znajdziesz w artykule Dodawanie elementu iframe do konsoli.
Łączenie konta do rejestracji zero-touch z firmą
Element iframe umożliwia administratorowi IT połączenie konta do rejestracji zero-touch z firmą. W ramach tego procesu administrator IT tworzy domyślny profil rejestracji typu zero-touch dla urządzeń na koncie tego typu. Szczegółowo opisujemy to poniżej.
Jeśli administrator IT nie połączył wcześniej konta do rejestracji zero-touch z firmą, pojawi się prośba o to po otwarciu elementu iframe.
Administrator IT widzi listę kont do rejestracji zero-touch i może wybrać jedno lub kilka kont, które chce połączyć ze swoją firmą.
Element iframe do rejestracji typu zero-touch automatycznie generuje konfigurację rejestracji typu zero-touch. Tej konfiguracji nie może zmienić administrator. Możesz dostosować dodatki DPC lub udostępnianie, których chcesz używać w tej konfiguracji. Więcej informacji o tym, jak to zrobić, znajdziesz w sekcji Parametry adresu URL iframe.
Administrator IT wpisuje informacje o pomocy, które pojawiają się podczas konfigurowania urządzeń z obsługą rejestracji typu zero-touch. Gdy administrator IT kliknie „Zapisz”, proces łączenia zostanie ukończony, a użytkownik zostanie przekierowany na stronę główną elementu iframe do rejestracji zero-touch, na której może zarządzać połączonymi kontami.
Wyświetlanie połączonych kont do rejestracji zero-touch i zarządzanie nimi
Element iframe umożliwia administratorowi IT wyświetlanie powiązanych kont do rejestracji zero-touch, domyślnego profilu zero-touch oraz informacji o pomocy. Mogą też łączyć dodatkowe konta do rejestracji zero-touch i odłączać konta do rejestracji zero-touch.
Rysunek 1 przedstawia przykładowy widok strony głównej elementu iframe z rejestracją typu zero-touch.
Wyświetlanie urządzeń z połączonych kont w portalu rejestracji typu zero-touch
Gdy konto do rejestracji zero-touch jest połączone z firmą, wszystkie urządzenia na tym koncie, które nie są skonfigurowane pod kątem takiego profilu, są automatycznie konfigurowane w profilu firmy.
W konsoli zero-touch te urządzenia są wyświetlane z konfiguracją „Domyślny profil firmy”. Administrator IT może skonfigurować ten profil i usunąć go na dowolnym urządzeniu na koncie do rejestracji zero-touch. Nie można go jednak modyfikować.
Jeśli konto do rejestracji zero-touch zostanie rozłączone, profil zostanie wyłączony na wszystkich urządzeniach skonfigurowanych z ustawieniem „Domyślny profil firmy”. Te urządzenia można skonfigurować za pomocą innego profilu.
Dodawanie elementu iframe do konsoli
Krok 1. Wygeneruj token internetowy
Aby wygenerować token internetowy, który identyfikuje firmę, wywołaj Enterprises.createWebToken.
Poniższy przykład pokazuje, jak pobrać token za pomocą biblioteki klienta interfejsu API Google Play EMM dla Javy.
Pamiętaj, że element iframe do rejestracji zero-touch należy włączyć niezależnie od elementu iframe zarządzanego Sklepu Play.
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();
}
Podczas renderowania elementu iframe w konsoli musisz uwzględnić zwrócony token wraz z innymi parametrami.
Krok 2. Renderuj element iframe
Oto przykład renderowania elementu iframe do rejestracji typu 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>
Ten kod generuje element iframe wewnątrz elementu div kontenera. Atrybuty, które mają być stosowane do tagu iframe, można ustawić za pomocą opcji „Atrybuty”, tak jak powyżej.
Parametry adresu URL elementu iframe
W tabeli poniżej znajdziesz wszystkie dostępne parametry elementu iframe, które możesz dodać do adresu URL jako parametry adresu URL, np.
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.afwsamples.testdpc
| Parametr | Wymagane | Opis |
|---|---|---|
token |
Tak | Token zwrócony z kroku 1. |
dpcId |
Tak | Nazwa pakietu aplikacji DPC, np. com.example.app.
Ustawienie jest wymagane. DPC musi być już powiązany z Twoim dostawcą usług EMM.
|
dpcExtras |
Nie | Zakodowany w adresie URL obiekt JSON zawierający dodatki do obsługi administracyjnej. Są one przekazywane do kontrolera DPC podczas konfiguracji urządzenia. |
Przykładowy adres URL, zakładając, że:
- Token internetowy z interfejsu API:
abcde - DPC:
com.example - Dodatki DPC:
{“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”}
Adres URL zakodowany będzie wyglądać tak:
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