Method: vdc.registerDevice

נקודת קצה לרישום מכשיר אצל המנפיק.

בקשת HTTP

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "deviceIdentityCertificate": string,
  "deviceIdentityCertificateChain": [
    string
  ]
}
שדות
requestMetadata

object (RequestMetadata)

חובה. המטא-נתונים לגבי הבקשה, שנדרשים בכל הבקשות.

deviceReferenceId

string

חובה. המזהה שמתאים למכשיר ולמפתח הזהות שמשויך למכשיר. זה לא מזהה מכשיר, כלומר אם למשתמש יש שני פרטי כניסה נפרדים באותו מכשיר, המזהה הזה יהיה שונה בשני המקרים.

המזהה הזה מסופק בכל הבקשות, ואפשר להשתמש בו כדי ליצור קורלציה בין הבקשות.

deviceIdentityCertificate

string

‫(DEPRECATED: use deviceIdentityCertificateChain ) שרשרת אישורי X.509, שהיא ייחודית למכשיר ספציפי ולאמצעי אימות.

האישור הזה מכיל את מפתח הזהות של המכשיר, אימות מכשיר וערך חד-פעמי חתום.

deviceIdentityCertificateChain[]

string

חובה. רשימה של אישורי X.509 בשרשרת האישורים, שהיא ייחודית למכשיר ולאמצעי אימות ספציפיים.

שרשרת האישורים הזו מכילה את מפתח הזהות של המכשיר, אימות המכשיר וערך ה-nonce החתום.

גוף התשובה

תשובה שמאשרת את רישום המכשיר.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{
  "responseMetadata": {
    object (ResponseMetadata)
  }
}
שדות
responseMetadata

object (ResponseMetadata)

חובה. המטא-נתונים לגבי התגובה, שנדרשים בכל התגובות.