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óry jest generowany przez serwer podczas tworzenia w formie enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Wartość tokena przekazywana na urządzenie i upoważniająca je do rejestracji. To pole jest tylko do odczytu i jest generowane przez serwer.

duration

string (Duration format)

Okres ważności tokena rejestracji, od 1 minuty do Durations.MAX_VALUE (około 10 tysięcy lat). Jeśli nie określisz tu żadnej wartości, czas trwania będzie domyślnie ustawiony na 1 godzinę. Jeśli żądany czas trwania powoduje, że wynik expirationTimestamp przekracza Timestamps.MAX_VALUE, wartość expirationTimestamp jest przymusowo ustawiana na Timestamps.MAX_VALUE.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

expirationTimestamp

string (Timestamp format)

Czas ważności tokena. To pole jest tylko do odczytu i jest generowane przez serwer.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

policyName

string

Nazwa zasady początkowo zastosowana do zarejestrowanego urządzenia w formie enterprises/{enterpriseId}/policies/{policyId}. Jeśli nie zostanie określony, zostanie zastosowany policyName użytkownika urządzenia. Jeśli nie określisz też wartości userName, domyślnie zostanie zastosowana wartość enterprises/{enterpriseId}/policies/default. Podczas aktualizowania tego pola możesz podać tylko policyId, o ile policyId nie zawiera żadnych ukośników. Pozostała część nazwy zasady zostanie wywnioskowana.

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 zostało przypisane po zarejestrowaniu. Gdy urządzenie zostanie zarejestrowane za pomocą tokena, te dane będą widoczne w polu enrollmentTokenData zasobu Device. Dane mogą mieć maksymalnie 1024 znaki. W przeciwnym razie żądanie utworzenia nie zostanie zrealizowane.

qrCode

string

Ciąg znaków JSON, którego reprezentacja w formacie UTF-8 może służyć do generowania kodu QR umożliwiającego rejestrację urządzenia przy użyciu tego tokena rejestracji. Aby zarejestrować urządzenie za pomocą NFC, rekord NFC musi zawierać zserializowaną reprezentację java.util.Properties właściwości w formacie JSON.

oneTimeOnly

boolean

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 i jego wartość jest ignorowana.

allowPersonalUsage

enum (AllowPersonalUsage)

Określa, czy na urządzeniu z tym tokenem rejestracji jest dozwolone korzystanie osobiste.

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

  • Włączenie korzystania z urządzenia do celów osobistych pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • Aby wyłączyć korzystanie z urządzenia do celów osobistych, użytkownik musi skonfigurować je jako urządzenie w pełni zarządzane.

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

  • Włączenie korzystania z urządzenia do celów osobistych pozwala użytkownikowi skonfigurować profil służbowy na urządzeniu.
  • Wyłączenie korzystania z urządzenia uniemożliwi jego przygotowanie do obsługi administracyjnej. Na urządzeniu osobistym nie można wyłączyć funkcji do użytku osobistego.

Metody

create

Tworzy token rejestracji dla danej firmy.

delete

Usuwa token rejestracji.

get

Pobiera aktywny, niewygasły token rejestracji.

list

Lista aktywnych, niewygasłych tokenów rejestracji w danym przedsiębiorstwie.