Diese Seite wurde von der Cloud Translation API übersetzt.

Jetzt starten

Bevor Sie die Common Android Reseller Library verwenden können, müssen sich Reseller dem Knox-Bereitstellungsprogramm von Samsung und der Zero-Touch-Registrierung von Android anschließen.

Knox-Bereitstellungsprogramm

Führen Sie die folgenden Schritte aus, um KDP beizutreten und die erforderlichen Details abzurufen, um die Reseller-Bibliothek zu verwenden.

Schritt 1: Für KDP registrieren

Besuchen Sie Samsung Knox for Resellers, um sich für KDP zu registrieren.
Erstellen Sie ein Samsung-Konto und registrieren Sie sich als Reseller für ein Samsung Knox-Konto.
Melden Sie sich nach der Genehmigung Ihres Reseller-Kontos im KDP-Portal an, um Ihre resellerId zu finden.

Schritt 2: Zugriff auf das Knox Cloud API-Portal anfordern

Senden Sie eine Anfrage an Samsung, um Zugriff auf das Knox Cloud API-Portal zu erhalten.
Melden Sie sich im Knox Cloud API-Portal an.

Schritt 3: Dienstkontoschlüssel und `clientIdentifier` abrufen

Laden Sie die JSON-Datei des Schlüsselpaars aus dem Knox Cloud API-Portal herunter und speichern Sie sie an einem sicheren Ort.
Generieren Sie die eindeutige clientIdentifier aus dem Knox Cloud API-Portal.

Schritt 4: `SamsungResellerService`-Objekt erstellen

Verwenden Sie den JSON-Dateipfad clientIdentifier, resellerId, um das Objekt SamsungResellerService zur Verwendung der allgemeinen Bibliothek zu erstellen.

Zero-Touch-Registrierung

Schritt 1: Nehmen Sie am Programm für die Zero-Touch-Registrierung teil

Richten Sie die Zero-Touch-Registrierung ein.
Da die Common Reseller-Bibliothek die Reseller API verwendet, müssen Sie von Ihrem Berater für Google Platform-Lösungen Zugriff auf die Reseller API anfordern.
Fordern Sie Zugriff auf das Zero-Touch-Portal an.

Folgen Sie dem Google-Konto, das Sie für den Zugriff auf das Portal verwenden, der restlichen Anleitung, um ein Dienstkonto zu erstellen und die Reseller API zu aktivieren.

Schritt 2: Dienstkonto erstellen

Ein Dienstkonto, manchmal auch Robot-Konto genannt, ist ein Google-Konto, das Anwendungen anstelle von Nutzern darstellt. Da die Registrierungsbibliothek Google APIs im Namen des Dienstkontos aufruft, richten Sie den Zugriff mit der Google API Console ein.

API-Konsolenprojekt erstellen

Es empfiehlt sich, ein neues API-Konsolenprojekt und -Dienstkonto zu erstellen. Dies vereinfacht die Verwaltung des Zugriffs, das Verwalten von Ressourcen und das Korrigieren verlorener Schlüssel in der Zukunft. Führen Sie zuerst die folgenden Schritte aus, um ein neues Projekt in der Google API Console zu erstellen:

Rufen Sie die API-Konsole auf.
Wählen Sie in der Projektliste Projekt erstellen aus.
Geben Sie einen Namen ein, der Ihre App und die Zero-Touch-Registrierung beschreibt.
Geben Sie eine Projekt-ID an oder übernehmen Sie den Standardwert.
Klicken Sie auf Erstellen.

Weitere Informationen finden Sie im Google Cloud Platform-Dokument Projekte in der Console verwalten.

Neue Anmeldedaten für den Dienst hinzufügen

Führen Sie die folgenden Schritte in der API Console aus, um Ihrem Projekt neue Anmeldedaten und ein Dienstkonto hinzuzufügen.

Öffne die Seite Dienstkonten. Wähle ein Projekt aus, wenn du dazu aufgefordert wirst.
Klicke auf Dienstkonto erstellen und gib einen Namen und eine Beschreibung für das Dienstkonto ein. Du kannst die standardmäßige Dienstkonto-ID verwenden oder eine andere eindeutige ID auswählen. Wenn du fertig bist, klicke auf Erstellen.
Für den folgenden Abschnitt Dienstkontoberechtigungen (optional) sind keine Maßnahmen erforderlich. Klicke auf Weiter.
Scrolle auf dem Bildschirm Nutzern Zugriff auf dieses Dienstkonto erteilen nach unten zum Abschnitt Schlüssel erstellen. Klicke auf Schlüssel erstellen.
Wählen Sie in der angezeigten Seitenleiste das Format für Ihren Schlüssel aus: JSON wird empfohlen.
Klicken Sie auf Erstellen. Dein neues öffentliches/privates Schlüsselpaar wird generiert und auf deinen Computer heruntergeladen. Dies ist die einzige Kopie dieses Schlüssels. Informationen dazu, wie du den Schlüssel sicher speicherst, findest du unter Dienstkontoschlüssel verwalten.
Klicke im Dialogfeld Privater Schlüssel auf deinem Computer gespeichert auf Schließen und dann auf Fertig, um zur Tabelle deiner Dienstkonten zurückzukehren.

