REST Resource: enterprises.enrollmentTokens

Zasób: EnrollmentToken

Token rejestracji.

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

string

Nazwa tokena rejestracji, która jest generowana przez serwer podczas tworzenia, w formacie enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Wartość tokena, która jest przekazywana do urządzenia i autoryzuje urządzenie do rejestracji. To jest pole tylko do odczytu wygenerowane przez serwer.

duration

string (Duration format)

Okres ważności tokena rejestracji wynosi od 1 minuty do Durations.MAX_VALUE i około 10 tys. lat. Jeśli nie podasz żadnej wartości, domyślny czas to 1 godzina. Pamiętaj, że jeśli żądany czas trwania powoduje, że wynikowa wartość expirationTimestamp przekracza Timestamps.MAX_VALUE, wartość expirationTimestamp jest przekształcana na Timestamps.MAX_VALUE.

Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „s”. Przykład: "3.5s".

expirationTimestamp

string (Timestamp format)

czas ważności tokena, To jest pole tylko do odczytu wygenerowane przez serwer.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

policyName

string

Nazwa zasady, która została początkowo zastosowana do zarejestrowanego urządzenia, ma postać enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie określono tego ustawienia, stosowana będzie zasada policyName dotycząca użytkownika urządzenia. Jeśli nie określono właściwości userName, stosowana jest domyślnie zasada enterprises/{enterpriseId}/policies/default. Aktualizując to pole, możesz podać tylko policyId, o ile pole policyId nie zawiera żadnych ukośników. Pozostałe nazwy zasady zostaną ustalone.

additionalData

string

Opcjonalne, dowolne dane powiązane z tokenem rejestracji. Może to być na przykład identyfikator jednostki organizacyjnej, do której urządzenie jest przypisane po rejestracji. Gdy urządzenie zarejestruje się przy użyciu tokena, te dane będą widoczne w polu enrollmentTokenData zasobu Device. Dane mogą zawierać maksymalnie 1024 znaki. w przeciwnym razie utworzenie konta zakończy się niepowodzeniem.

qrCode

string

Ciąg znaków JSON, którego reprezentacja UTF-8 może być użyta do wygenerowania kodu QR w celu zarejestrowania urządzenia przy użyciu tego tokena rejestracji. Aby można było zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną reprezentację właściwości java.util.Properties w pliku JSON.

oneTimeOnly

boolean

Określa, czy token rejestracji jest przeznaczony tylko do jednorazowego użytku. Jeśli flaga ma wartość Prawda, tylko jedno urządzenie może jej używać do rejestracji.

user
(deprecated)

object (User)

To pole zostało wycofane, a jego wartość jest ignorowana.

allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu obsługującym ten token rejestracji dozwolone jest korzystanie z osobistych danych.

W przypadku urządzeń należących do firmy:

  • Włączenie opcji użytku osobistego umożliwia użytkownikowi skonfigurowanie na urządzeniu profilu służbowego.
  • Aby wyłączyć użytek osobisty, użytkownik musi udostępnić urządzenie jako w pełni zarządzane.

W przypadku urządzeń należących do użytkownika:

  • Włączenie opcji użytku osobistego umożliwia użytkownikowi skonfigurowanie na urządzeniu profilu służbowego.
  • Wyłączenie trybu użytku osobistego uniemożliwi obsługę administracyjną urządzenia. Nie można wyłączyć korzystania do celów osobistych na urządzeniu należącym do użytkownika.

Metody

create

Tworzy token rejestracji dla danej firmy.

delete

Usuwa token rejestracji.

get

Pobiera aktywny, niewygasły token rejestracji.

list

Wyświetla listę aktywnych, niewygasłych tokenów rejestracji dla danej firmy.