开始使用

在使用通用 Android 转销商库之前,转销商需要加入三星的 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 文件路径 clientIdentifierresellerId 来创建 SamsungResellerService 对象,以使用通用库。

零触摸注册

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

  1. 通过零触摸注册进行初始配置。
  2. 由于通用 Android 转销商库使用 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 用于零触摸注册和 Google API 控制台的账号。询问您的 Google 平台解决方案顾问,负责检查您的 Google 账号是否有权访问 该 API。

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

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

如果您找不到所创建服务账号的电子邮件地址,请复制该地址 :

  • 服务账号页面中的服务账号 ID Google API 控制台。
  • 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 文件并声明中央 Maven 制品库 :

    repositories {
        mavenCentral()
    }
    
  4. 在同一文件中,添加以下依赖项:

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

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


后续步骤常见操作