REST Resource: enterprises.enrollmentTokens

Tài nguyên: EnrollmentToken

Mã thông báo đăng ký.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Trường
name

string

Tên của mã thông báo đăng ký do máy chủ tạo trong quá trình tạo, ở dạng enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

Giá trị mã thông báo được truyền đến thiết bị và cho phép thiết bị đăng ký. Đây là trường chỉ có thể đọc do máy chủ tạo.

duration

string (Duration format)

Khoảng thời gian mã đăng ký có hiệu lực, từ 1 phút đến Durations.MAX_VALUE, khoảng 10.000 năm. Nếu bạn không chỉ định, thời lượng mặc định là 1 giờ. Xin lưu ý rằng nếu thời lượng được yêu cầu khiến expirationTimestamp thu được vượt quá Timestamps.MAX_VALUE, thì expirationTimestamp sẽ bị ép thành Timestamps.MAX_VALUE.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

expirationTimestamp

string (Timestamp format)

Thời gian hết hạn của mã thông báo. Đây là trường chỉ có thể đọc do máy chủ tạo.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

policyName

string

Tên của chính sách ban đầu được áp dụng cho thiết bị đã đăng ký, ở dạng enterprises/{enterpriseId}/policies/{policyId}. Nếu không chỉ định, hệ thống sẽ áp dụng policyName cho người dùng thiết bị. Nếu bạn cũng không chỉ định userName, thì enterprises/{enterpriseId}/policies/default sẽ được áp dụng theo mặc định. Khi cập nhật trường này, bạn chỉ có thể chỉ định policyId miễn là policyId không chứa dấu gạch chéo. Phần còn lại của tên chính sách sẽ được suy luận.

additionalData

string

Dữ liệu tuỳ ý, không bắt buộc được liên kết với mã thông báo đăng ký. Ví dụ: mã này có thể chứa mã nhận dạng của một đơn vị tổ chức mà thiết bị được chỉ định sau khi đăng ký. Sau khi thiết bị đăng ký bằng mã thông báo, dữ liệu này sẽ xuất hiện trong trường enrollmentTokenData của tài nguyên Device. Dữ liệu phải có độ dài từ 1024 ký tự trở xuống; nếu không, yêu cầu tạo sẽ không thành công.

qrCode

string

Chuỗi JSON có thể dùng bản trình bày UTF-8 để tạo mã QR nhằm đăng ký thiết bị bằng mã thông báo đăng ký này. Để đăng ký thiết bị bằng NFC, bản ghi NFC phải chứa java.util.Properties tuần tự đại diện cho các thuộc tính trong JSON.

oneTimeOnly

boolean

Liệu mã thông báo đăng ký có chỉ dùng được một lần hay không. Nếu cờ được đặt thành true, thì chỉ một thiết bị mới có thể sử dụng cờ đó để đăng ký.

user
(deprecated)

object (User)

Trường này không còn được dùng nữa và giá trị sẽ bị bỏ qua.

allowPersonalUsage

enum (AllowPersonalUsage)

Kiểm soát việc có cho phép sử dụng cá nhân trên thiết bị được cấp mã thông báo đăng ký này hay không.

Đối với thiết bị do công ty sở hữu:

  • Khi bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Để tắt chế độ sử dụng cá nhân, người dùng phải thiết lập thiết bị dưới dạng thiết bị được quản lý toàn bộ.

Đối với thiết bị thuộc sở hữu cá nhân:

  • Khi bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Việc tắt chế độ sử dụng cá nhân sẽ ngăn thiết bị cấp phép. Không thể tắt chế độ sử dụng cá nhân trên thiết bị thuộc sở hữu cá nhân.

Phương thức

create

Tạo mã đăng ký cho một doanh nghiệp cụ thể.

delete

Xoá mã thông báo đăng ký.

get

Nhận mã thông báo đăng ký đang hoạt động và chưa hết hạn.

list

Liệt kê các mã thông báo đăng ký đang hoạt động và chưa hết hạn cho một doanh nghiệp nhất định.