REST Resource: enterprises.enrollmentTokens

Risorsa: EnrollmentToken

Un token di registrazione.

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

string

Il nome del token di registrazione, generato dal server durante la creazione, nel formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Il valore del token che viene trasmesso al dispositivo e che autorizza la registrazione del dispositivo. Questo è un campo di sola lettura generato dal server.
duration

string (Duration format)

Il periodo di tempo di validità del token di registrazione, che va da 1 minuto a Durations.MAX_VALUE, circa 10.000 anni. Se non specificata, la durata predefinita è 1 ora. Tieni presente che se la durata richiesta fa sì che il valore di expirationTimestamp risultante superi Timestamps.MAX_VALUE, allora expirationTimestamp viene forzato a Timestamps.MAX_VALUE.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
expirationTimestamp

string (Timestamp format)

La scadenza del token. Questo è un campo di sola lettura generato dal server.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
policyName

string

Il nome del criterio inizialmente applicato al dispositivo registrato, nel formato enterprises/{enterpriseId}/policies/{policyId}. Se non specificato, viene applicato il policyName per l'utente del dispositivo. Se non è specificato anche userName, enterprises/{enterpriseId}/policies/default viene applicato per impostazione predefinita. Quando aggiorni questo campo, puoi specificare solo policyId a condizione che policyId non contenga barre. Il resto del nome del criterio verrà dedotto.
additionalData

string

Dati arbitrari facoltativi associati al token di registrazione. che potrebbe contenere, ad esempio, l'ID di un'unità organizzativa a cui è assegnato il dispositivo dopo la registrazione. Dopo la registrazione di un dispositivo con il token, questi dati vengono esposti nel campo enrollmentTokenData della risorsa Device. I dati devono contenere al massimo 1024 caratteri, altrimenti la richiesta di creazione avrà esito negativo.
qrCode

string

Una stringa JSON la cui rappresentazione UTF-8 può essere utilizzata per generare un codice QR per registrare un dispositivo con questo token di registrazione. Per registrare un dispositivo tramite NFC, il record NFC deve contenere una rappresentazione java.util.Properties serializzata delle proprietà nel formato JSON.
oneTimeOnly

boolean

Indica se il token di registrazione è utilizzabile una sola volta. Se il flag è impostato su true, solo un dispositivo può utilizzarlo per la registrazione.
user
(deprecated)

object (User)

Questo campo è obsoleto e il valore viene ignorato.
allowPersonalUsage

enum (AllowPersonalUsage)

Consente di stabilire se consentire o meno l'utilizzo personale su un dispositivo di cui è stato eseguito il provisioning con questo token di registrazione.

Per i dispositivi di proprietà dell'azienda:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale richiede che l'utente esegua il provisioning del dispositivo come dispositivo completamente gestito.

Per i dispositivi di proprietà personale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale impedirà il provisioning del dispositivo. Non è possibile disattivare l'utilizzo personale su un dispositivo di proprietà personale.

Metodi

create

 Crea un token di registrazione per una determinata azienda.

delete

 Elimina un token di registrazione.

get

 Recupera un token di registrazione attivo e non scaduto.

list

 Elenca i token di registrazione attivi e non scaduti per una determinata azienda.