REST Resource: enterprises.enrollmentTokens

리소스: RegistrationToken

등록 토큰

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

string

생성 중에 서버에서 생성되는 등록 토큰의 이름으로, enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} 형식입니다.

value

string

기기로 전달되고 기기의 등록을 승인하는 토큰 값입니다. 서버에서 생성하는 읽기 전용 입력란입니다.

duration

string (Duration format)

등록 토큰 유효 기간은 1분부터 Durations.MAX_VALUE(약 10,000년)까지입니다. 지정되지 않은 경우 기본 기간은 1시간입니다. 요청된 기간으로 인해 결과 expirationTimestampTimestamps.MAX_VALUE를 초과하면 expirationTimestampTimestamps.MAX_VALUE로 강제 변환됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

expirationTimestamp

string (Timestamp format)

토큰의 만료 시간입니다. 서버에서 생성하는 읽기 전용 입력란입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

policyName

string

등록된 기기에 처음 적용된 정책의 이름으로, enterprises/{enterpriseId}/policies/{policyId} 형식입니다. 지정하지 않으면 기기 사용자의 policyName가 적용됩니다. userName도 지정하지 않으면 기본적으로 enterprises/{enterpriseId}/policies/default가 적용됩니다. 이 필드를 업데이트할 때 policyId에 슬래시가 포함되지 않는 한 policyId만 지정할 수 있습니다. 정책 이름의 나머지 부분이 유추됩니다.

additionalData

string

등록 토큰과 연결된 임의 데이터입니다(선택사항). 예를 들어 등록 후 기기가 할당된 조직 단위의 ID가 포함될 수 있습니다. 기기가 토큰으로 등록되면 이 데이터는 Device 리소스의 enrollmentTokenData 필드에 표시됩니다. 데이터는 1,024자(영문 기준) 이하여야 합니다. 그렇지 않으면 생성 요청이 실패합니다.

qrCode

string

JSON 문자열로, UTF-8 표현을 사용해 이 등록 토큰으로 기기를 등록하기 위한 QR 코드를 생성할 수 있습니다. NFC를 사용하여 기기를 등록하려면 NFC 레코드에 JSON 속성의 직렬화된 java.util.Properties 표현이 포함되어야 합니다.

oneTimeOnly

boolean

등록 토큰이 일회용인지 여부입니다. 플래그를 true로 설정하면 하나의 기기만 등록에 사용할 수 있습니다.

user
(deprecated)

object (User)

이 필드는 지원 중단되었으며 값은 무시됩니다.

allowPersonalUsage

enum (AllowPersonalUsage)

이 등록 토큰으로 프로비저닝된 기기에서의 개인 사용 허용 여부를 제어합니다.

회사 소유 기기의 경우:

  • 개인 용도로 사용 설정하면 사용자가 기기에 직장 프로필을 설정할 수 있습니다.
  • 개인 사용을 중지하려면 사용자가 기기를 완전 관리형 기기로 프로비저닝해야 합니다.

개인 소유 기기의 경우:

  • 개인 용도로 사용 설정하면 사용자가 기기에 직장 프로필을 설정할 수 있습니다.
  • 개인용 사용을 사용 중지하면 기기가 프로비저닝되지 않습니다. 개인 소유 기기에서는 개인 사용을 중지할 수 없습니다.

메서드

create

지정된 기업의 등록 토큰을 만듭니다.

delete

등록 토큰을 삭제합니다.

get

만료되지 않은 활성 등록 토큰을 가져옵니다.

list

지정된 기업의 만료되지 않은 활성 등록 토큰을 나열합니다.