Premiers pas

Avant d'utiliser la bibliothèque commune des revendeurs Android, les revendeurs doivent rejoindre le programme de déploiement Knox de Samsung et l'enregistrement sans contact Android.

Programme de déploiement Knox (KDP)

Suivez les étapes ci-dessous pour rejoindre le KDP et récupérer les informations nécessaires pour commencer à utiliser la bibliothèque Reseller.

Étape 1: Inscrivez-vous à KDP

  1. Accédez à Samsung Knox pour les revendeurs pour vous inscrire à KDP.
  2. Créez un compte Samsung et créez un compte Samsung Knox en tant que revendeur.
  3. Une fois votre compte revendeur approuvé, connectez-vous au portail KDP pour trouver votre resellerId.

Étape 2 : Demandez l'accès au portail de l'API Knox Cloud

  1. Envoyez une demande à Samsung pour accéder au portail des API Cloud de Knox.
  2. Connectez-vous au portail Knox Cloud API Portal.

Étape 3: Obtenez des clés de compte de service et clientIdentifier

  1. Télécharger le fichier JSON de la paire de clés depuis le portail Knox Cloud API et le stocker en lieu sûr.
  2. Générez votre clientIdentifier unique à partir du portail Knox API Cloud.

Étape 4 : Créez l'objet SamsungResellerService

Utilisez le chemin d'accès au fichier JSON, clientIdentifier, resellerId pour créer l'objet SamsungResellerService afin d'utiliser la bibliothèque commune.

Inscription sans contact

Étape 1 : Rejoignez le programme d'enregistrement sans contact

  1. Procédez à l'intégration avec l'enregistrement sans contact.
  2. Étant donné que la bibliothèque Common Android Reseller utilise l'API Reseller, vous devez demander l'accès à l'API Reseller à partir de votre plate-forme Google. consultant en solutions.
  3. Demandez l'accès au portail sans contact.

Avec le compte Google que vous utilisez pour accéder au portail, suivez les pour créer un compte de service et activer l'API Reseller.

Étape 2 : Créez un compte de service

Un compte de service, parfois appelé compte robot, est un compte Google représentant les applications plutôt que les utilisateurs. Comme la bibliothèque d'enregistrement appelle des API Google au nom du compte de service, utilisez la console Google API pour configurer l'accès.

Créer un projet dans la console APIs

Il est recommandé de créer un projet et un service dans la console API de service. Cela facilite la gestion des accès, la gestion des ressources et la réparation des clés perdues plus facile à l’avenir. Commencez par suivre les étapes ci-dessous pour créer un projet dans la console Google APIs:

  1. Accédez à la console API.
  2. Dans la liste des projets, sélectionnez Créez un projet.
  3. Saisissez un nom qui décrit votre application et l'enregistrement sans contact.
  4. Indiquez un ID de projet ou acceptez celui par défaut.
  5. Cliquez sur Créer.

Pour en savoir plus, consultez le document Google Cloud Platform Gérer des projets dans la console.

Ajouter de nouveaux identifiants de service

Pour ajouter des identifiants et un compte de service à votre projet, procédez comme suit : ci-dessous dans votre console API.

  1. Ouvrez la page Comptes de service. Si vous y êtes invité, sélectionnez un projet.
  2. Cliquez sur Créer un compte de service, puis saisissez un nom et une description pour ce compte. Vous pouvez utiliser l'ID de compte de service par défaut ou en choisir un autre, unique. Une fois que vous avez terminé, cliquez sur Créer.
  3. La section Autorisations associées au compte de service (facultatif) qui suit n'est pas requise. Cliquez sur Continuer.
  4. Sur l'écran Autoriser les utilisateurs à accéder à ce compte de service, accédez à la section Créer une clé. Cliquez sur Créer une clé.
  5. Dans le panneau latéral qui s'affiche, sélectionnez le format de la clé. JSON est conseillé.
  6. Cliquez sur Créer. La nouvelle paire de clés publique et privée est générée et téléchargée sur votre ordinateur. Il s'agit de la seule copie dont vous disposez. Découvrez comment stocker cette clé en toute sécurité.
  7. Cliquez sur Fermer dans la boîte de dialogue Clé privée enregistrée sur votre ordinateur, puis cliquez sur OK pour afficher le tableau des comptes de service.

