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, che viene generato dal server durante la creazione, nel formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Il valore del token trasmesso al dispositivo e autorizza la registrazione del dispositivo. Si tratta di un campo di sola lettura generato dal server.

duration

string (Duration format)

Il periodo 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 provoca il superamento di Timestamps.MAX_VALUE in expirationTimestamp, il valore di expirationTimestamp viene costretto 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 di scadenza del token. Si tratta di un campo di sola lettura generato dal server.

Un timestamp in 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 userName non è specificato, 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 e associati al token di registrazione. Potrebbe contenere, ad esempio, l'ID di un'unità organizzativa a cui il dispositivo è assegnato dopo la registrazione. Dopo che un dispositivo si registra con il token, questi dati verranno 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 che utilizza la tecnologia NFC, il record NFC deve contenere una rappresentazione serializzata di java.util.Properties delle proprietà nel file 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

object (User)

L'utente associato a questo token di registrazione. Se specificato quando il token di registrazione viene creato e l'utente non esiste, l'utente verrà creato. Questo campo non deve contenere informazioni che consentono l'identificazione personale. Deve essere impostato solo il campo accountIdentifier.

allowPersonalUsage

enum (AllowPersonalUsage)

Specifica 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 personali:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale impedirà al dispositivo di eseguire il provisioning. L'utilizzo personale non può essere disattivato sul dispositivo di proprietà personale.

Metodi

create

Crea un token di registrazione per una determinata azienda.

delete

Elimina un token di registrazione.

get

Riceve un token di registrazione attivo non scaduto.

list

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