Con l'iframe zero-touch, puoi incorporare la registrazione zero-touch direttamente nella tua console EMM per consentire ai clienti di configurare facilmente i dispositivi compatibili con la registrazione zero-touch con Android Device Policy. L'iframe ti consente di impostare gli extra di provisioning utilizzati durante la configurazione zero-touch del dispositivo.
![iframe zero-touch](https://developers.google.cn/static/android/management/images/zt-iframe-home-amapi.png?authuser=8&hl=it)
La prima volta che un amministratore IT apre l'iframe, gli verrà chiesto di collegare l'account zero-touch all'azienda.
Dopo che un amministratore IT ha collegato un account zero-touch alla propria azienda, l'iframe mostrerà l'elenco degli account zero-touch collegati. Possono anche vedere la configurazione zero-touch predefinita impostata per i dispositivi aziendali.
Funzionalità
Questa sezione descrive le funzionalità disponibili nell'iframe zero-touch. Per informazioni su come incorporare l'iframe e implementare queste funzionalità, consulta Aggiungere l'iframe alla console.
Collegare un account zero-touch a un'azienda
L'iframe consente agli amministratori IT di collegare l'account zero-touch alla propria azienda. Nell'ambito di questo processo, l'amministratore IT crea un profilo zero-touch predefinito da utilizzare per i dispositivi all'interno dell'account zero-touch. Questo flusso è descritto di seguito.
Se l'amministratore IT non ha collegato in precedenza un account zero-touch alla propria azienda, viene invitato a farlo quando apre l'iframe.
![flusso di collegamento a iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-link.png?authuser=8&hl=it)
L'amministratore IT visualizza un elenco di account zero-touch e può scegliere uno o più account da collegare alla propria azienda.
![Schermata dell'elenco di account iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-choose-accounts.png?authuser=8&hl=it)
![schermata di configurazione dell'iframe zero-touch](https://developers.google.cn/static/android/management/images/zt-iframe-show-dpc-amapi.png?authuser=8&hl=it)
L'iframe zero-touch genera automaticamente una configurazione zero-touch. Questa configurazione non è modificabile dall'amministratore IT. Puoi personalizzare gli extra di provisioning da utilizzare in questa configurazione. Per ulteriori informazioni su come eseguire questa operazione, consulta la pagina Parametri URL iframe.
![schermata di informazioni sull'assistenza per l'iframe zero-touch](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-support-info.png?authuser=8&hl=it)
L'amministratore IT inserisce le informazioni di assistenza che vengono visualizzate quando vengono configurati dispositivi abilitati per la registrazione zero-touch. Quando l'amministratore IT fa clic su "Salva", la procedura di collegamento completa e l'utente viene reindirizzato alla home page dell'iframe zero-touch, dove può gestire i propri account collegati.
Visualizza e gestisci gli account zero-touch collegati
L'iframe consente agli amministratori IT di visualizzare gli account zero-touch collegati, nonché il profilo zero-touch predefinito e le informazioni di assistenza. Inoltre, può collegare altri account zero-touch e scollegare gli account zero-touch.
Vedi la Figura 1 per un esempio di visualizzazione della home page dell'iframe zero-touch.
Visualizzare i dispositivi degli account collegati nel portale della registrazione zero-touch
Quando un account zero-touch è collegato a un'azienda, tutti i dispositivi al suo interno che non sono configurati con un profilo zero-touch vengono configurati automaticamente con il profilo zero-touch aziendale.
All'interno della console zero-touch, per questi dispositivi è visualizzata la configurazione "Profilo predefinito aziendale". L'amministratore IT può impostare e annullare l'impostazione di questo profilo su qualsiasi dispositivo nell'account zero-touch. Tuttavia, il profilo non può essere modificato.
Se l'account zero-touch è scollegato, questo profilo non sarà configurato su tutti i dispositivi configurati con il "profilo predefinito aziendale". Questi dispositivi possono essere configurati con un profilo diverso.
Aggiungi l'iframe alla tua console
Passaggio 1: genera un token web
Chiama enterprises.webTokens.create
per generare un token web che identifichi l'azienda. La risposta contiene
il value
del token.
- Imposta
parentFrameUrl
sull'URL del frame principale che ospita l'iframe. - Utilizza
iframeFeature
per specificare quali funzionalità attivare nell'iframe: "ZERO_TOUCH". SeiframeFeature
non è impostato, l'iframe abilita tutte le funzionalità per impostazione predefinita.
Devi includere il token restituito, insieme ad altri parametri, durante il rendering dell'iframe nella tua console.
Passaggio 2: esegui il rendering dell'iframe
Ecco un esempio di come eseguire il rendering dell'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>
Questo codice genera un iframe all'interno del contenitore div. Gli attributi da applicare al tag iframe possono essere impostati con l'opzione "attributes", come sopra.
Parametri URL iframe
La tabella seguente elenca tutti i parametri disponibili per l'iframe che possono essere aggiunti all'URL come parametri URL, ad es.
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.google.android.apps.work.clouddpc
Parametro | Obbligatorie | Descrizione |
---|---|---|
token |
Sì | Il token restituito dal passaggio 1. |
dpcId |
Sì | Il nome del pacchetto dell'app DPC. Dovresti impostarlo sempre sull'ID di Android Device Policy, com.google.android.apps.work.clouddpc .
|
dpcExtras |
No | Oggetto JSON con codifica URL contenente extra di provisioning. Questi vengono trasmessi al DPC durante la configurazione del dispositivo. |
URL di esempio presupponendo:
- Token web dell'API:
abcde
- DPC:
com.google.android.apps.work.clouddpc
- DPC extra:
{“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”}
Con l'URL codificato, l'URL sarà:
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