Method: vdc.registerDevice

Một điểm cuối để đăng ký thiết bị với tổ chức phát hành.

Yêu cầu HTTP

POST https://example.issuer.com/api/v1/vdc/registerDevice

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "deviceIdentityCertificate": string,
  "deviceIdentityCertificateChain": [
    string
  ]
}
Trường
requestMetadata

object (RequestMetadata)

Bắt buộc. Siêu dữ liệu về yêu cầu, bắt buộc trong tất cả các yêu cầu.
deviceReferenceId

string

Bắt buộc. Mã nhận dạng tương ứng với thiết bị và khoá nhận dạng được liên kết với thiết bị. Đây KHÔNG phải là mã nhận dạng thiết bị, tức là nếu người dùng có 2 thông tin đăng nhập riêng biệt trên cùng một thiết bị, thì mã nhận dạng này sẽ khác nhau giữa 2 thông tin đăng nhập đó.

Mã nhận dạng này được cung cấp trong tất cả các yêu cầu và có thể dùng để liên kết các yêu cầu.
deviceIdentityCertificate

string

(KHÔNG DÙNG NỮA: hãy dùng deviceIdentityCertificateChain) Một chuỗi chứng chỉ X.509, riêng biệt cho một thiết bị và thông tin đăng nhập cụ thể.

Chứng chỉ này chứa khoá nhận dạng của thiết bị, một chứng thực thiết bị và số chỉ dùng một lần đã ký.
deviceIdentityCertificateChain[]

string

Bắt buộc. Danh sách chứng chỉ X.509 trong chuỗi chứng chỉ, riêng biệt cho một thiết bị và thông tin đăng nhập cụ thể.

Chuỗi chứng chỉ này chứa khoá nhận dạng của thiết bị, một chứng thực thiết bị và số chỉ dùng một lần đã ký.

Nội dung phản hồi

Một phản hồi xác nhận việc đăng ký thiết bị.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
Trường
responseMetadata

object (ResponseMetadata)

Bắt buộc. Siêu dữ liệu về phản hồi, bắt buộc trong tất cả các phản hồi.