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 passato al dispositivo e autorizza la registrazione del dispositivo. Questo è un campo di sola lettura generato dal server.

duration

string (Duration format)

Il periodo di tempo in cui il token di registrazione è valido (compreso tra 1 minuto e 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 expirationTimestamp risultante superi Timestamps.MAX_VALUE, il valore expirationTimestamp viene forzato a Timestamps.MAX_VALUE.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

expirationTimestamp

string (Timestamp format)

La data e l'ora di scadenza del token. Questo è un campo di sola lettura generato dal server.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 applicato inizialmente al dispositivo registrato, nel formato enterprises/{enterpriseId}/policies/{policyId}. Se non specificato, viene applicato il policyName per l'utente del dispositivo. Se non viene specificato anche userName, viene applicato enterprises/{enterpriseId}/policies/default per impostazione predefinita. Quando aggiorni questo campo, puoi specificare solo il valore policyId, a condizione che policyId non contenga barre. Il resto del nome del criterio verrà dedotto.

additionalData

string

Dati arbitrari e facoltativi associati al token di registrazione. che potrebbe contenere, ad esempio, l'ID di un'unità organizzativa a cui il dispositivo è assegnato 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 non andrà a buon fine.

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 file JSON.

oneTimeOnly

boolean

Indica se il token di registrazione è utilizzabile una sola volta. Se il flag viene impostato su true, può essere utilizzato per la registrazione da un solo dispositivo.

user
(deprecated)

object (User)

Questo campo è obsoleto e il valore viene ignorato.

allowPersonalUsage

enum (AllowPersonalUsage)

Consente di controllare se l'utilizzo personale è consentito 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. L'utilizzo personale non può essere disattivato 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.