Iframe konfigurasi terkelola

Iframe konfigurasi terkelola adalah UI yang dapat disematkan dan memungkinkan admin IT menyimpan, mengedit, dan menghapus setelan konfigurasi terkelola aplikasi. Anda bisa, untuk misalnya, menampilkan tombol (atau elemen UI serupa) dalam detail aplikasi atau yang membuka iframe.

Tindakan yang tersedia untuk admin IT dari iframe

Menetapkan dan menyimpan profil konfigurasi

iframe mengambil dan menampilkan skema konfigurasi terkelola untuk aplikasi tertentu. Dalam iframe, admin IT dapat mengatur konfigurasi dan menyimpan mereka sebagai profil konfigurasi. Setiap kali admin IT menyimpan profil konfigurasi, iframe akan menampilkan ID unik yang disebut mcmId. Hal ini memungkinkan admin IT membuat beberapa profil untuk .

Edit profil konfigurasi

iframe mampu menampilkan profil konfigurasi yang disimpan. Admin IT dapat memperbarui pengaturan dalam profil dan menyimpan perubahannya.

Menghapus profil konfigurasi

Admin IT dapat menghapus profil konfigurasi dari iframe. Fitur ini dinonaktifkan secara default.

Menampilkan iframe konfigurasi terkelola di konsol

Membuat token web

Gunakan Enterprises.createWebToken untuk membuat token web yang mengidentifikasi perusahaan. Anda harus menyertakan token yang ditampilkan, bersama dengan parameter lainnya, saat merender iframe di konsol. Contoh berikut memperlihatkan cara mengambil token menggunakan metode Google Library Klien Play EMM API untuk Java.

public AdministratorWebToken getAdministratorWebToken(
    String enterpriseId,
    AdministratorWebTokenSpec tokenSpec) throws IOException {
  return androidEnterprise
     .enterprise()
     .createWebToken(enterpriseId, tokenSpec)
     .execute();
}

Merender iframe

Berikut ini contoh cara merender iframe konfigurasi terkelola:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container" style="width: 1000px; height: 1000px"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/managed/mcm?token=web_token&packageName=app_package_name',
      'where': document.getElementById('container'),
      'attributes': { style: 'height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

Parameter URL

Tabel di bawah mencantumkan semua parameter yang tersedia untuk URL iframe.

Acara iframe

Anda juga harus menangani peristiwa berikut sebagai bagian dari integrasi.

{
  "mcmId": The ID of the managed configurations profile.
  "name": The name of the updated or newly created managed configurations profile.
}

{
  "mcmId": The ID of the managed configurations profile.
}

Contoh di bawah menunjukkan cara memproses onconfigupdated, sebagai contoh:

iframe.register('onconfigupdated', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);

Pembaruan pada skema konfigurasi terkelola untuk aplikasi

Jika developer memperbarui skema konfigurasi terkelola untuk aplikasi, yang telah disimpan profil konfigurasi akan diperbaharui secara otomatis. Misalnya, jika developer menghapus opsi, opsi tersebut akan dihapus dari semua konfigurasi yang ada profil untuk aplikasi. Jika developer menambahkan opsi, nilai default untuk opsi (ditentukan oleh developer) akan ditambahkan ke semua konfigurasi yang ada profil untuk aplikasi.

Terapkan konfigurasi terkelola ke perangkat

Untuk mempelajari cara menerapkan konfigurasi terkelola ke pengguna perangkat, lihat Terapkan konfigurasi terkelola.

Memahami perilaku pilih/batalkan pilihan

iframe konfigurasi terkelola kini memungkinkan admin IT membatalkan pilihan secara eksplisit pembatasan aplikasi dari konfigurasi terkelola ketika mereka tidak membutuhkannya. Ini adalah perubahan dari perilaku sebelumnya dan dapat berdampak pada batasan apa dikirim ke aplikasi Anda berdasarkan pilihan admin.

Bagian di bawah ini menguraikan perilaku iframe konfigurasi terkelola pola batal pilihan baru ini dan apa yang diharapkan pengembang untuk dikirim sebagai bagian dari konfigurasi terkelola mereka.

Menggunakan nilai default untuk pembatasan aplikasi

Jika aplikasi melakukan pembatasan dengan jenis bool, pilihan, bilangan bulat, dapat memilih lebih dari satu atau string nilai default, nilai default akan diterapkan sebagai dari pembatasan aplikasi saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan pada pembatasan aplikasi tersebut.

Misalnya, dengan skema pembatasan aplikasi berikut:

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool",
    "defaultValue": {
        "type": "bool",
        "valueBool": false
    }
}]

Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool",
    "value": {
        "type": "bool",
        "valueBool": false
    }
}]

