נקודת קצה לרישום מכשיר אצל המנפיק.
בקשת HTTP
POST https://example.issuer.com/api/v1/vdc/registerDevice
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג JSON |
|---|
{
"requestMetadata": {
object ( |
| שדות | |
|---|---|
requestMetadata |
חובה. המטא-נתונים לגבי הבקשה, שנדרשים בכל הבקשות. |
deviceReferenceId |
חובה. המזהה שמתאים למכשיר ולמפתח הזהות שמשויך למכשיר. זה לא מזהה מכשיר, כלומר אם למשתמש יש שני פרטי כניסה נפרדים באותו מכשיר, המזהה הזה יהיה שונה בשני המקרים. המזהה הזה מסופק בכל הבקשות, ואפשר להשתמש בו כדי ליצור קורלציה בין הבקשות. |
deviceIdentityCertificate |
(DEPRECATED: use deviceIdentityCertificateChain ) שרשרת אישורי X.509, שהיא ייחודית למכשיר ספציפי ולאמצעי אימות. האישור הזה מכיל את מפתח הזהות של המכשיר, אימות מכשיר וערך חד-פעמי חתום. |
deviceIdentityCertificateChain[] |
חובה. רשימה של אישורי X.509 בשרשרת האישורים, שהיא ייחודית למכשיר ולאמצעי אימות ספציפיים. שרשרת האישורים הזו מכילה את מפתח הזהות של המכשיר, אימות המכשיר וערך ה-nonce החתום. |
גוף התשובה
תשובה שמאשרת את רישום המכשיר.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
|---|
{
"responseMetadata": {
object ( |
| שדות | |
|---|---|
responseMetadata |
חובה. המטא-נתונים לגבי התגובה, שנדרשים בכל התגובות. |