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

প্রয়োজনীয়। একটি নির্দিষ্ট ডিভাইসের জন্য, প্রমাণের একটি নির্দিষ্ট বান্ডিল সহ একটি প্রুফিং-এর প্রতিনিধিত্বকারী অস্বচ্ছ শনাক্তকারী। এটি সেই একই প্রুফ আইডি যা অনুরোধের সাথে পাঠানো হয়েছিল।

প্রমাণের প্রমাণ

এমন একটি বস্তু যা প্রমাণের একটিমাত্র অংশকে উপস্থাপন করে।

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 । আবশ্যক। এটি এমন একটি বিকল্প যা নির্দেশ করে প্রমাণটি কীভাবে উপস্থাপন করা হচ্ছে। presencetype নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
encryptedData

object ( EncryptedData )

এনক্রিপ্ট করা মান এবং মানটি ডিক্রিপ্ট করার জন্য প্রয়োজনীয় এনক্রিপশন মেটাডেটা।

unencryptedValue

string

প্রমাণের বেস৬৪ এনকোডেড মান।

unencryptedInteger

integer

প্রমাণের পূর্ণসংখ্যা মান।

পুনঃযাচাই প্রসঙ্গ

ক্রেডেনশিয়ালটির পুনঃযাচাইকরণ শুরু করার জন্য প্রয়োজনীয় প্রেক্ষাপট।

JSON উপস্থাপনা 
{
  "credentialId": string
}
ক্ষেত্র
credentialId

string

আবশ্যক। যে ক্রেডেনশিয়াল আইডিটির উপর পুনঃযাচাই করা হয়।