REST Resource: enterprises.enrollmentTokens

Recurso: RegistrationToken

Um token de registro.

Representação JSON
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Campos
name

string

O nome do token de registro, que é gerado pelo servidor durante a criação, no formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

O valor do token que é transmitido para o dispositivo e que o autoriza a registrar. Este é um campo somente leitura gerado pelo servidor.

duration

string (Duration format)

O período em que o token de registro é válido, variando de 1 minuto a Durations.MAX_VALUE, aproximadamente 10.000 anos. Se não for especificada, a duração padrão será de uma hora. Se a duração solicitada fizer com que o expirationTimestamp resultante exceda Timestamps.MAX_VALUE, então expirationTimestamp será forçado para Timestamps.MAX_VALUE.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

expirationTimestamp

string (Timestamp format)

O prazo de validade do token. Este é um campo somente leitura gerado pelo servidor.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

policyName

string

O nome da política inicialmente aplicada ao dispositivo registrado, no formato enterprises/{enterpriseId}/policies/{policyId}. Se não for especificado, o policyName do usuário do dispositivo será aplicado. Se userName também não for especificado, enterprises/{enterpriseId}/policies/default será aplicado por padrão. Ao atualizar esse campo, especifique apenas o policyId, desde que o policyId não contenha barras. O restante do nome da política será inferido.

additionalData

string

Dados arbitrários opcionais associados ao token de registro. Isso pode conter, por exemplo, o ID de uma unidade organizacional a que o dispositivo é atribuído após o registro. Depois que um dispositivo for registrado com o token, esses dados vão ficar expostos no campo enrollmentTokenData do recurso Device. Os dados precisam ter 1.024 caracteres ou menos. Caso contrário, a solicitação de criação vai falhar.

qrCode

string

Uma string JSON com representação UTF-8 que pode ser usada para gerar um QR code e registrar um dispositivo com esse token de registro. Para registrar um dispositivo usando NFC, o registro NFC precisa conter uma representação java.util.Properties serializada das propriedades no JSON.

oneTimeOnly

boolean

Indica se o token de registro é para uso único. Se o flag for definido como verdadeiro, apenas um dispositivo poderá usá-lo para registro.

user
(deprecated)

object (User)

Este campo está obsoleto, e o valor será ignorado.

allowPersonalUsage

enum (AllowPersonalUsage)

Controla se o uso pessoal é permitido em um dispositivo provisionado com esse token de registro.

Para dispositivos da empresa:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • A desativação do uso pessoal exige que o usuário provisione o dispositivo como um dispositivo totalmente gerenciado.

Para dispositivos pessoais:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • A desativação do uso pessoal impedirá o provisionamento do dispositivo. O uso pessoal não pode ser desativado em dispositivos pessoais.

Métodos

create

Cria um token de registro para uma determinada empresa.

delete

Exclui um token de registro.

get

Recebe um token de registro ativo e não expirado.

list

Lista os tokens de registro ativos e não expirados de uma determinada empresa.