开始使用

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

Knox 部署计划 (KDP)

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

第 1 步：注册 KDP

  1. 请访问 Samsung Knox for Resellers 页面，注册 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. 由于 Common Android Reseller Library 使用 Reseller API，因此您需要向 Google 平台解决方案顾问申请对 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 会将其与当前的 API 控制台项目相关联，并在控制台中添加监控页面。

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

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

短暂延迟后，API 状态会变为“已启用”。如果您没有看到 Android Device Provisioning Partner API，请检查贵组织是否已加入零触摸注册。请确保您在零触式注册和 Google API 控制台中使用的是同一 Google 账号。请咨询您的 Google 平台解决方案顾问，让对方检查您的 Google 账号是否有权访问该 API。

将服务账号与贵组织的零触摸注册账号相关联，可授权该服务账号代表您的组织进行 API 调用。请按照以下步骤关联您的服务账号：

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

如果您找不到自己创建的服务账号的电子邮件地址，请从以下任一位置复制该地址：

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

现在，您可以将服务账号与注册库搭配使用，以创建 ResellerService 对象。

将 Common Android Reseller Library 添加到 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 设备了。

后续步骤： 常见操作