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

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

value

string

Es el valor del token que se pasa al dispositivo y lo autoriza a inscribirse. Este es un campo de solo lectura que genera el servidor.

duration

string (Duration format)

Es la cantidad de tiempo durante la cual es válido el token de inscripción, que puede variar de 1 minuto a 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 el expirationTimestamp resultante supere Timestamps.MAX_VALUE, expirationTimestamp se convierte en Timestamps.MAX_VALUE.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

expirationTimestamp

string (Timestamp format)

Es 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 una 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, en el formato enterprises/{enterpriseId}/policies/{policyId}. Si no se especifica, se aplica el policyName del usuario del dispositivo. Si tampoco se especifica userName, se aplica enterprises/{enterpriseId}/policies/default de forma predeterminada. Cuando actualices este campo, puedes especificar solo el policyId, siempre que no contenga barras diagonales.policyId Se inferirá el resto del nombre de la política.

additionalData

string

Datos arbitrarios opcionales asociados con el token de inscripción. Por ejemplo, podría contener 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 inscriba con el token, estos datos se expondrá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

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

oneTimeOnly

boolean

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

user
(deprecated)

object (User)

Este campo dejó de estar disponible y se ignora el valor.

allowPersonalUsage

enum (AllowPersonalUsage)

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

Para dispositivos de la empresa:

  • Si habilitas el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Para inhabilitar el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

Para dispositivos de propiedad personal:

  • Si habilitas el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, se impedirá que el dispositivo se aprovisione. 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 sin vencer.

list

Muestra una lista de los tokens de inscripción activos y sin vencer de una empresa determinada.