REST Resource: enterprises.enrollmentTokens

Ressource: EnrollmentToken

Ein Registrierungstoken.

JSON-Darstellung
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Felder
name

string

Der Name des Registrierungstokens, das vom Server während der Erstellung generiert wird, im Format enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Der Tokenwert, der an das Gerät übergeben wird und es zur Registrierung autorisiert. Dieses Feld ist schreibgeschützt und wird vom Server generiert.

duration

string (Duration format)

Die Gültigkeitsdauer des Registrierungstokens, von 1 Minute bis Durations.MAX_VALUE, etwa 10.000 Jahre. Wenn keine Angabe erfolgt, beträgt die Standarddauer 1 Stunde. Hinweis: Wenn die angeforderte Dauer dazu führt, dass expirationTimestamp Timestamps.MAX_VALUE überschreitet, wird expirationTimestamp auf Timestamps.MAX_VALUE festgelegt.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

expirationTimestamp

string (Timestamp format)

Die Ablaufzeit des Tokens. Dieses Feld ist schreibgeschützt und wird vom Server generiert.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

policyName

string

Der Name der Richtlinie, die ursprünglich auf das registrierte Gerät angewendet wurde, im Format enterprises/{enterpriseId}/policies/{policyId}. Wenn keine Angabe erfolgt, wird die policyName für den Nutzer des Geräts angewendet. Wenn auch userName nicht angegeben ist, wird standardmäßig enterprises/{enterpriseId}/policies/default angewendet. Beim Aktualisieren dieses Felds können Sie nur die policyId angeben, sofern sie keine Schrägstriche enthält.policyId Der Rest des Richtliniennamens wird abgeleitet.

additionalData

string

Optionale beliebige Daten, die mit dem Registrierungstoken verknüpft sind. Dies kann beispielsweise die ID einer Organisationseinheit sein, der das Gerät nach der Registrierung zugewiesen wird. Nachdem ein Gerät mit dem Token registriert wurde, werden diese Daten im Feld enrollmentTokenData der Ressource Device freigegeben. Die Daten dürfen maximal 1.024 Zeichen lang sein. Andernfalls schlägt der Erstellungsantrag fehl.

qrCode

string

Ein JSON-String, dessen UTF-8-Darstellung zum Generieren eines QR-Codes verwendet werden kann, um ein Gerät mit diesem Registrierungstoken zu registrieren. Wenn Sie ein Gerät per NFC registrieren möchten, muss der NFC-Eintrag eine serialisierte java.util.Properties-Darstellung der Eigenschaften in der JSON enthalten.

oneTimeOnly

boolean

Ob das Registrierungstoken nur einmal verwendet werden kann. Wenn das Flag auf „true“ gesetzt ist, kann es nur von einem Gerät für die Registrierung verwendet werden.

user
(deprecated)

object (User)

Die Verwendung dieses Feldes wurde eingestellt und der Wert wird ignoriert.

allowPersonalUsage

enum (AllowPersonalUsage)

Bestimmt, ob die private Nutzung auf einem Gerät zulässig ist, das mit diesem Registrierungstoken bereitgestellt wurde.

Für unternehmenseigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, kann der Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Wenn die private Nutzung deaktiviert werden soll, muss der Nutzer das Gerät als vollständig verwaltetes Gerät bereitstellen.

Für eigene Geräte:

  • Wenn Sie die private Nutzung aktivieren, kann der Nutzer ein Arbeitsprofil auf dem Gerät einrichten.
  • Wenn Sie die private Nutzung deaktivieren, kann das Gerät nicht bereitgestellt werden. Die private Nutzung kann auf einem privaten Gerät nicht deaktiviert werden.

Methoden

create

Erstellt ein Registrierungstoken für ein bestimmtes Unternehmen.

delete

Löscht ein Registrierungstoken.

get

Ruft ein aktives, nicht abgelaufenes Registrierungstoken ab.

list

Listet aktive, nicht abgelaufene Registrierungstokens für ein bestimmtes Unternehmen auf.