Diese Seite wurde von der Cloud Translation API übersetzt.

Jetzt starten

Bevor Reseller die Common Android Reseller Library verwenden können, müssen sie am Knox-Bereitstellungsprogramm von Samsung und der Android-Zero-Touch-Registrierung teilnehmen.

Knox Deployment Program (KDP)

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

Schritt 1: Für KDP registrieren

Samsung Knox für Reseller

Erstellen Sie ein Samsung-Konto und registrieren Sie sich als Reseller für ein Samsung Knox-Konto.

Nachdem Ihr Resellerkonto genehmigt wurde, melden Sie sich 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 Ihre eindeutige clientIdentifier im Knox Cloud API-Portal.

Schritt 4: `SamsungResellerService`-Objekt erstellen

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

Zero-Touch-Registrierung

Schritt 1: Am Programm für die Zero-Touch-Registrierung teilnehmen

Führen Sie die Einrichtung mit der Zero-Touch-Registrierung durch.
Da die Common Android Reseller Library die Reseller API verwendet, müssen Sie den Zugriff auf die Reseller API von Ihrem Berater für Google Platform-Lösungen anfordern.
Antrag auf Zugriff auf das Zero-Touch-Portal stellen

Verwenden Sie dasselbe Google-Konto, das Sie benutzen, um auf das Portal zuzugreifen, und folgen Sie den übrigen Anweisungen zum Erstellen eines Dienstkontos und aktivieren Sie die Reseller API.

Schritt 2: Dienstkonto erstellen

Ein Dienstkonto, manchmal auch als Roboterkonto bezeichnet, ist ein Google-Konto, das Apps und keine Nutzer vertritt. Da die Registrierungsbibliothek Google APIs im Namen des Dienstkontos aufruft, verwenden Sie die Google API Console, um den Zugriff einzurichten.

API Console-Projekt erstellen

Wir empfehlen, ein neues API Console-Projekt und ein Dienstkonto zu erstellen. Dadurch wird die Zugriffsverwaltung, die Ressourcenverwaltung und die Problembehebung bei verlorenen Schlüsseln in Zukunft einfacher. Folgen Sie der Anleitung unten, um ein neues Projekt in der Google API Console zu erstellen:

Rufen Sie die API Console auf.
Wählen Sie in der Projektliste Projekt erstellen aus.
Vergeben Sie einen Namen, der Ihre App und die Zero-Touch-Registrierung beschreibt.
Legen Sie eine Projekt-ID fest oder übernehmen Sie die Standard-ID.
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

So fügen Sie Ihrem Projekt neue Anmeldedaten und ein Dienstkonto hinzu:

Ö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ähle in der angezeigten Seitenleiste das Format für deinen Schlüssel aus. Empfohlen wird JSON.
Klicke 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 und speichern Sie die E-Mail-Adresse des Dienstkontos. Sie benötigen sie 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-Anrufe über Ihr Dienstkonto authentifiziert werden. Der private Schlüssel befindet sich in der JSON-Schlüsseldatei, die Sie herunterladen.

Behandeln Sie den Schlüssel vertraulich und integrieren Sie ihn nicht in den Quellcode Ihrer Software. 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 zur sicheren Verwendung von API-Schlüsseln.

Schritt 4: API aktivieren

Sie müssen die Reseller API aktivieren, damit sie von der Bibliothek verwendet werden kann. Wenn Sie eine API aktivieren, wird sie dem aktuellen API Console-Projekt zugeordnet und Monitoringseiten werden in Ihrer Console hinzugefügt.

Führen Sie die folgenden Schritte in Ihrer API Console aus, um die Reseller API zu aktivieren:

Klicken Sie auf APIs und Dienste > Bibliothek.
Verwenden Sie das Suchfeld, um die Android Device Provisioning Partner API zu finden.
Klicken Sie auf Android Device Provisioning Partner API.
Klicken Sie auf Aktivieren.

Nach wenigen Momenten wird die API aktiviert. Wenn Sie die Android Device Provisioning Partner API nicht sehen, prüfen Sie, ob Ihre Organisation in die Zero-Touch-Registrierung aufgenommen wurde. Achte darauf, dasselbe Google-Konto für die Zero-Touch-Registrierung und die Google API Console zu verwenden. Bitten Sie Ihren Google-Berater für Plattformlösungen zu prüfen, ob Ihr Google-Konto Zugriff auf die API hat.

Schritt 5: Dienstkonto verknüpfen

Wenn Sie das Dienstkonto mit dem Konto für die Zero-Touch-Registrierung Ihrer Organisation verknüpfen, 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. Eventuell musst du dich anmelden.
Klicken Sie auf Dienstkonten.
Klicken Sie auf Dienstkonto verknüpfen.
Legen Sie als E-Mail-Adresse die Adresse des von Ihnen erstellten Dienstkontos fest.
Klicken Sie auf Dienstkonto verknüpfen, um das Dienstkonto mit Ihrem Zero-Touch-Registrierungskonto zu verwenden.

Wenn Sie die E-Mail-Adresse des von Ihnen erstellten Dienstkontos nicht finden können, kopieren Sie sie an einem der folgenden Orte:

Eine Dienstkonto-ID von der Seite Dienstkonten in der Google API Console.
Das Attributfeld 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 Datei service_account_key.json, die Sie in Schritt 2 heruntergeladen haben, in das Verzeichnis src/main/resources/, das Sie oben erstellt haben.
Ö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:Gängige Vorgänge