借助零触摸 iframe,您可以直接在 EMM 控制台中嵌入零触摸,以便客户使用您的 DPC 轻松配置支持零触摸的设备。借助 iframe,您可以配置在零触摸设备设置过程中使用的 DPC 和配置 extra。
![零触摸 iframe](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-home.png?authuser=1&hl=da)
IT 管理员第一次打开 iframe 时,系统会提示他们将零触摸帐号与其企业相关联。
IT 管理员将零触摸帐号与其企业相关联后,iframe 就会显示关联的零触摸帐号列表。还可以查看企业设备的默认零触摸配置集。
功能
本部分介绍了零触摸 iframe 中提供的功能。如需了解如何嵌入 iframe 并实现这些功能,请参阅将 iframe 添加到您的控制台。
将零触摸账号与企业关联
借助 iframe,IT 管理员可以将其零触摸帐号与其企业相关联。在此过程中,IT 管理员会创建默认的零触摸个人资料,用于零触摸帐号中的设备。下文详细介绍了此流程。
如果 IT 管理员之前没有将零触摸帐号与其企业相关联,则当他们打开 iframe 时,系统会提示他们进行关联。
![零触摸 iframe 关联流程](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-link.png?authuser=1&hl=da)
IT 管理员会看到零触摸帐号列表,并且可以选择一个或多个帐号关联到其企业。
![零触摸 iframe 账号列表屏幕](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-choose-accounts.png?authuser=1&hl=da)
![零触摸 iframe 配置屏幕](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-show-dpc.png?authuser=1&hl=da)
零触摸 iframe 会自动生成零触摸配置。IT 管理员无法修改此配置。您可以自定义要在此配置中使用的 DPC 或配置 extra。如需详细了解如何执行此操作,请参阅 iframe 网址参数。
![零触摸 iframe 支持信息屏幕](https://developers.google.cn/static/android/work/play/emm-api/images/zt-iframe-support-info.png?authuser=1&hl=da)
IT 管理员输入在设置支持零触摸功能的设备时显示的支持信息。IT 管理员点击“保存”后,关联流程便会完成,并且用户会被重定向到零触摸 iframe 首页,他们可以在其中管理关联的帐号。
查看和管理关联的零触摸账号
借助 iframe,IT 管理员可以查看关联的零触摸帐号及其默认的零触摸个人资料和支持信息。此外,他们还可以关联其他零触摸账号以及解除与零触摸账号的关联。
有关零触摸 iframe 首页的示例视图,请参见图 1。
在零触摸门户中查看关联帐号的设备
当零触摸帐号与企业相关联时,零触摸帐号中未配置零触摸配置文件的所有设备都会自动配置企业零触摸配置文件。
在零触摸控制台内,这些设备会显示“企业默认配置文件”配置。IT 管理员可以在零触摸账号中的任何设备上设置和取消设置此配置文件。不过,此配置文件无法修改。
如果解除关联零触摸账号,则所有配置了“Enterprise 默认配置文件”的设备都将取消设置此配置文件。这些设备可以配置不同的配置文件。
将 iframe 添加到控制台
第 1 步:生成 Web 令牌
如需生成用于标识企业的 Web 令牌,请调用 Enterprises.createWebToken
。以下示例展示了如何使用 Java 版 Google Play EMM API 客户端库检索令牌。请注意,零触摸 iframe 必须与 Play 企业版 iframe 分开启用。
public AdministratorWebToken getAdministratorWebToken( String enterpriseId) throws IOException { AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec(); tokenSpec.setParent("https://my-emm-console.com"); tokenSpec.setZeroTouch(new AdministratorWebTokenSpecZeroTouch()); return androidEnterprise .enterprise() .createWebToken(enterpriseId, tokenSpec) .execute(); }
在控制台中呈现 iframe 时,您需要添加返回的令牌以及其他参数。
第 2 步:呈现 iframe
以下示例展示了如何呈现零触摸 iframe:
<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
gapi.load('gapi.iframes', function() {
var options = {
'url': 'https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=web_token&dpcId=com.example.app',,
'where': document.getElementById('container'),
'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
}
var iframe = gapi.iframes.getContext().openChild(options);
});
</script>
此代码会在容器 div 内生成一个 iframe。如上所示,您可以使用“属性”选项设置要应用于 iframe 代码的属性。
iframe 网址参数
下表列出了 iframe 的所有可用参数,这些参数可作为网址参数添加到网址中,例如:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=TOKEN&dpcId=com.afwsamples.testdpc
参数 | 必需 | 说明 |
---|---|---|
token |
是 | 第 1 步返回的令牌。 |
dpcId |
是 | DPC 应用的软件包名称,即 com.example.app 。
必须进行此设置。DPC 必须已与您的 EMM 关联。
|
dpcExtras |
否 | 包含配置 extra 的网址编码 JSON 对象。这些信息会在设备设置期间传递给 DPC。 |
示例网址,假定:
- 来自 API 的 Web 令牌:
abcde
- 设备政策控制器 (DPC):
com.example
- 设备政策控制器 (DPC) 附加内容:
{“server”:“www.example.com”,“enterprise”:”example_id”}
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras={“server”:“www.example.com”,“enterprise”:”example_id”}
经过网址编码后,此网址将如下所示:
https://enterprise.google.com/android/zero-touch/embedded/companyhome?token=abcde&dpcId=com.example&dpcExtras=%7B%E2%80%9Cserver%E2%80%9D%3A%E2%80%9Cwww.example.com%E2%80%9D%2C%E2%80%9Centerprise%E2%80%9D%3A%E2%80%9Dexample_id%E2%80%9D%7D