Crea una vinculación empresarial

Un recurso Enterprise vincula una organización con tu solución de Administración de Android. Devices y Policies pertenecen a una empresa. Varias vinculaciones de empresas pueden asociarse con una sola organización. Por ejemplo, es posible que una organización desee vinculaciones empresariales separadas para sus diferentes departamentos o regiones.

Los pasos básicos para crear una vinculación empresarial se describen en la Guía de inicio rápido. En esta página, se describe el proceso con más detalle.

1. Recupera la URL de registro

Llama a signupUrls.create para recuperar la URL de registro y especificar los siguientes dos parámetros:

  • callbackUrl: Es una URL HTTPS a la que redirecciona el asistente de configuración después de que se completa el registro. Por lo general, esta es tu consola de administración.
  • projectId: ID del proyecto

La respuesta contiene un url y un name. Abre el archivo url y anota el name.

2. Un administrador de TI empresarial completa el flujo de registro

El url guía al administrador de TI a través del proceso de registro. Si tu EMM no se habilitó para el flujo de registro de BTE, infórmale al administrador de TI que necesita una cuenta de Gmail que no esté asociada con una vinculación empresarial. Después de registrar correctamente la organización, el flujo de registro te redirecciona a tu callbackUrl. Se agrega un enterpriseToken a callbackUrl.

Ejemplo

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

3. Crea una vinculación empresarial

Para crear una vinculación de empresa, llama a enterprises.create. Además de crear un ID de vinculación empresarial único, este método te permite definir ciertas configuraciones específicas de la vinculación. Por ejemplo, puedes configurar el color predominante que se muestra durante el aprovisionamiento del dispositivo (primaryColor), junto con el nombre o título (enterpriseDisplayName) y el logotipo (logo) que se muestra a los usuarios finales.

Ejemplo

En el siguiente ejemplo, se usa la biblioteca cliente de Java para crear una vinculación empresarial y mostrar su nombre. Consulta la página de muestra para obtener más información sobre el uso de la biblioteca.

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