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

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

user

object (User)

이 등록 토큰과 연결된 사용자입니다. 등록 토큰이 생성될 때 지정되어 있으며 사용자가 존재하지 않는 경우 사용자가 생성됩니다. 이 입력란에 개인 식별 정보를 포함해서는 안 됩니다. accountIdentifier 필드만 설정하면 됩니다.

allowPersonalUsage

enum (AllowPersonalUsage)

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

회사 소유 기기의 경우:

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

개인 소유 기기의 경우:

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

방법

create

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

delete

등록 토큰을 삭제합니다.

get

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

list

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