Jetzt starten

Bevor Reseller die Common Android Reseller Library nutzen können, müssen sie sich beim Knox-Bereitstellungsprogramm und die Zero-Touch-Registrierung von Android.

Knox-Bereitstellungsprogramm (KDP)

Folgen Sie der Anleitung unten, um KDP beizutreten. und rufen Sie die erforderlichen Details ab, um mit der Verwendung der Reseller-Bibliothek zu beginnen.

Schritt 1: Bei KDP anmelden

  1. Besuchen Sie Samsung Knox für Reseller. um sich für KDP zu registrieren.
  2. Erstellen Sie ein Samsung-Konto und registrieren Sie sich für ein Samsung Knox-Konto als Reseller.
  3. Nachdem Ihr Reseller-Konto genehmigt wurde, melden Sie sich im KDP-Portal an, um Ihre resellerId zu finden.

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

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

Schritt 3: Dienstkontoschlüssel und clientIdentifier abrufen

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

Schritt 4: SamsungResellerService-Objekt erstellen

Verwenden Sie den JSON-Dateipfad clientIdentifier, resellerId, um die SamsungResellerService-Objekt, um die allgemeine Bibliothek zu verwenden.

Zero-Touch-Registrierung

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

  1. Nutzen Sie die Zero-Touch-Registrierung.
  2. Da die Common Android Reseller Library die Reseller API verwendet, müssen Sie über die Google-Plattform Zugriff auf die Reseller API anfordern. Berater.
  3. Zugriff auf das Zero-Touch-Portal anfordern

Folgen Sie mit demselben Google-Konto, mit dem Sie auch auf das Portal zugreifen, den verbleibenden Schritte zum Erstellen eines Dienstkontos und Aktivieren der Reseller API.

Schritt 2: Dienstkonto erstellen

Ein Dienstkonto, manchmal auch als Robot-Konto bezeichnet, ist ein Google-Konto für Apps und nicht für Nutzer. Da die Registrierungsbibliothek Google APIs im Namen des Dienstkontos verwenden Sie die Google API Console, um Zugriff erhalten.

API Console-Projekt erstellen

Es empfiehlt sich, ein neues API Console-Projekt und einen neuen Dienst zu erstellen. Konto. So lassen sich Zugriff und Ressourcen sowie verloren gegangene Schlüssel verwalten. in Zukunft einfacher. Führen Sie zuerst die folgenden Schritte aus, um ein neues Projekt zu erstellen in der Google API Console:

  1. Rufen Sie die API Console auf.
  2. Wählen Sie in der Projektliste Projekt erstellen
  3. Vergeben Sie einen Namen, der Ihre App und die Zero-Touch-Registrierung beschreibt.
  4. Legen Sie eine Projekt-ID fest oder übernehmen Sie die Standard-ID.
  5. Klicken Sie auf Erstellen.

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

Neue Anmeldedaten für den Dienst hinzufügen

Folgen Sie der Anleitung, um Ihrem Projekt neue Anmeldedaten und ein Dienstkonto hinzuzufügen. unten in Ihrer API-Konsole.

  1. Öffne die Seite Dienstkonten. Wähle ein Projekt aus, wenn du dazu aufgefordert wirst.
  2. 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.
  3. Für den folgenden Abschnitt Dienstkontoberechtigungen (optional) sind keine Maßnahmen erforderlich. Klicke auf Weiter.
  4. Scrolle auf dem Bildschirm Nutzern Zugriff auf dieses Dienstkonto erteilen nach unten zum Abschnitt Schlüssel erstellen. Klicke auf Schlüssel erstellen.
  5. Wähle in der angezeigten Seitenleiste das Format für deinen Schlüssel aus. Empfohlen wird JSON.
  6. 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.
  7. 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. Benötigt wenn Sie das Dienstkonto mit Ihrer Organisation verknüpfen.

Schritt 3: JSON-Schlüsseldatei speichern

Die API Console generiert ein neues privates Schlüsselpaar für die Authentifizierung API-Aufrufe, die mit Ihrem Dienstkonto ausgeführt wurden. Der private Schlüssel befindet sich im JSON-Schlüssel heruntergeladene Datei.

Behandeln Sie den Schlüssel vertraulich und fügen Sie ihn nicht in die Quelle Ihrer Software ein. Code. 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 API-Schlüssel sicher verwenden.

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 Monitoring-Seiten zu Ihrer Konsole hinzufügen.

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

  1. Klicken Sie auf APIs und Dienste > Mediathek:
  2. Verwenden Sie das Suchfeld, um die Android Device Provisioning Partner API zu finden.
  3. Klicken Sie auf Android Device Provisioning Partner API.
  4. Klicken Sie auf Aktivieren.

Nach wenigen Momenten wird die API aktiviert. Wenn Sie die Android Device Provisioning Partner API, prüfen Sie, ob die Zero-Touch-Registrierung integriert. Achten Sie darauf, dass Sie dieselben Konto für die Zero-Touch-Registrierung und die Google API Console. Frag dein Google Berater für Plattformlösungen, um zu prüfen, ob Ihr Google-Konto Zugriff auf die API verwenden.

Dienstkonto mit der Zero-Touch-Registrierung Ihrer Organisation verknüpfen autorisiert das Dienstkonto, API-Aufrufe im Namen Ihres Unternehmen. So verknüpfen Sie Ihr Dienstkonto:

  1. Öffnen Sie das Portal für die Zero-Touch-Registrierung. Eventuell musst du dich anmelden.
  2. Klicken Sie auf Service Konten.
  3. Klicken Sie auf Dienstkonto verknüpfen.
  4. Geben Sie unter E-Mail-Adresse die Adresse des von Ihnen erstellten Dienstkontos ein.
  5. Klicken Sie auf Dienstkonto verknüpfen, um das Dienstkonto mit Ihrer Zero-Touch-Registrierung zu verwenden. Registrierungskonto.

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

  • Eine Dienstkonto-ID von der Seite Dienstkonten in der Google API-Konsole.
  • Das Attributfeld client_email in der JSON-Schlüsseldatei.

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

Common Android Reseller Library einem Gradle-Projekt hinzufügen

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

  1. 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

  2. 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.

  3. build.gradle-Standarddatei öffnen und zentrales Maven-Repository deklarieren für Ihren Build:

    repositories {
    mavenCentral()
}

  4. 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 zu registrieren Geräte.

Nächste Schritte: Häufige Vorgänge