chrome.webAuthenticationProxy

বর্ণনা

chrome.webAuthenticationProxy API দূরবর্তী ডেস্কটপ সফ্টওয়্যারকে একটি দূরবর্তী হোস্ট ইন্টারসেপ্ট ওয়েব প্রমাণীকরণ API (WebAuthn) অনুরোধগুলিকে স্থানীয় ক্লায়েন্টে পরিচালনা করতে দেয়।

অনুমতি

webAuthenticationProxy

প্রাপ্যতা

Chrome 115+ MV3+

প্রকারভেদ

CreateRequest

বৈশিষ্ট্য

  • অনুরোধের বিবরণ Json

    স্ট্রিং

    PublicKeyCredentialCreationOptions navigator.credentials.create() এ পাস করা হয়েছে, একটি JSON স্ট্রিং হিসাবে ক্রমিক। সিরিয়ালাইজেশন ফরম্যাট PublicKeyCredential.parseCreationOptionsFromJSON() এর সাথে সামঞ্জস্যপূর্ণ।

  • অনুরোধ আইডি

    সংখ্যা

    অনুরোধের জন্য একটি অস্বচ্ছ শনাক্তকারী।

CreateResponseDetails

বৈশিষ্ট্য

  • ত্রুটি

    DOMexception Details ঐচ্ছিক

    DOMException দূরবর্তী অনুরোধ দ্বারা পাওয়া যায়, যদি থাকে।

  • অনুরোধ আইডি

    সংখ্যা

    CreateRequest এর requestId ।

  • প্রতিক্রিয়া Json

    স্ট্রিং ঐচ্ছিক

    PublicKeyCredential , দূরবর্তী অনুরোধ দ্বারা পাওয়া, যদি থাকে, একটি JSON স্ট্রিং হিসাবে ক্রমিক করা হয় href="https://w3c.github.io/webauthn/#dom-publickeycredential-tojson"> PublicKeyCredential.toJSON() ।

DOMExceptionDetails

বৈশিষ্ট্য

  • বার্তা

    স্ট্রিং

  • নাম

    স্ট্রিং

GetRequest

বৈশিষ্ট্য

  • অনুরোধের বিবরণ Json

    স্ট্রিং

    PublicKeyCredentialRequestOptions navigator.credentials.get() এ পাস করা হয়েছে, একটি JSON স্ট্রিং হিসাবে সিরিয়াল করা হয়েছে। সিরিয়ালাইজেশন বিন্যাস PublicKeyCredential.parseRequestOptionsFromJSON() এর সাথে সামঞ্জস্যপূর্ণ।

  • অনুরোধ আইডি

    সংখ্যা

    অনুরোধের জন্য একটি অস্বচ্ছ শনাক্তকারী।

GetResponseDetails

বৈশিষ্ট্য

  • ত্রুটি

    DOMexception Details ঐচ্ছিক

    DOMException দূরবর্তী অনুরোধ দ্বারা পাওয়া যায়, যদি থাকে।

  • অনুরোধ আইডি

    সংখ্যা

    CreateRequest এর requestId ।

  • প্রতিক্রিয়া Json

    স্ট্রিং ঐচ্ছিক

    PublicKeyCredential , দূরবর্তী অনুরোধ দ্বারা পাওয়া, যদি থাকে, একটি JSON স্ট্রিং হিসাবে ক্রমিক করা হয় href="https://w3c.github.io/webauthn/#dom-publickeycredential-tojson"> PublicKeyCredential.toJSON() ।

IsUvpaaRequest

বৈশিষ্ট্য

  • অনুরোধ আইডি

    সংখ্যা

    অনুরোধের জন্য একটি অস্বচ্ছ শনাক্তকারী।

IsUvpaaResponseDetails

বৈশিষ্ট্য

  • isUvpaa

    বুলিয়ান

  • অনুরোধ আইডি

    সংখ্যা

পদ্ধতি

attach()

প্রতিশ্রুতি
chrome.webAuthenticationProxy.attach(
  callback?: function,
)

এই এক্সটেনশনটিকে সক্রিয় ওয়েব প্রমাণীকরণ API অনুরোধ প্রক্সি করে তোলে।

