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.
}
فیلدها
فیلد union 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

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