重要: Play EMM API の新しい登録受け付けは終了しました。詳細

このページは Cloud Translation API によって翻訳されました。

ゼロタッチ iframe

ゼロタッチ iframe を使用すると、ゼロタッチを直接 EMM に埋め込むことができるゼロタッチ対応デバイスを簡単に構成できます。向上しますiframe を使用すると、DPC と追加のプロビジョニング項目を設定できるゼロタッチデバイスのセットアップ時に使用します。

IT 管理者が初めて iframe を開くと、企業にゼロタッチ登録アカウントを作成できます

IT 管理者がゼロタッチ登録アカウントを企業にリンクすると、リンクされているゼロタッチ登録アカウントのリストが表示されます。また、企業デバイス向けのデフォルトのゼロタッチ設定です。

機能

このセクションでは、ゼロタッチ iframe で利用できる機能について説明します。対象 iframe を埋め込んでこれらの機能を実装する方法については、コンソールに iframe を追加します。

ゼロタッチ登録アカウントを企業にリンクする

iframe を使用することで、IT 管理者はゼロタッチ登録アカウントとできます。このプロセスの一環として、IT 管理者はデフォルトのゼロタッチゼロタッチ登録アカウントのデバイスに使用するプロファイルです。このフローは以下で説明します。

IT 管理者が以前にゼロタッチ登録アカウントを iframe を開くと、パスワードの入力を求めるメッセージが表示されます。

ゼロタッチ iframe リンクフロー — **図 2.**ゼロタッチ iframe の開始

IT 管理者はゼロタッチ登録アカウントのリストを確認し、企業にリンクします

ゼロタッチ iframe アカウント一覧画面 — **図 3.**アカウントリスト画面

ゼロタッチ iframe を使用すると、ゼロタッチ設定が自動的に生成されます。この IT 管理者が構成を変更できません。DPC をカスタマイズしたり、プロビジョニングエクストラを設定します。このモジュールの設定方法については、iframe URL パラメータをご覧ください。

ゼロタッチ iframe サポート情報画面 — **図 5.**サポート情報の入力画面

ゼロタッチを有効にしたときに表示されるサポート情報を IT 管理者が入力する確認します。IT 管理者が [保存]をクリックすると完了すると、ユーザーはゼロタッチ iframe のホームページにリダイレクトされ、そこでリンクされたアカウントを管理できるようになります。

リンクされたゼロタッチ登録アカウントの表示と管理

IT 管理者は iframe を使用して、リンクされたゼロタッチ登録アカウントとデフォルトのゼロタッチプロファイルとサポート情報が含まれています。またゼロタッチ登録アカウントのリンクを解除したり、ゼロタッチ登録アカウントのリンクを解除したりできます。

ゼロタッチ iframe のホームページの例については、図 1 をご覧ください。

ゼロタッチポータルでリンク済みアカウントのデバイスを表示する

ゼロタッチ登録アカウントが企業にリンクされると、ゼロタッチ登録プロファイルが設定されていないゼロタッチ登録アカウントがエンタープライズゼロタッチプロファイルで自動的に設定されます。

ゼロタッチコンソール内では、これらのデバイスには [Enterprise 選択します。IT 管理者は、このプロファイルの設定と設定解除をゼロタッチ登録アカウントのデバイスなどですただし、プロファイルは変更できません。

ゼロタッチ登録アカウントのリンクを解除すると、 [企業のデフォルトプロファイル] では、このプロファイルは未設定になります。これらのデバイスは別のプロファイルで設定されます。

コンソールに iframe を追加する

ステップ 1: ウェブトークンを生成する

企業を識別するウェブトークンを生成するには、 Enterprises.createWebToken。次の例は、Terraform を使用してトークンを取得する方法を示しています。 Java 用 Google Play EMM API クライアントライブラリなお、ゼロタッチ iframe は managed Play とは別に有効にする必要があります。使用できます。

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 が生成されます。適用する属性属性を「attributes」で指定できます。オプションを使用します

iframe URL パラメータ

次の表に、iframe で使用可能なすべてのパラメータを示します。 URL パラメータとして URL に追加します。次に例を示します。

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`	いいえ	プロビジョニングエクストラを含む、URL エンコードされた JSON オブジェクト。これらはを DPC に送信します。

URL の例。前提:

API からのウェブトークン: 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”}

URL エンコードすると、この URL は次のようになります。

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