দূরবর্তী ডেস্কটপ এক্সটেনশনগুলি সাধারণত এই হোস্টে একটি দূরবর্তী সেশনের সংযুক্তি সনাক্ত করার পরে এই পদ্ধতিটিকে কল করে। একবার এই পদ্ধতিটি ত্রুটি ছাড়াই ফিরে আসে, WebAuthn অনুরোধগুলির নিয়মিত প্রক্রিয়াকরণ স্থগিত করা হয় এবং এই এক্সটেনশন API থেকে ইভেন্টগুলি উত্থাপিত হয়।

একটি ভিন্ন এক্সটেনশন ইতিমধ্যে সংযুক্ত থাকলে এই পদ্ধতিটি একটি ত্রুটির সাথে ব্যর্থ হয়৷

নিয়মিত WebAuthn অনুরোধ প্রক্রিয়াকরণ পুনরায় শুরু করার জন্য রিমোট ডেস্কটপ সেশন শেষ হয়ে গেলে সংযুক্ত এক্সটেনশনটিকে অবশ্যই detach() কল করতে হবে। এক্সটেনশনগুলি আনলোড করা হলে স্বয়ংক্রিয়ভাবে বিচ্ছিন্ন হয়ে যায়৷

একটি নেটিভ অ্যাপ্লিকেশন থেকে (সম্ভবত স্থগিত) এক্সটেনশনে দূরবর্তী সেশন সংযুক্তির পরিবর্তনের সংকেত দেওয়ার জন্য onRemoteSessionStateChange ইভেন্টটি পড়ুন।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (error?: string) => void

    • ত্রুটি

      স্ট্রিং ঐচ্ছিক

রিটার্নস

  • প্রতিশ্রুতি<স্ট্রিং | undefined>

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

completeCreateRequest()

প্রতিশ্রুতি
chrome.webAuthenticationProxy.completeCreateRequest(
  details: CreateResponseDetails,
  callback?: function,
)

একটি navigator.credentials.create() কলের ফলাফল রিপোর্ট করে। এক্সটেনশনটিকে অবশ্যই এটি প্রাপ্ত প্রতিটি onCreateRequest ইভেন্টের জন্য কল করতে হবে, যদি না অনুরোধটি বাতিল করা হয় (যে ক্ষেত্রে, একটি onRequestCanceled ইভেন্ট বহিস্কার করা হয়)।

পরামিতি

রিটার্নস

  • প্রতিশ্রুতি <void>

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

completeGetRequest()

প্রতিশ্রুতি
chrome.webAuthenticationProxy.completeGetRequest(
  details: GetResponseDetails,
  callback?: function,
)

একটি navigator.credentials.get() কলের ফলাফল রিপোর্ট করে। এক্সটেনশনটিকে এটি প্রাপ্ত প্রতিটি onGetRequest ইভেন্টের জন্য কল করতে হবে, যদি না অনুরোধটি বাতিল করা হয় (যে ক্ষেত্রে, একটি onRequestCanceled ইভেন্ট বহিস্কার করা হয়)।

পরামিতি

রিটার্নস

  • প্রতিশ্রুতি <void>

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

completeIsUvpaaRequest()

প্রতিশ্রুতি
chrome.webAuthenticationProxy.completeIsUvpaaRequest(
  details: IsUvpaaResponseDetails,
  callback?: function,
)

একটি PublicKeyCredential.isUserVerifyingPlatformAuthenticator() কলের ফলাফল রিপোর্ট করে৷ এক্সটেনশনটিকে এটি প্রাপ্ত প্রতিটি onIsUvpaaRequest ইভেন্টের জন্য কল করতে হবে।

পরামিতি

রিটার্নস

  • প্রতিশ্রুতি <void>

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

detach()

প্রতিশ্রুতি
chrome.webAuthenticationProxy.detach(
  callback?: function,
)

এই এক্সটেনশনটিকে সক্রিয় ওয়েব প্রমাণীকরণ API অনুরোধ প্রক্সি থেকে সরিয়ে দেয়।

এই পদ্ধতিটি সাধারণত বলা হয় যখন এক্সটেনশন সনাক্ত করে যে একটি দূরবর্তী ডেস্কটপ সেশন বন্ধ করা হয়েছে। এই পদ্ধতিটি ফিরে আসার পরে, এক্সটেনশনটি সক্রিয় ওয়েব প্রমাণীকরণ API অনুরোধ প্রক্সি হিসাবে বন্ধ হয়ে যায়।

