Unternehmensbindung erstellen

Eine Enterprise-Ressource bindet eine Organisation an Ihre Android-Verwaltungslösung. Devices und Policies gehören beide zu einem Unternehmen. Mehrere Unternehmensbindungen können mit einer einzelnen Organisation verknüpft werden. Beispielsweise kann eine Organisation separate Unternehmensbindungen für die verschiedenen Abteilungen oder Regionen wünschen.

Die grundlegenden Schritte zum Erstellen einer Unternehmensbindung werden in der Kurzanleitung beschrieben. Auf dieser Seite wird der Prozess ausführlicher beschrieben.

1. Registrierungs-URL abrufen

Rufen Sie signupUrls.create auf, um die Registrierungs-URL abzurufen, und geben Sie die folgenden beiden Parameter an:

  • callbackUrl: Eine HTTPS-URL, an die der Einrichtungsassistent nach Abschluss der Registrierung weiterleitet. Das ist normalerweise Ihre Verwaltungskonsole.
  • projectId: Ihre Projekt-ID.

Die Antwort enthält url und name. Öffnen Sie url und notieren Sie sich die name.

2. IT-Administrator des Unternehmens schließt die Registrierung ab

Das url führt den IT-Administrator durch den Registrierungsprozess. Wenn Ihr EMM nicht für den BTE-Registrierungsvorgang aktiviert ist, teilen Sie dem IT-Administrator mit, dass er ein Gmail-Konto benötigt, das noch nicht mit einer Unternehmensbindung verknüpft ist. Nachdem die Organisation registriert wurde, wird der Registrierungsvorgang zu deiner callbackUrl weitergeleitet. Ein enterpriseToken wird an callbackUrl angehängt.

Beispiel

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

3. Unternehmensbindung erstellen

Rufen Sie zum Erstellen einer Unternehmensbindung enterprises.create auf. Mit dieser Methode können Sie nicht nur eine eindeutige Unternehmensbindungs-ID erstellen, sondern auch bestimmte bindungsspezifische Einstellungen definieren. Sie können beispielsweise die vorrangige Farbe festlegen, die bei der Gerätebereitstellung (primaryColor) angezeigt wird, zusammen mit dem Namen oder Titel (enterpriseDisplayName) und dem Logo (logo), die Endnutzer sehen.

Beispiel

Im folgenden Beispiel wird die Java-Clientbibliothek verwendet, um eine Unternehmensbindung zu erstellen und ihren Namen zurückzugeben. Weitere Informationen zur Verwendung der Bibliothek findest du auf der Beispielseite.

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