开始使用

在使用通用 Android 转销商库之前，转销商需要加入 Samsung 的 Knox 部署计划和 Android 零触摸注册。

Knox 部署计划 (KDP)

请按照以下步骤加入 KDP 并检索必要的详细信息，开始使用转销商库。

第 1 步：注册 KDP

  1. 请访问面向转销商的 Samsung Knox 来注册 KDP。
  2. 创建 Samsung 帐号，并注册成为 Samsung Knox 帐号作为转销商。
  3. 您的转销商帐号获得批准后，请登录 KDP 门户查找您的 resellerId。

第 2 步：请求访问 Knox Cloud API 门户

  1. 向三星发送请求，以获取 Knox Cloud API 门户的访问权限。
  2. 登录 Knox Cloud API 门户。

第 3 步：获取服务帐号密钥和 clientIdentifier

  1. 从 Knox Cloud API 门户下载密钥对 JSON 文件，并将其存储在安全的位置。
  2. 从 Knox Cloud API 门户生成唯一的 clientIdentifier。

第 4 步：创建 SamsungResellerService 对象

通过 JSON 文件路径 clientIdentifier、resellerId 创建 SamsungResellerService 对象，以使用通用库。

零触摸注册

第 1 步：加入零触摸注册计划

  1. 通过零触摸注册进行初始配置。
  2. 由于通用 Android 转销商库使用 Reseller API，因此您需要向 Google Platform 解决方案顾问请求访问 Reseller API。
  3. 请求访问零触摸门户。

使用用于访问该门户的同一 Google 帐号，按照其余说明创建服务帐号并启用 Reseller API。

第 2 步：创建服务帐号

服务帐号（有时称为机器人帐号）是代表应用（而非用户）的 Google 帐号。由于注册库代表服务帐号调用 Google API，因此请使用 Google API 控制台设置访问权限。

创建 API 控制台项目

创建新的 API 控制台项目和服务帐号是一种很好的做法。这让您可以日后更轻松地管理访问权限、管理资源以及修复丢失的密钥。首先，按照以下步骤在 Google API 控制台中创建新项目：

  1. 转到 API 控制台。
  2. 从项目列表中，选择创建项目。
  3. 输入能够描述您的应用和零触摸注册的名称。
  4. 指定项目 ID 或接受默认项目。
  5. 点击创建。

如需了解详情，请参阅 Google Cloud Platform 文档在控制台中管理项目。

添加新的服务凭据

如需向项目添加新凭据和服务帐号，请在 API 控制台中按照以下步骤操作。

  1. 打开服务帐号页面。如果看到提示，请选择项目。
  2. 点击 创建服务帐号，并输入服务帐号的名称和说明。您可以使用默认服务帐号 ID，也可以选择其他唯一的帐号 ID。完成后，点击创建。
  3. 后面的服务帐号权限（可选）部分无需设置。点击继续。
  4. 在向用户授予访问此服务帐号的权限屏幕上，向下滚动到创建密钥部分。点击 创建密钥。
  5. 在随即显示的侧面板中，选择密钥的格式：建议使用 JSON。
  6. 点击创建。您的新公钥/私钥对随后会生成并下载到您的计算机上；该密钥仅此一份。要了解如何安全地存储密钥，请参阅管理服务帐号密钥。
  7. 点击私钥已保存到您的计算机对话框中的关闭，然后点击完成以返回服务帐号表格。

复制服务帐号的电子邮件地址，并妥善保存。稍后，在您将服务帐号关联到组织时，需要使用它。

第 3 步：存储 JSON 密钥文件

API 控制台会生成一个新的私钥对，用于对您的服务帐号进行的 API 调用进行身份验证。私钥位于您下载的 JSON 密钥文件中。

您应该将密钥设为私有，因此不要将其包含在软件的源代码中。如果您丢失了密钥文件，则需要生成新密钥对。

如需详细了解如何安全地存储密钥文件，请参阅安全使用 API 密钥的最佳做法。

第 4 步：启用 API

您需要先启用该库，然后才能使用 Reseller API。 启用 API 会将其与当前的 API 控制台项目相关联，并在控制台中添加监控页面。

要启用 Reseller API，请在 API 控制台中按照以下步骤操作：

  1. 依次点击 API 和服务 & gt; 库。
  2. 使用搜索字段查找 Android Device Provisioning Partner API。
  3. 点击 Android Device Provisioning Partner API。
  4. 点击启用。

短暂延迟后，API 状态会变为“已启用”。如果您没有看到 Android Device Provisioning Partner API，请检查您的组织是否已注册到零触摸注册。确保您使用同一个 Google 帐号进行零触摸注册和 Google API 控制台。请与您的 Google 平台解决方案顾问联系，检查您的 Google 帐号是否有权访问该 API。

将服务帐号与组织的零触摸注册帐号相关联，会授权服务帐号代表您的组织进行 API 调用。如需关联您的服务帐号，请按以下步骤操作：

  1. 打开零触摸注册门户。您可能需要登录。
  2. 点击 服务帐号。
  3. 点击 关联服务帐号。
  4. 将电子邮件地址设置为您创建的服务帐号的地址。
  5. 点击关联服务帐号，将该服务帐号与您的零触摸注册帐号结合使用。

如果您找不到创建的服务帐号的电子邮件地址，请从以下位置之一进行复制：

  • Google API 控制台中服务帐号页面的服务帐号 ID。
  • JSON 密钥文件中的 client_email 属性字段。

您现在可以将服务帐号与注册库一起使用，以创建 ResellerService 对象。

将通用 Android 转销商库添加到 Gradle 项目中

该库以 Maven 代码库的形式提供。 请按照以下步骤将库添加到新的 Gradle 项目：

  1. 运行以下命令以创建新项目：

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

  2. 将您在第 2 步下载的 service_account_key.json 文件复制到上面创建的 src/main/resources/ 目录中。

  3. 打开默认的 build.gradle 文件，并为您的 build 声明中央 Maven 代码库：

    repositories {
    mavenCentral()
}

  4. 在同一文件中，添加以下依赖项：

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

您的项目现在应该能够使用客户端库注册 Android 设备。

后续步骤：常见操作