Créer une liaison d'entreprise

Une ressource Enterprise associe une organisation à votre solution de gestion Android. Devices et Policies appartiennent tous deux à une entreprise. Plusieurs liaisons d'entreprise peuvent être associées à une même organisation. Par exemple, une organisation peut souhaiter des liaisons d'entreprise distinctes pour ses différents services ou régions.

Les étapes de base pour créer une liaison d'entreprise sont décrites dans le guide de démarrage rapide. Cette page décrit le processus plus en détail.

1. Récupérer l'URL d'inscription

Appelez signupUrls.create pour récupérer l'URL d'inscription et spécifier les deux paramètres suivants:

  • callbackUrl: URL https vers laquelle l'assistant de configuration redirige une fois l'inscription terminée. Il s'agit généralement de votre console de gestion.
  • projectId : ID de votre projet

La réponse contient url et name. Ouvrez url et notez name.

2. Un administrateur informatique de l'entreprise termine la procédure d'inscription

L'url guide l'administrateur informatique tout au long du processus d'inscription. Si votre EMM n'a pas été activé pour le processus d'inscription à BTE, indiquez à l'administrateur informatique qu'il a besoin d'un compte Gmail qui n'est pas déjà associé à une liaison d'entreprise. Une fois son organisation enregistrée, le flux d'inscription le redirige vers votre callbackUrl. Un enterpriseToken est ajouté au callbackUrl.

Exemple

https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl

3. Créer une liaison d'entreprise

Pour créer une liaison d'entreprise, appelez enterprises.create. En plus de créer un ID de liaison d'entreprise unique, cette méthode vous permet de définir certains paramètres spécifiques à la liaison. Par exemple, vous pouvez définir la couleur principale affichée lors du provisionnement de l'appareil (primaryColor), ainsi que le nom ou le titre (enterpriseDisplayName) et le logo (logo) que verront les utilisateurs finaux.

Exemple

L'exemple suivant utilise la bibliothèque cliente Java pour créer une liaison d'entreprise et renvoyer son nom. Pour en savoir plus sur l'utilisation de la bibliothèque, consultez la page de l'exemple.

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) {
  ...
}