Kopieren Sie die E-Mail-Adresse des Dienstkontos und halten Sie sie bereit. Sie benötigen es später, wenn Sie das Dienstkonto mit Ihrer Organisation verknüpfen.

Schritt 3: JSON-Schlüsseldatei speichern

Die API Console generiert ein neues privates Schlüsselpaar, mit dem API-Aufrufe über Ihr Dienstkonto authentifiziert werden. Der private Schlüssel befindet sich in der heruntergeladenen JSON-Schlüsseldatei.

Achten Sie darauf, dass der Schlüssel privat bleibt. Fügen Sie ihn daher nicht in den Quellcode Ihrer Software ein. Wenn Sie die Schlüsseldatei verlieren, müssen Sie ein neues Schlüsselpaar generieren.

Weitere Informationen zum sicheren Speichern der Schlüsseldatei finden Sie unter Best Practices für die sichere Verwendung von API-Schlüsseln.

Schritt 4: API aktivieren

Bevor die Bibliothek die Reseller API verwenden kann, müssen Sie sie aktivieren. Wenn Sie eine API aktivieren, wird sie mit dem aktuellen API-Konsolenprojekt verknüpft und Monitoringseiten in der Console hinzugefügt.

So aktivieren Sie die Reseller API in der API Console:

Klicken Sie auf APIs und Dienste & gt; Bibliothek.
Suchen Sie über das Suchfeld nach der Android Device Provisioning Partner API.
Klicken Sie auf Android Device Provisioning Partner API.
Klicken Sie auf Aktivieren.

Nach einer kurzen Verzögerung ändert sich der API-Status zu „Aktiviert“. Wenn die Android Device Provisioning Partner API nicht angezeigt wird, prüfen Sie, ob für Ihre Organisation die Zero-Touch-Registrierung aktiviert ist. Achten Sie darauf, dass Sie für die Zero-Touch-Registrierung und die Google API Console dasselbe Google-Konto verwenden. Fragen Sie Ihren Berater für Google-Plattformlösungen, ob Ihr Google-Konto Zugriff auf die API hat.

Schritt 5: Dienstkonto verknüpfen

Durch das Verknüpfen des Dienstkontos mit dem Konto für die Zero-Touch-Registrierung Ihrer Organisation wird das Dienstkonto autorisiert, API-Aufrufe im Namen Ihrer Organisation auszuführen. So verknüpfen Sie Ihr Dienstkonto:

Öffnen Sie das Portal für die Zero-Touch-Registrierung. Möglicherweise müssen Sie sich im Portal anmelden.
Klicken Sie auf Dienstkonten.
Klicken Sie auf Dienstkonto verknüpfen.
Geben Sie unter E-Mail-Adresse die Adresse des von Ihnen erstellten Dienstkontos an.
Klicken Sie auf Dienstkonto verknüpfen, um das Dienstkonto mit Ihrem Konto für die Zero-Touch-Registrierung zu verwenden.

Wenn du die E-Mail-Adresse des von dir erstellten Dienstkontos nicht findest, kopiere sie von einer der folgenden Stellen:

Eine Dienstkonto-ID von der Seite Dienstkonten in der Google API Console.
Das Attribut client_email in der JSON-Schlüsseldatei

Sie können jetzt Ihr Dienstkonto mit der Registrierungsbibliothek verwenden, um ResellerService-Objekte zu erstellen.

Common Android Reseller Library zu einem Gradle-Projekt hinzufügen

Die Bibliothek ist als Maven-Repository verfügbar. So fügen Sie die Bibliothek einem neuen Gradle-Projekt hinzu:

Führen Sie den folgenden Befehl aus, um ein neues Projekt zu erstellen:
```
gradle init --type basic
mkdir -p src/main/java src/main/resources
```
Kopieren Sie die in Schritt 2 heruntergeladene Datei service_account_key.json in das oben erstellte Verzeichnis src/main/resources/.
Öffnen Sie die Standarddatei build.gradle und deklarieren Sie das zentrale Maven-Repository für Ihren Build:
```
repositories {
    mavenCentral()
}
```

Fügen Sie in derselben Datei die folgende Abhängigkeit hinzu:

dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

Ihr Projekt sollte jetzt die Clientbibliothek verwenden können, um Android-Geräte zu registrieren.

Nächste Schritte: Häufige Vorgänge