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)

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

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ó hai 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 hai 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 để tương quan 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, chỉ có mộ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

Danh sách chứng chỉ X.509 trong chuỗi chứng chỉ, là danh sách duy nhấ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

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)

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