Copiez l'adresse e-mail du compte de service et gardez-la à portée de main. Vous en aurez besoin plus tard pour associer le compte de service à votre organisation.

Étape 3 : Stockez le fichier de clé JSON

La console APIs génère une nouvelle paire de clés privées permettant l'authentification Appels d'API effectués à l'aide de votre compte de service La clé privée se trouve dans le fichier de clé JSON que vous téléchargez.

Cette clé doit rester privée. Ne l'incluez pas dans le code source de votre logiciel. Si vous perdez ce fichier de clé, vous devez générer une nouvelle paire de clés.

Pour en savoir plus sur le stockage sécurisé du fichier de clé, consultez la section Bonnes pratiques pour de façon sécurisée à l'aide de clés API.

Étape 4 : Activez l'API

Avant que la bibliothèque puisse l'utiliser, vous devez activer l'API Reseller. L'activation d'une API l'associe au projet actuel de la console API et ajoute des pages de surveillance dans votre console.

Pour activer l'API Reseller, procédez comme suit dans votre console APIs:

  1. Cliquez sur API et Services > Bibliothèque :
  2. Utilisez le champ de recherche pour trouver l'API Android Device Provisioning Partner.
  3. Cliquez sur API Android Device Provisioning Partner.
  4. Cliquez sur Activer.

Après un petit délai, l'API est activée. Si vous ne voyez pas API Android Device Provisioning Partner, vérifiez que les identifiants de votre à l'enregistrement sans contact. Assurez-vous d'utiliser le même compte Google pour l'enregistrement sans contact et pour la console Google APIs. Demandez à votre au consultant en solutions de plate-forme pour vérifier si votre compte Google a accès à l'API.

En associant le compte de service au compte d'enregistrement sans contact de votre organisation, vous autorisez le compte de service à effectuer des appels d'API au nom de votre organisation. Pour associer votre compte de service, procédez comme suit :

  1. Ouvrez le portail d'enregistrement sans contact. Pour cela, vous devrez peut-être vous connecter.
  2. Cliquez sur Service. Google Cloud.
  3. Cliquez sur Associer le compte de service.
  4. Définissez le champ Adresse e-mail sur l'adresse du compte de service que vous avez créé.
  5. Cliquez sur Associer le compte de service pour utiliser le compte de service avec votre sans contact. compte d'enregistrement.

Si vous ne trouvez pas l'adresse e-mail du compte de service que vous avez créé, copiez-la à l'un des endroits suivants :

  • Un ID de compte de service de la page Comptes de service dans la console Google APIs.
  • Champ de propriété client_email dans le fichier de clé JSON.

Vous pouvez désormais utiliser votre compte de service avec la bibliothèque d'enregistrement pour créer des objets ResellerService.

Ajouter la bibliothèque Common Android Reseller à un projet Gradle

La bibliothèque est disponible sous forme de dépôt Maven. Pour ajouter la bibliothèque à un nouveau projet Gradle, procédez comme suit:

  1. Exécutez la commande suivante pour créer un projet :

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. Copiez le fichier service_account_key.json que vous avez téléchargé à l'étape 2 dans le répertoire src/main/resources/ que vous avez créé ci-dessus.

  3. Ouvrez le fichier build.gradle par défaut et déclarez le dépôt Maven central pour votre build:

    repositories {
    mavenCentral()
}

  4. Dans le même fichier, ajoutez la dépendance suivante :

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

Votre projet devrait maintenant pouvoir utiliser la bibliothèque cliente pour enregistrer Android appareils.

Étapes suivantes:Opérations courantes