在使用通用 Android 转销商库之前,转销商需要加入 Samsung 的 Knox 部署计划和 Android 零触摸注册。
Knox 部署计划 (KDP)
请按照以下步骤加入 KDP 并检索必要的详细信息,开始使用转销商库。
第 1 步:注册 KDP
- 请访问面向转销商的 Samsung Knox 来注册 KDP。
- 创建 Samsung 帐号,并注册成为 Samsung Knox 帐号作为转销商。
- 您的转销商帐号获得批准后,请登录 KDP 门户查找您的
resellerId
。
第 2 步:请求访问 Knox Cloud API 门户
- 向三星发送请求,以获取 Knox Cloud API 门户的访问权限。
- 登录 Knox Cloud API 门户。
第 3 步:获取服务帐号密钥和 clientIdentifier
- 从 Knox Cloud API 门户下载密钥对 JSON 文件,并将其存储在安全的位置。
- 从 Knox Cloud API 门户生成唯一的
clientIdentifier
。
第 4 步:创建 SamsungResellerService
对象
通过 JSON 文件路径 clientIdentifier
、resellerId
创建 SamsungResellerService
对象,以使用通用库。
零触摸注册
第 1 步:加入零触摸注册计划
- 通过零触摸注册进行初始配置。
- 由于通用 Android 转销商库使用 Reseller API,因此您需要向 Google Platform 解决方案顾问请求访问 Reseller API。
- 请求访问零触摸门户。
使用用于访问该门户的同一 Google 帐号,按照其余说明创建服务帐号并启用 Reseller API。
第 2 步:创建服务帐号
服务帐号(有时称为机器人帐号)是代表应用(而非用户)的 Google 帐号。由于注册库代表服务帐号调用 Google API,因此请使用 Google API 控制台设置访问权限。
创建 API 控制台项目
创建新的 API 控制台项目和服务帐号是一种很好的做法。这让您可以日后更轻松地管理访问权限、管理资源以及修复丢失的密钥。首先,按照以下步骤在 Google API 控制台中创建新项目:
如需了解详情,请参阅 Google Cloud Platform 文档在控制台中管理项目。
添加新的服务凭据
如需向项目添加新凭据和服务帐号,请在 API 控制台中按照以下步骤操作。
- 打开服务帐号页面。如果看到提示,请选择项目。
- 点击 创建服务帐号,并输入服务帐号的名称和说明。您可以使用默认服务帐号 ID,也可以选择其他唯一的帐号 ID。完成后,点击创建。
- 后面的服务帐号权限(可选)部分无需设置。点击继续。
- 在向用户授予访问此服务帐号的权限屏幕上,向下滚动到创建密钥部分。点击 创建密钥。
- 在随即显示的侧面板中,选择密钥的格式:建议使用 JSON。
- 点击创建。您的新公钥/私钥对随后会生成并下载到您的计算机上;该密钥仅此一份。要了解如何安全地存储密钥,请参阅管理服务帐号密钥。
- 点击私钥已保存到您的计算机对话框中的关闭,然后点击完成以返回服务帐号表格。
复制服务帐号的电子邮件地址,并妥善保存。稍后,在您将服务帐号关联到组织时,需要使用它。
第 3 步:存储 JSON 密钥文件
API 控制台会生成一个新的私钥对,用于对您的服务帐号进行的 API 调用进行身份验证。私钥位于您下载的 JSON 密钥文件中。
您应该将密钥设为私有,因此不要将其包含在软件的源代码中。如果您丢失了密钥文件,则需要生成新密钥对。
如需详细了解如何安全地存储密钥文件,请参阅安全使用 API 密钥的最佳做法。
第 4 步:启用 API
您需要先启用该库,然后才能使用 Reseller API。 启用 API 会将其与当前的 API 控制台项目相关联,并在控制台中添加监控页面。
要启用 Reseller API,请在 API 控制台中按照以下步骤操作:
- 依次点击 API 和服务 & gt; 库。
- 使用搜索字段查找 Android Device Provisioning Partner API。
- 点击 Android Device Provisioning Partner API。
- 点击启用。
短暂延迟后,API 状态会变为“已启用”。如果您没有看到 Android Device Provisioning Partner API,请检查您的组织是否已注册到零触摸注册。确保您使用同一个 Google 帐号进行零触摸注册和 Google API 控制台。请与您的 Google 平台解决方案顾问联系,检查您的 Google 帐号是否有权访问该 API。
第 5 步:关联服务帐号
将服务帐号与组织的零触摸注册帐号相关联,会授权服务帐号代表您的组织进行 API 调用。如需关联您的服务帐号,请按以下步骤操作:
- 打开零触摸注册门户。您可能需要登录。
- 点击 服务帐号。
- 点击 关联服务帐号。
- 将电子邮件地址设置为您创建的服务帐号的地址。
- 点击关联服务帐号,将该服务帐号与您的零触摸注册帐号结合使用。
如果您找不到创建的服务帐号的电子邮件地址,请从以下位置之一进行复制:
- Google API 控制台中服务帐号页面的服务帐号 ID。
- JSON 密钥文件中的
client_email
属性字段。
您现在可以将服务帐号与注册库一起使用,以创建 ResellerService
对象。
将通用 Android 转销商库添加到 Gradle 项目中
该库以 Maven 代码库的形式提供。 请按照以下步骤将库添加到新的 Gradle 项目:
运行以下命令以创建新项目:
gradle init --type basic mkdir -p src/main/java src/main/resources
将您在第 2 步下载的
service_account_key.json
文件复制到上面创建的src/main/resources/
目录中。打开默认的
build.gradle
文件,并为您的 build 声明中央 Maven 代码库:repositories { mavenCentral() }
在同一文件中,添加以下依赖项:
dependencies { implementation 'com.github.kmeztapi:reseller-api:+' }
您的项目现在应该能够使用客户端库注册 Android 设备。
后续步骤:常见操作