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 memberikan otorisasi kepada perangkat untuk mendaftar. Ini adalah kolom hanya baca yang dibuat oleh server.

duration

string (Duration format)

Durasi validitas token pendaftaran, mulai dari 1 menit hingga Durations.MAX_VALUE, yaitu sekitar 10.000 tahun. Jika tidak ditentukan, durasi defaultnya adalah 1 jam. Perhatikan bahwa jika durasi yang diminta menyebabkan expirationTimestamp yang dihasilkan melebihi Timestamps.MAX_VALUE, expirationTimestamp akan dikonversi 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 format 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. Nama kebijakan lainnya akan disimpulkan.

additionalData

string

Data arbitrer opsional yang terkait dengan token pendaftaran. Ini dapat berisi, misalnya, ID unit organisasi tempat perangkat ditetapkan setelah pendaftaran. Setelah perangkat mendaftar dengan token, data ini akan ditampilkan di kolom enrollmentTokenData dari 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 yang diserialisasi dari properti dalam JSON.

oneTimeOnly

boolean

Apakah token pendaftaran hanya dapat digunakan satu kali. Jika tanda ditetapkan ke benar, 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:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna menyiapkan profil kerja di perangkat.
  • Untuk menonaktifkan penggunaan pribadi, pengguna harus menyediakan perangkat sebagai perangkat terkelola sepenuhnya.

Untuk perangkat milik pribadi:

  • Mengaktifkan penggunaan pribadi memungkinkan pengguna 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.