REST Resource: enterprises.enrollmentTokens

Resource: EnrollmentToken

Token pendaftaran.

Representasi JSON
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Kolom
name

string

Nama token pendaftaran, yang dibuat oleh server selama pembuatan, dalam bentuk enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Nilai token yang diteruskan ke perangkat dan mengizinkan perangkat untuk mendaftar. Ini adalah kolom hanya baca yang dibuat oleh server.

duration

string (Duration format)

Masa berlaku token pendaftaran, mulai dari 1 menit hingga Durations.MAX_VALUE, sekitar 10.000 tahun. Jika tidak ditentukan, durasi default adalah 1 jam. Perhatikan bahwa jika durasi yang diminta menyebabkan expirationTimestamp yang dihasilkan melebihi Timestamps.MAX_VALUE, expirationTimestamp dipaksa menjadi Timestamps.MAX_VALUE.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

expirationTimestamp

string (Timestamp format)

Waktu habis masa berlaku token. Ini adalah kolom hanya baca yang dibuat oleh server.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

policyName

string

Nama kebijakan yang awalnya diterapkan ke perangkat terdaftar, dalam bentuk enterprises/{enterpriseId}/policies/{policyId}. Jika tidak ditentukan, policyName untuk pengguna perangkat akan diterapkan. Jika userName juga tidak ditentukan, enterprises/{enterpriseId}/policies/default akan diterapkan secara default. Saat memperbarui kolom ini, Anda hanya dapat menentukan policyId selama policyId tidak berisi garis miring apa pun. Nama kebijakan lainnya akan disimpulkan.

additionalData

string

Data arbitrer yang bersifat opsional yang terkait dengan token pendaftaran. Informasi ini dapat berisi, misalnya, ID unit org tempat perangkat ditetapkan setelah pendaftaran. Setelah perangkat didaftarkan dengan token, data ini akan ditampilkan di kolom enrollmentTokenData pada resource Device. Data harus terdiri dari 1.024 karakter atau kurang; jika tidak, permintaan pembuatan akan gagal.

qrCode

string

String JSON yang representasi UTF-8-nya dapat digunakan untuk membuat kode QR guna mendaftarkan perangkat dengan token pendaftaran ini. Untuk mendaftarkan perangkat menggunakan NFC, data NFC harus berisi representasi java.util.Properties serial dari properti di JSON.

oneTimeOnly

boolean

Apakah token pendaftaran hanya digunakan satu kali. Jika flag ini disetel ke true, hanya satu perangkat yang dapat menggunakannya untuk pendaftaran.

user
(deprecated)

object (User)

Kolom ini tidak digunakan lagi dan nilainya diabaikan.

allowPersonalUsage

enum (AllowPersonalUsage)

Mengontrol apakah penggunaan pribadi diizinkan di perangkat yang disediakan dengan token pendaftaran ini.

Untuk perangkat milik perusahaan:

  • Dengan mengaktifkan penggunaan pribadi, pengguna dapat menyiapkan profil kerja di perangkat.
  • Menonaktifkan penggunaan pribadi mengharuskan pengguna menyediakan perangkat sebagai perangkat terkelola sepenuhnya.

Untuk perangkat milik pribadi:

  • Dengan mengaktifkan penggunaan pribadi, pengguna dapat menyiapkan profil kerja di perangkat.
  • Menonaktifkan penggunaan pribadi akan mencegah penyediaan perangkat. Penggunaan pribadi tidak dapat dinonaktifkan di perangkat milik pribadi.

Metode

create

Membuat token pendaftaran untuk perusahaan tertentu.

delete

Menghapus token pendaftaran.

get

Mendapatkan token pendaftaran yang aktif dan belum habis masa berlakunya.

list

Mencantumkan token pendaftaran yang aktif dan belum habis masa berlakunya untuk perusahaan tertentu.