একটি নেটিভ অ্যাপ্লিকেশন থেকে (সম্ভবত স্থগিত) এক্সটেনশনে দূরবর্তী সেশন সংযুক্তির পরিবর্তনের সংকেত দেওয়ার জন্য onRemoteSessionStateChange ইভেন্টটি পড়ুন।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (error?: string) => void

    • ত্রুটি

      স্ট্রিং ঐচ্ছিক

রিটার্নস

  • প্রতিশ্রুতি<স্ট্রিং | undefined>

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

ঘটনা

onCreateRequest

chrome.webAuthenticationProxy.onCreateRequest.addListener(
  callback: function,
)

একটি WebAuthn navigator.credentials.create() কল হলে আগুন লাগে। এক্সটেনশনটি অবশ্যই requestInfo থেকে requestId সহ completeCreateRequest() কল করে একটি প্রতিক্রিয়া সরবরাহ করবে।

পরামিতি

onGetRequest

chrome.webAuthenticationProxy.onGetRequest.addListener(
  callback: function,
)

একটি WebAuthn navigator.credentials.get() কল হলে আগুন লাগে। এক্সটেনশনটি অবশ্যই requestInfo থেকে requestId সহ completeGetRequest() কল করে একটি প্রতিক্রিয়া সরবরাহ করবে

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (requestInfo: GetRequest) => void

onIsUvpaaRequest

chrome.webAuthenticationProxy.onIsUvpaaRequest.addListener(
  callback: function,
)

একটি PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() কল হলে আগুন লাগে। এক্সটেনশনকে অবশ্যই requestInfo থেকে requestId সহ completeIsUvpaaRequest() কল করে একটি প্রতিক্রিয়া সরবরাহ করতে হবে

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (requestInfo: IsUvpaaRequest) => void

onRemoteSessionStateChange

chrome.webAuthenticationProxy.onRemoteSessionStateChange.addListener(
  callback: function,
)

এই এক্সটেনশনের সাথে যুক্ত একটি নেটিভ অ্যাপ্লিকেশান ডিফল্ট ব্যবহারকারী ডেটা ডিরেক্টরির ভিতরে WebAuthenticationProxyRemoteSessionStateChange নামের একটি ডিরেক্টরিতে এক্সটেনশনের আইডির সমান নামের একটি ফাইলে লিখে এই ইভেন্টটিকে বহিস্কার করতে পারে৷

ফাইলের বিষয়বস্তু খালি হওয়া উচিত। অর্থাৎ, এই ইভেন্টটি ট্রিগার করার জন্য ফাইলের বিষয়বস্তু পরিবর্তন করার প্রয়োজন নেই।

নেটিভ হোস্ট অ্যাপ্লিকেশন এই ইভেন্ট মেকানিজম ব্যবহার করে একটি সম্ভাব্য দূরবর্তী সেশনের অবস্থার পরিবর্তনের সংকেত দিতে পারে (অর্থাৎ বিচ্ছিন্ন থেকে সংযুক্ত, বা বিপরীতে) যখন এক্সটেনশন পরিষেবা কর্মীকে স্থগিত করা হয়। এই ইভেন্টের জন্য হ্যান্ডলারে, এক্সটেনশনটি সেই অনুযায়ী attach() বা detach() API পদ্ধতিতে কল করতে পারে।

ইভেন্ট শ্রোতা লোড সময়ে সিঙ্ক্রোনাস নিবন্ধিত করা আবশ্যক.

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    () => void

onRequestCanceled

chrome.webAuthenticationProxy.onRequestCanceled.addListener(
  callback: function,
)

একটি onCreateRequest বা onGetRequest ইভেন্ট বাতিল হলে ফায়ার হয় (কারণ WebAuthn অনুরোধটি কলার দ্বারা বাতিল করা হয়েছিল, বা এটির সময় শেষ হয়ে গেছে)। এই ইভেন্টটি গ্রহণ করার সময়, এক্সটেনশনটি ক্লায়েন্টের পক্ষ থেকে সংশ্লিষ্ট অনুরোধের প্রক্রিয়াকরণ বাতিল করা উচিত। একবার এটি বাতিল হয়ে গেলে এক্সটেনশনগুলি একটি অনুরোধ সম্পূর্ণ করতে পারে না৷

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (requestId: number) => void

    • অনুরোধ আইডি

      সংখ্যা