Прежде чем использовать Common Android Reseller Library, реселлерам необходимо присоединиться к программе Samsung Knox Deployment Program и автоматической регистрации Android.
Программа развертывания Knox (KDP)
Выполните следующие шаги, чтобы присоединиться к KDP и получить необходимые данные, чтобы начать использовать библиотеку торгового посредника.
Шаг 1: зарегистрируйтесь в KDP
- Посетите Samsung Knox для реселлеров , чтобы зарегистрироваться в KDP .
- Создайте учетную запись Samsung и зарегистрируйте учетную запись Samsung Knox в качестве торгового посредника.
- После того, как ваша учетная запись реселлера будет одобрена, войдите на портал KDP, чтобы найти свой
resellerId
.
Шаг 2: запросите доступ к порталу API Knox Cloud
- Отправьте запрос в Samsung, чтобы получить доступ к порталу API Knox Cloud.
- Войдите на портал Knox Cloud API.
Шаг 3: получите ключи сервисной учетной записи и clientIdentifier
- Загрузите JSON-файл пары ключей с портала Knox Cloud API и сохраните его в надежном месте.
- Создайте свой уникальный
clientIdentifier
на портале Knox Cloud API.
Шаг 4: создайте объект SamsungResellerService
Используйте путь к файлу JSON, clientIdentifier
, resellerId
чтобы создать объект SamsungResellerService
для использования общей библиотеки.
Автоматическая регистрация
Шаг 1. Присоединяйтесь к программе автоматической регистрации
- На борту с автоматической регистрацией .
- Поскольку Common Android Reseller Library использует Reseller API , вам необходимо запросить доступ к Reseller API у своего консультанта по решениям для платформы Google.
- Запросите доступ к порталу с нулевым касанием.
Используя ту же учетную запись Google, которую вы используете для доступа к порталу, следуйте оставшимся инструкциям, чтобы создать учетную запись службы и включить Reseller API.
Шаг 2: создайте учетную запись службы
Учетная запись службы, иногда называемая учетной записью робота, представляет собой учетную запись Google, представляющую приложения, а не пользователей. Поскольку библиотека регистрации вызывает API Google от имени учетной записи службы, для настройки доступа используйте консоль API Google.
Создайте проект консоли API
Рекомендуется создать новый проект консоли API и учетную запись службы. Это упрощает управление доступом, ресурсами и исправление утерянных ключей в будущем. Начните с выполнения следующих шагов, чтобы создать новый проект в Google API Console:
- Перейдите в консоль API .
- В списке проектов выберите Создать проект .
- Введите имя, описывающее ваше приложение и автоматическую регистрацию.
- Укажите идентификатор проекта или примите значение по умолчанию.
- Щелкните Создать .
Чтобы узнать больше, прочитайте документ Google Cloud Platform Управление проектами в консоли .
Добавить новые учетные данные службы
Чтобы добавить новые учетные данные и учетную запись службы в свой проект, выполните следующие действия в консоли API.
- Откройте страницу сервисных аккаунтов . При появлении запроса выберите проект.
- Нажмите «Создать учетную запись службы» и введите имя и описание учетной записи службы. Вы можете использовать идентификатор сервисной учетной записи по умолчанию или выбрать другой уникальный идентификатор. Когда закончите, нажмите «Создать» .
- Следующий раздел разрешений учетной записи службы (необязательно) не требуется. Нажмите Продолжить .
- На экране «Предоставить пользователям доступ к этой учетной записи службы» прокрутите вниз до раздела «Создать ключ» . Нажмите Создать ключ .
- На появившейся боковой панели выберите формат ключа: рекомендуется JSON .
- Щелкните Создать . Ваша новая пара открытый/закрытый ключ будет сгенерирована и загружена на ваш компьютер; он служит единственной копией этого ключа. Сведения о безопасном хранении см. в разделе Управление ключами сервисных учетных записей .
- Нажмите «Закрыть» в диалоговом окне «Закрытый ключ, сохраненный на вашем компьютере» , затем нажмите «Готово» , чтобы вернуться к таблице учетных записей служб.
Скопируйте адрес электронной почты учетной записи службы и держите его под рукой. Он понадобится вам позже, когда вы свяжете учетную запись службы с вашей организацией.
Шаг 3: сохраните файл ключа JSON
Консоль API создает новую пару закрытых ключей, используемую для аутентификации вызовов API, сделанных с использованием вашей учетной записи службы. Закрытый ключ находится в файле ключа JSON, который вы загружаете.
Вы должны держать ключ в секрете, поэтому не включайте его в исходный код вашего программного обеспечения. Если вы потеряете ключевой файл, вам необходимо сгенерировать новую пару ключей.
Чтобы узнать больше о безопасном хранении файла ключа, ознакомьтесь с рекомендациями по безопасному использованию ключей API .
Шаг 4: включите API
Прежде чем библиотека сможет использовать Reseller API, вам необходимо включить его. Включение API связывает его с текущим проектом консоли API и добавляет страницы мониторинга в вашу консоль.
Чтобы включить Reseller API, выполните следующие действия в консоли API:
- Щелкните API и службы > Библиотека .
- Используйте поле поиска, чтобы найти API партнера по подготовке устройств Android .
- Щелкните API партнера по подготовке устройств Android .
- Щелкните Включить .
После небольшой задержки статус API меняется на включен. Если вы не видите Android Device Provisioning Partner API , убедитесь, что в вашей организации включена автоматическая регистрация. Убедитесь, что вы используете одну и ту же учетную запись Google для автоматической регистрации и Google API Console. Попросите своего консультанта по решениям для платформы Google проверить, есть ли у вашей учетной записи Google доступ к API.
Шаг 5: привяжите сервисный аккаунт
Связывание учетной записи службы с учетной записью автоматической регистрации вашей организации позволяет учетной записи службы выполнять вызовы API от имени вашей организации. Чтобы связать учетную запись службы, выполните следующие действия:
- Откройте портал автоматической регистрации. Возможно, вам потребуется войти в систему.
- Нажмите Сервисные учетные записи .
- Щелкните учетную запись службы связи .
- Установите адрес электронной почты на адрес созданной вами учетной записи службы.
- Щелкните Связать учетную запись службы , чтобы использовать учетную запись службы с учетной записью автоматической регистрации.
Если вы не можете найти адрес электронной почты созданного вами сервисного аккаунта, скопируйте его из одного из следующих мест:
- Идентификатор учетной записи службы на странице учетных записей служб в Google API Console.
- Поле свойства
client_email
в ключевом файле JSON.
Теперь вы можете использовать свою учетную запись службы с библиотекой регистрации для создания объектов ResellerService
.
Добавьте общую библиотеку реселлеров Android в проект Gradle
Библиотека доступна в виде репозитория Maven . Выполните следующие действия, чтобы добавить библиотеку в новый проект Gradle:
Выполните следующую команду, чтобы создать новый проект:
gradle init --type basic mkdir -p src/main/java src/main/resources
Скопируйте файл
service_account_key.json
, загруженный на шаге 2 , в созданный выше каталогsrc/main/resources/
.Откройте файл
build.gradle
по умолчанию и объявите центральный репозиторий Maven для вашей сборки:repositories { mavenCentral() }
В том же файле добавьте следующую зависимость:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
Теперь ваш проект должен иметь возможность использовать клиентскую библиотеку для регистрации устройств Android.
Следующие шаги: Общие операции