Una risorsa Enterprise
associa un'organizzazione alla tua soluzione Android Management.
Devices
e Policies
appartengono entrambi a un'azienda. A una singola organizzazione possono essere associate più associazioni aziendali. Ad esempio, un'organizzazione potrebbe voler
associare associazioni aziendali separate per i diversi reparti o le varie regioni.
I passaggi di base per la creazione di un'associazione aziendale sono descritti nella Guida rapida. Questa pagina descrive la procedura in modo più dettagliato.
1. Recupera l'URL di registrazione
Chiama il numero signupUrls.create
per recuperare l'URL di registrazione e specificare i seguenti due parametri:
callbackUrl: un URL HTTPS a cui reindirizza la configurazione guidata al termine della registrazione. Si tratta in genere della console di gestione.projectId: l'ID del tuo progetto.
La risposta contiene url e name. Apri il url e prendi nota del name.
2. L'amministratore IT aziendale completa la procedura di registrazione
Il url guida l'amministratore IT nella procedura di registrazione. Se il tuo provider EMM non è stato abilitato per il flusso di registrazione a BTE, comunica all'amministratore IT che ha bisogno di un account Gmail non ancora associato a un'associazione aziendale.
Dopo aver registrato correttamente l'organizzazione, il flusso di registrazione reindirizza al tuo callbackUrl. Un elemento enterpriseToken viene aggiunto a
callbackUrl.
Esempio
https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl
3. Crea un'associazione aziendale
Per creare un'associazione aziendale, chiama
enterprises.create.
Oltre a creare un ID di associazione aziendale univoco, questo metodo consente di definire determinate impostazioni specifiche per l'associazione. Ad esempio, puoi impostare il
colore predominante visualizzato durante il provisioning del dispositivo (primaryColor), insieme
al nome o al titolo (enterpriseDisplayName) e al logo
(logo) mostrati agli utenti finali.
Esempio
L'esempio seguente utilizza la libreria client Java per creare un'associazione aziendale e restituirne il nome. Consulta la pagina degli esempi per ulteriori dettagli sull'utilizzo della raccolta.
private String createEnterprise(AndroidManagement androidManagementClient)
throws IOException {
SignupUrl signupUrl =
androidManagementClient
.signupUrls()
.create()
.setProjectId("myProject")
.setCallbackUrl("https://example.com/myEmmConsole")
.execute();
String enterpriseToken = displayUrlToAdmin(signupUrl.getUrl());
Enterprise enterprise =
androidManagementClient
.enterprises()
.create(new Enterprise())
.setProjectId("myProject")
.setSignupUrlName(signupUrl.getName())
.setEnterpriseToken(enterpriseToken)
.execute();
return enterprise.getName();
}
/**
* Displays the signup URL to the admin and returns the enterprise token which
* is generated after the admin goes through the signup flow. This functionality
* must be implemented by your management console.
*/
private String displayUrlToAdmin(String url) {
...
}