REST Resource: enterprises.enrollmentTokens

리소스: EnrollmentToken

등록 토큰입니다.

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

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

oneTimeOnly

boolean

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

user
(deprecated)

object (User)

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

allowPersonalUsage

enum (AllowPersonalUsage)

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

회사 소유 기기의 경우:

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

개인 소유 기기의 경우:

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

방법

create

지정된 엔터프라이즈의 등록 토큰을 만듭니다.

delete

등록 토큰을 삭제합니다.

get

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

list

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