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 el servidor genera durante la creación, en el formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

El valor del token que se transfiere al dispositivo y autoriza al dispositivo a inscribirse. Este es un campo de solo lectura generado por el servidor.

duration

string (Duration format)

El período de validez del token de inscripción varía entre 1 minuto y 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 provoca que expirationTimestamp supere los Timestamps.MAX_VALUE, entonces expirationTimestamp se fuerza a Timestamps.MAX_VALUE.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

expirationTimestamp

string (Timestamp format)

Es la hora de vencimiento del token. Este es un campo de solo lectura generado por el servidor.

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

policyName

string

Es el nombre de la política aplicada inicialmente al dispositivo inscrito, en 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 aplica enterprises/{enterpriseId}/policies/default de forma predeterminada. Cuando actualizas este campo, puedes especificar solo el policyId, siempre que el policyId no contenga ninguna barra diagonal. 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 incluir, por ejemplo, el ID de una unidad organizativa a la que se asigna el dispositivo después de la inscripción. Después de que un dispositivo se inscribe con el token, estos datos se mostrarán 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

Una string JSON cuya representación UTF-8 se puede usar para generar un código QR a fin de inscribir un dispositivo con este token de inscripción Para inscribir un dispositivo mediante NFC, el registro NFC debe contener una representación serializada java.util.Properties de las propiedades en el JSON.

oneTimeOnly

boolean

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

user

object (User)

Indica 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 de propiedad personal:

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

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 sin vencer de una empresa determinada.