Method: vdc.proofUser

נקודת קצה לאימות משתמש לקבלת אישור דיגיטלי, באמצעות רשימה של הוכחות שצוינו על ידי המנפיק, ולמכשיר ספציפי.

בקשת HTTP

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "requestMetadata": {
    object (RequestMetadata)
  },
  "deviceReferenceId": string,
  "proofingId": string,
  "evidence": [
    {
      object (ProofingEvidence)
    }
  ],

  // Union field proofing_context can be only one of the following:
  "reverificationContext": {
    object (ReverificationContext)
  }
  // End of list of possible types for union field proofing_context.
}
שדות
requestMetadata

object (RequestMetadata)

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

string

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

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

string

מזהה אטום שמייצג הוכחה עם חבילה ספציפית של ראיות, למכשיר ספציפי.

לדוגמה: מזהה ייחודי אוניברסלי (UUID)
evidence[]

object (ProofingEvidence)

רשימת ההוכחות שנדרשות כדי לאמת משתמש לצורך קבלת פרטי כניסה דיגיטליים.
שדה איחוד proofing_context. ההקשר של ההגהה. השדה הזה ריק בשלב ההגהה הראשונית. הערך proofing_context יכול להיות רק אחד מהבאים:
reverificationContext

object (ReverificationContext)

ההקשר של ההגהה לאימות מחדש.

גוף התשובה

אישור לבקשה לאימות משתמש לצורך הנפקת תעודה דיגיטלית, שמעיד שהאימות נמצא כעת בתהליך.

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

ייצוג ב-JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
שדות
responseMetadata

object (ResponseMetadata)

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

string

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

ProofingEvidence

אובייקט שמייצג פריט יחיד של ראיות.

ייצוג ב-JSON 
{

  // Union field evidence_type can be only one of the following:
  "preAuthorizationCode": {
    object (Evidence)
  }
  // End of list of possible types for union field evidence_type.
}
שדות
שדה איחוד evidence_type. רכיב oneof שמציין איך ההוכחה מוצגת. הערך evidence_type יכול להיות רק אחד מהבאים:
preAuthorizationCode

object (Evidence)

קוד הרשאה מראש שנשלח מהמנפיק.

הוכחות

אובייקט שמייצג פריט יחיד של ראיות.

ייצוג ב-JSON 
{

  // Union field presencetype can be only one of the following:
  "encryptedData": {
    object (EncryptedData)
  },
  "unencryptedValue": string,
  "unencryptedInteger": integer
  // End of list of possible types for union field presencetype.
}
שדות
שדה איחוד presencetype. רכיב oneof שמציין איך ההוכחה מוצגת. הערך presencetype יכול להיות רק אחד מהבאים:
encryptedData

object (EncryptedData)

הערך המוצפן ומטא-נתוני ההצפנה שנדרשים כדי לפענח את הערך.
unencryptedValue

string

הערך של הראיה בקידוד Base64.
unencryptedInteger

integer

ערך המספר השלם של הראיה.

ReverificationContext

ההקשר שנדרש כדי להפעיל אימות מחדש של פרטי הכניסה.

ייצוג ב-JSON 
{
  "credentialId": string
}
שדות
credentialId

string

מזהה האישורים שעליהם מתבצע האימות מחדש.