Criar uma vinculação empresarial

Um recurso Enterprise vincula uma organização à sua solução de gerenciamento do Android. Devices e Policies pertencem a uma empresa. Várias vinculações corporativas podem ser associadas a uma única organização. Por exemplo, uma organização pode querer vinculações corporativas separadas para diferentes departamentos ou regiões.

As etapas básicas para criar uma vinculação empresarial são descritas no Guia de início rápido. Esta página descreve o processo com mais detalhes.

1. Recuperar o URL de inscrição

Chame signupUrls.create para recuperar o URL de inscrição e especifique os dois parâmetros a seguir:

  • callbackUrl: um URL HTTPS para o qual o assistente de configuração redireciona após a conclusão da inscrição. Geralmente, é o console de gerenciamento.
  • projectId: o ID do projeto.

A resposta contém um url e um name. Abra o url e anote a name.

2. O administrador de TI empresarial conclui o fluxo de inscrição

O url orienta o administrador de TI durante a inscrição. Se o EMM não tiver sido ativado para o fluxo de inscrição de BTE, informe ao administrador de TI que ele precisa de uma conta do Gmail que ainda não esteja associada a uma vinculação empresarial. Depois de registrar a organização, o fluxo de inscrição redireciona para seu callbackUrl. Um enterpriseToken é anexado ao callbackUrl.

Exemplo

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

3. Criar uma vinculação empresarial

Para criar uma vinculação empresarial, chame enterprises.create. Além de criar um ID de vinculação empresarial exclusivo, esse método permite definir algumas configurações específicas da vinculação. Por exemplo, é possível definir a cor predominante exibida durante o provisionamento do dispositivo (primaryColor), além do nome ou título (enterpriseDisplayName) e do logotipo (logo) que será mostrado aos usuários finais.

Exemplo

O exemplo a seguir usa a biblioteca de cliente Java para criar uma vinculação empresarial e retornar o nome dela. Consulte a página de exemplo para mais detalhes sobre como usar a 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) {
  ...
}