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

الزامی. یک شناسه‌ی مبهم که نشان‌دهنده‌ی اثبات با مجموعه‌ای خاص از شواهد، برای یک دستگاه خاص است.

مثال: شناسه کاربری

evidence[]

object ( ProofingEvidence )

الزامی. فهرست مدارک مورد نیاز برای اثبات کاربر برای دریافت اعتبارنامه دیجیتال.

فیلد union proofing_context . زمینه برای اثبات. برای اثبات اولیه خالی است. proofing_context فقط می‌تواند یکی از موارد زیر باشد:
reverificationContext

object ( ReverificationContext )

زمینه برای اثبات تأیید مجدد.

بدنه پاسخ

تأییدیه درخواست برای تأیید اعتبار دیجیتال کاربر، که نشان می‌دهد تأیید اعتبار اکنون در حال انجام است.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "responseMetadata": {
    object (ResponseMetadata)
  },
  "proofingId": string
}
فیلدها
responseMetadata

object ( ResponseMetadata )

الزامی. فراداده مربوط به پاسخ، که در همه پاسخ‌ها الزامی است.

proofingId

string

الزامی. شناسه‌ی مبهمی که نشان‌دهنده‌ی یک اثبات با مجموعه‌ای خاص از شواهد، برای یک دستگاه خاص است. این همان شناسه‌ی اثباتی است که در درخواست ارسال شده است.

اثبات شواهد

شیئی که نمایانگر یک مدرک واحد است.

نمایش 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 . الزامی. یکی از مواردی که نحوه ارائه شواهد را نشان می‌دهد. 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.
}
فیلدها
فیلد Union presencetype . الزامی. یکی از مواردی که نحوه ارائه شواهد را نشان می‌دهد. presencetype فقط می‌تواند یکی از موارد زیر باشد:
encryptedData

object ( EncryptedData )

مقدار رمزگذاری شده و فراداده رمزگذاری لازم برای رمزگشایی مقدار.

unencryptedValue

string

مقدار کدگذاری شده‌ی base64 شواهد.

unencryptedInteger

integer

مقدار صحیح شواهد.

تأیید مجددزمینه

زمینه مورد نیاز برای شروع تأیید مجدد اعتبارنامه.

نمایش JSON 
{
  "credentialId": string
}
فیلدها
credentialId

string

الزامی. شناسه‌ی اعتباری که تأیید مجدد روی آن انجام می‌شود.