REST Resource: enterprises.enrollmentTokens

Recurso: EnrollmentToken

Un token de inscripción.

Representación 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

El nombre del token de inscripción, que genera el servidor durante la creación, con el formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Es el valor del token que se pasa al dispositivo y autoriza su inscripción. Este es un campo de solo lectura que genera el servidor.
duration

string (Duration format)

El tiempo de validez del token de inscripción, que va desde 1 minuto hasta el Durations.MAX_VALUE, aproximadamente 10,000 años. Si no se especifica, la duración predeterminada es de 1 hora. Ten en cuenta que, si la duración solicitada hace que las expirationTimestamp resultantes superen Timestamps.MAX_VALUE, se forzará expirationTimestamp a Timestamps.MAX_VALUE.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".
expirationTimestamp

string (Timestamp format)

La hora de vencimiento del token. Este es un campo de solo lectura que genera el servidor.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
policyName

string

Es el nombre de la política que se aplicó inicialmente al dispositivo inscrito, con el formato enterprises/{enterpriseId}/policies/{policyId}. Si no se especifica, se aplica el policyName para el usuario del dispositivo. Si tampoco se especifica userName, se aplicará enterprises/{enterpriseId}/policies/default de forma predeterminada. Cuando actualizas este campo, solo puedes especificar el policyId, siempre que policyId no contenga barras. Se inferirá el resto del nombre de la política.
additionalData

string

Datos arbitrarios opcionales asociados con el token de inscripción. Esto podría contener, por ejemplo, el ID de una unidad organizativa a la que se asigne el dispositivo después de la inscripción. Después de que un dispositivo se inscribe con el token, estos datos se exponen en el campo enrollmentTokenData del recurso Device. Los datos deben tener 1,024 caracteres o menos; de lo contrario, la solicitud de creación fallará.
qrCode

string

Es una cadena JSON cuya representación en UTF-8 permite generar un código QR para inscribir un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro NFC debe contener una representación serializada de java.util.Properties de las propiedades en JSON.
oneTimeOnly

boolean

Indica si el token de inscripción es para un solo uso. Si la marca se establece como verdadera, solo un dispositivo podrá usarla para el registro.
user

object (User)

El usuario asociado con este token de inscripción. Si se especifica cuando se crea el token de inscripción y el usuario no existe, se creará el usuario. Este campo no debe contener información de identificación personal. Solo se debe establecer el campo accountIdentifier.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla si se permite el uso personal en un dispositivo aprovisionado con este token de inscripción.

Para dispositivos empresariales:

  • Si habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si se inhabilita el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

Para dispositivos personales:

  • Si habilita el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, no se aprovisionará el dispositivo. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.

Métodos

create

 Crea un token de inscripción para una empresa determinada.

delete

 Borra un token de inscripción.

get

 Obtiene un token de inscripción activo y no vencido.

list

 Muestra una lista de los tokens de inscripción activos y no vencidos de una empresa determinada.