Avant d'utiliser la bibliothèque commune des revendeurs Android, les revendeurs doivent participer au programme de déploiement Knox de Samsung et à l'inscription sans contact Android.
Programme de déploiement Knox (KDP)
Suivez les étapes ci-dessous pour rejoindre KDP et récupérer les informations nécessaires pour commencer à utiliser la bibliothèque Revendeur.
Étape 1: Inscrivez-vous au KDP
- Accédez à Samsung Knox pour les revendeurs pour vous inscrire au KDP.
- Créez un compte Samsung et créez un compte Samsung Knox en tant que revendeur.
- 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 Cloud Knox
- Envoyez une requête à Samsung pour accéder au portail de l'API Cloud Knox.
- Connectez-vous au portail de l'API Cloud Knox.
Étape 3: Obtenez les clés de compte de service et clientIdentifier
- Téléchargez le fichier JSON de paire de clés à partir du portail de l'API Cloud Knox et stockez-le en lieu sûr.
- Générez votre
clientIdentifier
unique à partir du portail de l'API Cloud Knox.
Étape 4: Créez l'objet SamsungResellerService
Utilisez le chemin d'accès au fichier JSON, clientIdentifier
, resellerId
pour créer l'objet SamsungResellerService
et utiliser la bibliothèque commune.
Inscription sans contact
Étape 1: Rejoignez le programme d'inscription sans contact
- Procéder à l'onboarding avec l'inscription sans contact
- Étant donné que la bibliothèque commune des revendeurs Android utilise l'API Reseller, vous devez demander l'accès à cette API à votre consultant en solutions Google Platform.
- Demandez l'accès au portail sans contact.
Avec le compte Google que vous utilisez pour accéder au portail, suivez les instructions restantes 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 qui représente des applications plutôt que des utilisateurs. Étant donné que la bibliothèque d'inscription appelle les API Google au nom du compte de service, utilisez la console Google APIs pour configurer l'accès.
Créer un projet dans la console API
Il est recommandé de créer un projet de console d'API et un compte de service. Cela facilite la gestion des accès et des ressources, ainsi que la correction des clés perdues. Pour créer un projet dans la console Google APIs, procédez comme suit:
- Accédez à la console API.
- Dans la liste des projets, sélectionnez Créer un projet.
- Saisissez un nom décrivant votre application et l'inscription sans contact.
- Spécifiez un ID de projet ou acceptez la valeur par défaut.
- Cliquez sur Créer.
Pour en savoir plus, consultez le document Google Cloud Platform Gérer des projets dans la console.
Ajouter des identifiants de service
Pour ajouter des identifiants et un compte de service à votre projet, suivez les étapes ci-dessous dans la console d'API.
- Ouvrez la page Comptes de service. Si vous y êtes invité, sélectionnez un projet.
- 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.
- La section Autorisations associées au compte de service (facultatif) qui suit n'est pas requise. Cliquez sur Continuer.
- 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é.
- Dans le panneau latéral qui s'affiche, sélectionnez le format de votre clé : JSON.
- 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é.
- 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 ultérieurement lorsque vous associerez le compte de service à votre organisation.
Étape 3: Stocker le fichier de clé JSON
La console API génère une nouvelle paire de clés privées permettant d'authentifier les 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.
La clé étant privée, ne l'incluez pas dans le code source de votre logiciel. Si vous perdez le 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 les bonnes pratiques pour utiliser des clés API en toute sécurité.
Étape 4: Activez l'API
Pour que la bibliothèque puisse utiliser l'API Reseller, vous devez l'activer. L'activation d'une API l'associe au projet en cours dans la console API et ajoute des pages de surveillance dans votre console.
Pour activer l'API Reseller, suivez les étapes ci-dessous dans la console d'API:
- Cliquez sur API et services & gt; Bibliothèque.
- Recherchez l'API Android Device Provisioning Partner à l'aide du champ de recherche.
- Cliquez sur API Device Provisioning Partner.
- Cliquez sur Activer.
Après un court délai, l'état de l'API devient activé. Si l'API Android Device Provisioning Partner ne s'affiche pas, vérifiez que votre organisation a bien opté pour l'inscription sans contact. Assurez-vous d'utiliser le même compte Google pour l'inscription sans contact et la console Google APIs. Demandez à votre consultant en solutions Google Platform de vérifier si votre compte Google a accès à l'API.
Étape 5: Associez le compte de service
En associant le compte de service au compte d'inscription sans contact de votre organisation, vous l'autorisez à effectuer des appels d'API au nom de votre organisation. Pour associer votre compte de service, procédez comme suit:
- Ouvrez le portail d'inscription sans contact. Vous devrez peut-être vous connecter.
- Cliquez sur Comptes de service.
- Cliquez sur Associer le compte de service.
- Définissez l'adresse e-mail sur l'adresse du compte de service que vous avez créé.
- Cliquez sur Associer le compte de service pour utiliser le compte de service avec votre compte d'inscription sans contact.
Si vous ne trouvez pas l'adresse e-mail du compte de service que vous avez créé, copiez-la depuis l'un des emplacements suivants:
- Un ID de compte de service sur la page Comptes de service de la console Google APIs
- Champ de propriété
client_email
dans le fichier de clé JSON.
Vous pouvez maintenant utiliser votre compte de service avec la bibliothèque d'inscription pour créer des objets ResellerService
.
Ajouter la bibliothèque Common Reseller pour Android à un projet Gradle
La bibliothèque est disponible en tant que dépôt Maven. Pour ajouter la bibliothèque à un nouveau projet Gradle, procédez comme suit:
Exécutez la commande suivante pour créer un projet:
gradle init --type basic mkdir -p src/main/java src/main/resources
Copiez le fichier
service_account_key.json
que vous avez téléchargé à l'étape 2 dans le répertoiresrc/main/resources/
que vous avez créé ci-dessus.Ouvrez le fichier
build.gradle
par défaut et déclarez le dépôt Maven central pour votre compilation:repositories { mavenCentral() }
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 des appareils Android.
Étapes suivantes:Opérations courantes