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