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 lo autorizza alla registrazione. Questo è un campo di sola lettura generato dal server.

duration

string (Duration format)

La durata del token di registrazione, che può variare da 1 minuto a Durations.MAX_VALUE, ovvero circa 10.000 anni. Se non specificato, la durata predefinita è 1 ora. Tieni presente che se la durata richiesta fa sì che expirationTimestamp risulti superiore a Timestamps.MAX_VALUE, 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 data e l'ora di scadenza del token. Questo è un campo di sola lettura generato dal server.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 anche userName non è specificato, per impostazione predefinita viene applicato enterprises/{enterpriseId}/policies/default. 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 facoltativi e arbitrari associati al token di registrazione. Potrebbe contenere, ad esempio, l'ID di un'unità organizzativa a cui viene assegnato il dispositivo dopo la registrazione. Dopo la registrazione di un dispositivo con il token, questi dati verranno esposti nel campo enrollmentTokenData della risorsa Device. I dati devono avere una lunghezza massima di 1024 caratteri. In caso contrario, 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 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 è stato ritirato e il valore viene ignorato.

allowPersonalUsage

enum (AllowPersonalUsage)

Controlla se l'utilizzo personale è consentito su un dispositivo per 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.
  • Per disattivare l'utilizzo personale, l'utente deve eseguire 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 sul dispositivo di tua proprietà.

Metodi

create

Crea un token di registrazione per una determinata azienda.

delete

Consente di eliminare 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.