Tanpa menggunakan nilai default untuk pembatasan aplikasi

Jika aplikasi melakukan pembatasan dengan jenis bool, pilihan, bilangan bulat, dapat memilih lebih dari satu atau string tidak dilengkapi dengan nilai default, pembatasan aplikasi ini tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan apa pun tentang pembatasan aplikasi tersebut.

Misalnya, dengan skema pembatasan aplikasi berikut:

"restrictions": [{
    "key": "bool_key",
    "restrictionType": "bool"
    // defaultValue absent.
}]

Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [
    // Empty
]

Menggunakan paket dalam skema Anda

Bagian ini berlaku untuk paket pembatasan aplikasi:

Memiliki setidaknya satu pembatasan aplikasi anak dengan nilai default dalam pembatasan aplikasi bundle

Jika termasuk dalam paket pembatasan aplikasi setidaknya salah satu pembatasan aplikasi anak dengan jenis bool, pilihan, bilangan bulat, dapat memilih lebih dari satu atau string nilai default, nilai default akan diterapkan sebagai nilai dari pembatasan aplikasi dan nilai yang tidak memiliki nilai default akan dikecualikan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan apa pun pada pembatasan aplikasi.

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            "defaultValue": {
                "type": "bool",
                "valueBool": false
            }
        },
        {
            "key": "bool_key_2",
            "restrictionType": "bool"
            // defaultValue absent.
        }
    ]
}]

Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            "value": {
                "type": "bool",
                "valueBool": false
            }
        },
        // The bool_key_2 child app restriction is not included.
    ]
}]

Semua batasan aplikasi anak tanpa nilai default

Jika termasuk dalam paket pembatasan aplikasi semua pembatasan aplikasi anak dengan jenis bool, pilihan, bilangan bulat, dapat memilih lebih dari satu atau string tidak dilengkapi dengan nilai default, yaitu paket pembatasan aplikasi tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menerapkan perubahan pada pembatasan aplikasi tersebut.

Misalnya, dengan skema pembatasan aplikasi berikut:

"restrictions": [{
    "key": "bundle_key",
    "restrictionType": "bundle",
    "nestedRestriction": [{
            "key": "bool_key_1",
            "restrictionType": "bool",
            // defaultValue absent.
        },
        {
            "key": "bool_key_2",
            "restrictionType": "bool"
            // defaultValue absent.
        }
    ]
}]

Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [
    // Empty
]

Menggunakan bundle_array dalam skema Anda

Bagian ini berlaku untuk bundle_array pembatasan aplikasi. Tidak relevan jika aplikasi turunan membatasi dengan jenis bool, pilihan, bilangan bulat, dapat memilih lebih dari satu atau string memiliki nilai default.

Misalnya, dengan skema pembatasan aplikasi berikut:

"restrictions": [{
    "key": "bundle_array_key",
    "restrictionType": "bundleArray",
    "nestedRestriction": [{
        "key": "bundle_key",
        "restrictionType": "bundle",
        "nestedRestriction": [{
            "key": "bool_key",
            "restrictionType": "bool",
            "defaultValue": {
                "type": "bool",
                "valueBool": true
            }
        }]
    }]
}]

Memiliki setidaknya satu grup paket dalam pembatasan aplikasi bundle_array

Jika minimal satu paket grup ditetapkan, yaitu bundle_array pembatasan aplikasi akan disertakan saat admin menyimpan konfigurasi terkelola.

Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [{
    "key": "bundle_array_key",
    "restrictionType": "bundleArray",
    "nestedRestriction": [{
        "key": "bundle_key",
        "restrictionType": "bundle",
        "nestedRestriction": [{
            "key": "bool_key",
            "restrictionType": "bool",
            "value": {
                "type": "bool",
                "valueBool": true
            }
        }]
    }]
}]

Tidak ada grup paket dalam pembatasan aplikasi bundle_array

bundle_array pembatasan aplikasi tidak akan disertakan saat admin menyimpan konfigurasi terkelola tanpa menambahkan paket ras. Pembatasan aplikasi yang dikirim ke perangkat adalah:

"restrictions": [
    // Empty
]