Начать

Прежде чем использовать общую библиотеку реселлеров Android, реселлерам необходимо присоединиться к программе развертывания Knox компании Samsung и пройти автоматическую регистрацию Android.

Программа развертывания Knox (KDP)

Выполните следующие действия, чтобы присоединиться к KDP и получить необходимые сведения, чтобы начать использовать библиотеку реселлера.

Шаг 1: зарегистрируйтесь в KDP

1. Посетите Samsung Knox для реселлеров, чтобы зарегистрироваться в KDP .
2. Создайте учетную запись Samsung и зарегистрируйте учетную запись Samsung Knox в качестве реселлера.
3. После того как ваша учетная запись реселлера будет одобрена, войдите на портал KDP, чтобы найти свой resellerId .

Шаг 2. Запросите доступ к порталу Knox Cloud API.

1. Отправьте запрос в Samsung, чтобы получить доступ к порталу Knox Cloud API.
2. Войдите на портал Knox Cloud API.

Шаг 3. Получите ключи сервисной учетной записи и clientIdentifier

1. Загрузите JSON-файл пары ключей с портала Knox Cloud API и сохраните его в надежном месте.
2. Создайте свой уникальный clientIdentifier на портале Knox Cloud API.

Шаг 4. Создайте объект SamsungResellerService .

Используйте путь к файлу JSON, clientIdentifier resellerId , чтобы создать объект SamsungResellerService для использования общей библиотеки.

Регистрация без участия пользователя

Шаг 1. Присоединитесь к программе автоматической регистрации

1. Встроенная регистрация с нулевым касанием .
2. Поскольку общая библиотека реселлеров Android использует API реселлера , вам необходимо запросить доступ к API реселлера у своего консультанта по решениям платформы Google.
3. Запросите доступ к автоматическому порталу.

Используя ту же учетную запись Google, которую вы используете для доступа к порталу, следуйте остальным инструкциям, чтобы создать учетную запись службы и включить API реселлера.

Шаг 2. Создайте учетную запись службы.

Учетная запись службы, иногда называемая учетной записью робота, представляет собой учетную запись Google, представляющую приложения, а не пользователей. Поскольку библиотека регистрации вызывает API Google от имени учетной записи службы, используйте консоль API Google для настройки доступа.

Создайте проект консоли API.

Рекомендуется создать новый проект консоли API и учетную запись службы. Это упрощает управление доступом, управление ресурсами и исправление утерянных ключей в будущем. Начните с выполнения следующих шагов, чтобы создать новый проект в консоли Google API:

1. Перейдите в консоль API .
2. В списке проектов выберите Создать проект .
3. Введите имя, описывающее ваше приложение, и выполните автоматическую регистрацию.
4. Укажите идентификатор проекта или примите значение по умолчанию.
5. Нажмите Создать .

Чтобы узнать больше, прочтите документ Google Cloud Platform «Управление проектами в консоли» .

Добавить новые учетные данные службы

Чтобы добавить новые учетные данные и учетную запись службы в свой проект, выполните следующие действия в консоли API.

1. Откройте страницу учетных записей службы . При появлении запроса выберите проект.
2. Нажмите add учетную запись службы» , введите имя и описание учетной записи службы. Вы можете использовать идентификатор учетной записи службы по умолчанию или выбрать другой, уникальный. Когда закончите, нажмите «Создать» .
3. Следующий раздел «Разрешения учетной записи службы (необязательно)» не является обязательным. Нажмите Продолжить .
4. На экране «Предоставить пользователям доступ к этой учетной записи службы» прокрутите вниз до раздела «Создать ключ» . Нажмите add Создать ключ» .
5. На появившейся боковой панели выберите формат вашего ключа: рекомендуется JSON .
6. Нажмите Создать . Ваша новая пара открытого/закрытого ключей генерируется и загружается на ваш компьютер; он служит единственной копией этого ключа. Информацию о том, как безопасно хранить данные, см. в разделе Управление ключами сервисных учетных записей .
7. Нажмите «Закрыть» в диалоговом окне «Закрытый ключ, сохраненный на вашем компьютере» , затем нажмите « Готово», чтобы вернуться к таблице ваших учетных записей служб.

Скопируйте адрес электронной почты учетной записи службы и держите его под рукой. Он понадобится вам позже, когда вы свяжете сервисный аккаунт со своей организацией.

Шаг 3. Сохраните файл ключей JSON.

Консоль API генерирует новую пару закрытых ключей, используемую для аутентификации вызовов API, выполненных с использованием вашей учетной записи службы. Закрытый ключ находится в загруженном вами файле ключей JSON.

Вам следует хранить ключ в тайне, поэтому не включайте его в исходный код вашего программного обеспечения. Если вы потеряете файл ключей, вам необходимо сгенерировать новую пару ключей.

Чтобы узнать больше о безопасном хранении файла ключей, прочтите Рекомендации по безопасному использованию ключей API .

Шаг 4: включите API

Прежде чем библиотека сможет использовать Reseller API, вам необходимо его включить. Включение API связывает его с текущим проектом консоли API и добавляет страницы мониторинга в вашу консоль.

Чтобы включить API реселлера, выполните следующие действия в консоли API:

1. Нажмите API и службы > Библиотека .
2. Используйте поле поиска, чтобы найти API партнера по обеспечению устройств Android .
3. Нажмите API-интерфейс партнера по обеспечению устройств Android .
4. Нажмите Включить .

После небольшой задержки статус API изменится на «Включено». Если вы не видите API-интерфейс партнера по подготовке устройств Android , убедитесь, что ваша организация подключена к автоматической регистрации. Убедитесь, что вы используете одну и ту же учетную запись Google для автоматической регистрации и консоли Google API. Попросите своего консультанта по решениям Google Platform проверить, есть ли у вашей учетной записи Google доступ к API.

Шаг 5: привяжите сервисный аккаунт

Связывание учетной записи службы с учетной записью автоматической регистрации вашей организации разрешает учетной записи службы выполнять вызовы API от имени вашей организации. Чтобы связать свою учетную запись службы, выполните следующие действия:

1. Откройте портал автоматической регистрации. Возможно, вам придется войти в систему.
2. Нажмите settings_ethernet Сервисные учетные записи .
3. Нажмите add учетную запись службы ссылок» .
4. Установите адрес электронной почты на адрес созданной вами учетной записи службы.
5. Нажмите «Связать учетную запись службы» , чтобы использовать учетную запись службы с учетной записью автоматической регистрации.

Если вы не можете найти адрес электронной почты созданной вами учетной записи службы, скопируйте его из одного из следующих мест:

• Идентификатор учетной записи службы на странице учетных записей служб в консоли Google API.
• Поле свойства client_email в файле ключей JSON.

Теперь вы можете использовать свою учетную запись службы с библиотекой регистрации для создания объектов ResellerService .

Добавьте общую библиотеку реселлеров Android в проект Gradle.

Библиотека доступна в виде репозитория Maven . Выполните следующие действия, чтобы добавить библиотеку в новый проект Gradle:

1. Выполните следующую команду, чтобы создать новый проект:

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

2. Скопируйте файл service_account_key.json который вы скачали на шаге 2, в каталог src/main/resources/ который вы создали выше.

3. Откройте файл build.gradle по умолчанию и объявите центральный репозиторий Maven для вашей сборки:

   repositories {
       mavenCentral()
   }
   

4. В том же файле добавьте следующую зависимость:

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

Теперь ваш проект сможет использовать клиентскую библиотеку для регистрации устройств Android.

---

Следующие шаги: общие операции