এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

FedCM এর সাথে একটি পরিচয় সমাধান প্রয়োগ করুন

FedCM (ফেডারেটেড ক্রেডেনশিয়াল ম্যানেজমেন্ট) হল ফেডারেটেড পরিচয় পরিষেবাগুলির (যেমন "সাইন ইন...") একটি গোপনীয়তা-সংরক্ষণ পদ্ধতি যা ব্যবহারকারীদের পরিচয় পরিষেবা বা সাইটের সাথে তাদের ব্যক্তিগত তথ্য ভাগ না করেই সাইটে লগ ইন করতে দেয়৷

FedCM বাস্তবায়নে IdP (আইডেন্টিটি প্রোভাইডার) এবং RP (নির্ভর পার্টি) উভয়ের জন্য বেশ কয়েকটি মূল পদক্ষেপ অন্তর্ভুক্ত রয়েছে।

FedCM বাস্তবায়নের জন্য IdPsকে অবশ্যই নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করতে হবে:

একটি সুপরিচিত ফাইল তৈরি করুন।
একটি কনফিগারেশন ফাইল তৈরি করুন।
নিম্নলিখিত শেষ পয়েন্ট তৈরি করুন:
ব্যবহারকারীর লগইন অবস্থা সম্পর্কে ব্রাউজারকে অবহিত করুন।

RPsকে তাদের সাইটে FedCM সক্ষম করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করতে হবে:

নিশ্চিত করুন যে FedCM এন্ডপয়েন্ট RP-এর সাইটে অনুমোদিত ।
ব্যবহারকারীর প্রমাণীকরণ শুরু করতে FedCM JavaScript API ব্যবহার করুন।
আইডিপিতে তাদের মেটাডেটা (যেমন গোপনীয়তা নীতি এবং পরিষেবার শর্তাবলী) প্রদান করুন
[ঐচ্ছিক] একটি UX মোড বেছে নিয়ে, লগইন বা ডোমেন ইঙ্গিত প্রদান করে, কাস্টম প্যারামিটার পাস করে, নির্দিষ্ট ব্যবহারকারীর তথ্যের অনুরোধ করে, একটি কাস্টম ত্রুটি বার্তা প্রদান করে, বা ব্যবহারকারীদের পুনরায় প্রমাণীকরণ করার পদ্ধতি বেছে নিয়ে ব্যবহারকারীর অভিজ্ঞতা কাস্টমাইজ করুন।

দ্রষ্টব্য: এপিআই পরিপক্ক হওয়ার সময় FedCM জাভাস্ক্রিপ্ট এপিআই অ্যাক্সেস করতে এবং স্ব-হোস্টিং SDK থেকে RP-কে নিরুৎসাহিত করতে আমরা IdP-কে লাইব্রেরি প্রদান করতে উৎসাহিত করি। এটি নিশ্চিত করবে যে আইডিপিগুলি API বিকশিত হওয়ার সাথে সাথে তাদের সমস্ত নির্ভরশীল পক্ষকে পুনরায় কাজে লাগানোর জন্য জিজ্ঞাসা না করেই পরিবর্তন করতে পারে।

একটি আইডিপি হিসাবে FedCM প্রয়োগ করুন

IdP এর দিকে FedCM বাস্তবায়নের পদক্ষেপ সম্পর্কে আরও জানুন।

একটি সুপরিচিত ফাইল তৈরি করুন

ট্র্যাকারদের API-এর অপব্যবহার থেকে রোধ করতে, IdP-এর eTLD+1 এর /.well-known/web-identity থেকে একটি সুপরিচিত ফাইল পরিবেশন করতে হবে।

সুপরিচিত ফাইলে নিম্নলিখিত বৈশিষ্ট্যগুলি অন্তর্ভুক্ত থাকতে পারে:

সম্পত্তি	প্রয়োজন	বর্ণনা
`provider_urls`	প্রয়োজনীয়	আইডিপি কনফিগারেশন ফাইল পাথের অ্যারে। যদি `accounts_endpoint` এবং `login_url` নির্দিষ্ট করা থাকে তাহলে উপেক্ষা করা হয়েছে (কিন্তু এখনও প্রয়োজন)।
`accounts_endpoint`	প্রস্তাবিত, `login_url` প্রয়োজন	অ্যাকাউন্টের শেষ পয়েন্টের URL। এটি একাধিক কনফিগারেশন সমর্থনের জন্য অনুমতি দেয়, যতক্ষণ না প্রতিটি কনফিগারেশন ফাইল একই `login_url` এবং `accounts_endpoint` URL ব্যবহার করে। দ্রষ্টব্য: প্যারামিটারটি Chrome 132 থেকে সমর্থিত।
`login_url`	প্রস্তাবিত, `accounts_endpoint` প্রয়োজন	আইডিপিতে সাইন ইন করার জন্য ব্যবহারকারীর লগইন পৃষ্ঠার URL । এটি একাধিক কনফিগারেশন সমর্থনের জন্য অনুমতি দেয়, যতক্ষণ পর্যন্ত প্রতিটি কনফিগারেশন ফাইল একই `login_url` এবং `accounts_endpoint` ব্যবহার করে। দ্রষ্টব্য: পরামিতিটি Chrome 132 এবং পরবর্তীতে সমর্থিত।

উদাহরণ স্বরূপ, যদি IdP এন্ডপয়েন্টগুলি https://accounts.idp.example/ অধীনে পরিবেশিত হয়, তাহলে তাদের অবশ্যই https://idp.example/.well-known/web-identity এ একটি সুপরিচিত ফাইল পরিবেশন করতে হবে আইডিপি কনফিগারেশন ফাইল । এখানে একটি সুপরিচিত ফাইল সামগ্রীর উদাহরণ রয়েছে:

  {
    "provider_urls": ["https://accounts.idp.example/config.json"]
  }

IdPs সুপরিচিত ফাইলে accounts_endpoint এবং login_url উল্লেখ করে একটি IdP-এর জন্য একাধিক কনফিগারেশন ফাইল মিটমাট করতে পারে।
এই বৈশিষ্ট্যটি এই ক্ষেত্রে দরকারী হতে পারে:

একটি আইডিপিকে একাধিক ভিন্ন পরীক্ষা এবং উৎপাদন কনফিগারেশন সমর্থন করতে হবে।
একটি আইডিপিকে অঞ্চল প্রতি বিভিন্ন কনফিগারেশন সমর্থন করতে হবে (উদাহরণস্বরূপ, eu-idp.example এবং us-idp.example )।

একাধিক কনফিগারেশন সমর্থন করতে (উদাহরণস্বরূপ, পরীক্ষা এবং উত্পাদন পরিবেশের মধ্যে পার্থক্য করতে), IdP-কে অবশ্যই accounts_endpoint এবং login_url নির্দিষ্ট করতে হবে:

  {
    // This property is required, but will be ignored when IdP supports
    // multiple configs (when `accounts_endpoint` and `login_url` are
    // specified), as long as `accounts_endpoint` and `login_url` in
    // that config file match those in the well-known file.
    "provider_urls": [ "https://idp.example/fedcm.json" ],

    // Specify accounts_endpoint and login_url properties to support
    // multiple config files.
    // Note: The accounts_endpoint and login_url must be identical
    // across all config files. Otherwise,
    // the configurations won't be supported.
    "accounts_endpoint": "https://idp.example/accounts",
    "login_url": "https://idp.example/login"
  }

টিপ: FedCM ব্যবহার করার সময়, RP সার্ভার ডোমেন পরীক্ষা করা বা স্টেজ করা উৎপাদন আইডিপি সার্ভারের সাবডোমেন হতে পারে। উদাহরণস্বরূপ, প্রোডাকশন আইডিপি সার্ভারটি idp.example এ রয়েছে এবং স্টেজিং RP সার্ভার এবং স্টেজিং IdP সার্ভার উভয়ই staging.idp.example এ রয়েছে। যাইহোক, যেহেতু সুপরিচিত ফাইলটি অবশ্যই আইডিপি সার্ভারের eTLD+1 এর মূলে থাকতে হবে, তাই এটি idp.example/.well-known/web-identity এ থাকতে হবে এবং এটি উৎপাদন সার্ভার। যেহেতু ডেভেলপারদের পক্ষে ডেভেলপমেন্টের সময় প্রোডাকশন এনভায়রনমেন্টে ফাইল স্থাপন করা অগত্যা সম্ভব নয়, তাই এটি তাদের FedCM পরীক্ষা করতে বাধা দেয়। যদি RP ডোমেন এবং IdP ডোমেন একই হয়, Chrome 122 থেকে শুরু করে সুপরিচিত ফাইল চেক করা এড়িয়ে যেতে পারে। এছাড়াও আপনি chrome://flags#fedcm-without-well-known-enforcement ফ্ল্যাগ সক্ষম করে configURL চেক বাইপাস করতে পারেন . যখন আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট এমন একটি DNS ব্যবহার করে যা সর্বজনীনভাবে অ্যাক্সেসযোগ্য নয় তখন এটি কার্যকর।

একটি আইডিপি কনফিগারেশন ফাইল এবং শেষ পয়েন্ট তৈরি করুন

আইডিপি কনফিগার ফাইল ব্রাউজারের জন্য প্রয়োজনীয় শেষ পয়েন্টগুলির একটি তালিকা প্রদান করে। আইডিপিগুলিকে অবশ্যই এক বা একাধিক কনফিগার ফাইল এবং প্রয়োজনীয় শেষ পয়েন্ট এবং URL গুলি হোস্ট করতে হবে৷ সমস্ত JSON প্রতিক্রিয়া অবশ্যই application/json কন্টেন্ট-টাইপের সাথে পরিবেশন করা উচিত।

কনফিগার ফাইলের URL একটি RP-এ নির্বাহিত navigator.credentials.get() কলে প্রদত্ত মান দ্বারা নির্ধারিত হয়।

  const credential = await navigator.credentials.get({
    identity: {
      context: 'signup',
      providers: [{
        configURL: 'https://accounts.idp.example/config.json',
        clientId: '********',
        nonce: '******'
      }]
    }
  });
  const { token } = credential;

ব্যবহারকারীকে সাইন ইন করতে দিতে RP কনফিগারেশন ফাইলের URL FedCM API কলে পাস করবে:

  // Executed on RP's side:
  const credential = await navigator.credentials.get({
    identity: {
      context: 'signup',
      providers: [{
        // To allow users to sign in with an IdP using FedCM, RP specifies the IdP's config file URL:
        configURL: 'https://accounts.idp.example/fedcm.json',
        clientId: '********',
  });
  const { token } = credential;

ব্রাউজার Origin হেডার বা Referer হেডার ছাড়াই একটি GET অনুরোধ সহ কনফিগার ফাইলটি আনবে। অনুরোধে কুকিজ নেই এবং পুনঃনির্দেশ অনুসরণ করে না। এটি কার্যকরভাবে আইডিপিকে কে অনুরোধ করেছে এবং কোন RP সংযোগ করার চেষ্টা করছে তা শিখতে বাধা দেয়। যেমন:

  GET /config.json HTTP/1.1
  Host: accounts.idp.example
  Accept: application/json
  Sec-Fetch-Dest: webidentity

সতর্কতা: FedCM ব্যবহার করে ব্রাউজার থেকে পাঠানো সমস্ত অনুরোধের মধ্যে CSRF আক্রমণ প্রতিরোধ করার জন্য একটি Sec-Fetch-Dest: webidentity হেডার অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত আইডিপি এন্ডপয়েন্টগুলি নিশ্চিত করতে হবে যে এই শিরোনামটি অন্তর্ভুক্ত রয়েছে:

অ্যাকাউন্টস এন্ডপয়েন্ট
আইডি দাবী শেষ পয়েন্ট
এন্ডপয়েন্ট সংযোগ বিচ্ছিন্ন করুন

IdP-কে অবশ্যই একটি কনফিগার এন্ডপয়েন্ট প্রয়োগ করতে হবে যা JSON-এর সাথে সাড়া দেয়। JSON নিম্নলিখিত বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করে:

সম্পত্তি	বর্ণনা
`accounts_endpoint` (প্রয়োজনীয়)	অ্যাকাউন্টের শেষ পয়েন্টের URL।
`accounts.include` (ঐচ্ছিক)	কাস্টম অ্যাকাউন্ট লেবেল স্ট্রিং, এই কনফিগার ফাইলটি ব্যবহার করার সময় কোন অ্যাকাউন্টগুলি ফেরত দেওয়া উচিত তা নির্ধারণ করে, উদাহরণস্বরূপ: `"accounts": {"include": "developer"}` । একটি আইডিপি নিম্নরূপ কাস্টম অ্যাকাউন্ট লেবেলিং প্রয়োগ করতে পারে: নির্দিষ্ট লেবেলের সাথে যুক্ত একটি কনফিগার ফাইল তৈরি করুন (এই `accounts.include` প্যারামিটার ব্যবহার করে)। অ্যাকাউন্টের শেষ পয়েন্টে লেবেলগুলি নির্দিষ্ট করুন৷ উদাহরণস্বরূপ, একটি আইডিপি `"https://idp.example/developer-config.json"` কনফিগার ফাইল `"accounts": {"include": "developer"}` উল্লেখ করা হয়েছে। আইডিপি অ্যাকাউন্টের শেষ পয়েন্টে `labels` প্যারামিটার ব্যবহার করে কিছু অ্যাকাউন্টকে `"developer"` লেবেল দিয়ে চিহ্নিত করে। যখন একটি RP `"https://idp.example/developer-config.json"` কনফিগারেশন ফাইলের সাথে `navigator.credentials.get()` কল করে, তখন শুধুমাত্র `"developer"` লেবেল সহ অ্যাকাউন্টগুলি ফেরত দেওয়া হবে।
`client_metadata_endpoint` (ঐচ্ছিক)	ক্লায়েন্ট মেটাডেটা এন্ডপয়েন্টের জন্য URL।
`id_assertion_endpoint` (প্রয়োজনীয়)	আইডি দাবী শেষ পয়েন্টের জন্য URL।
`disconnect` (ঐচ্ছিক)	সংযোগ বিচ্ছিন্ন করার জন্য URL।
`login_url` (প্রয়োজনীয়)	আইডিপিতে সাইন ইন করার জন্য ব্যবহারকারীর লগইন পৃষ্ঠার URL ।
`branding` (ঐচ্ছিক)	অবজেক্ট যা বিভিন্ন ব্র্যান্ডিং বিকল্প ধারণ করে।
`branding.background_color` (ঐচ্ছিক)	ব্র্যান্ডিং বিকল্প যা "এভাবে চালিয়ে যান..." বোতামের পটভূমির রঙ সেট করে। প্রাসঙ্গিক CSS সিনট্যাক্স ব্যবহার করুন, যথা `hex-color` , `hsl()` , `rgb()` , অথবা `named-color` ।
`branding.color` (ঐচ্ছিক)	ব্র্যান্ডিং বিকল্প যা "এভাবে চালিয়ে যান..." বোতামের পাঠ্যের রঙ সেট করে। প্রাসঙ্গিক CSS সিনট্যাক্স ব্যবহার করুন, যথা `hex-color` , `hsl()` , `rgb()` , অথবা `named-color` ।
`branding.icons` (ঐচ্ছিক)	আইকন অবজেক্টের অ্যারে। সাইন-ইন ডায়ালগে এই আইকনগুলি প্রদর্শিত হয়৷ আইকন বস্তুর দুটি পরামিতি আছে: `url` (প্রয়োজনীয়): আইকন ছবির URL। এটি SVG ছবি সমর্থন করে না। `size` (ঐচ্ছিক): আইকনের মাত্রা, অ্যাপ্লিকেশন দ্বারা বর্গাকার এবং একক রেজোলিউশন বলে ধরে নেওয়া হয়। এই সংখ্যাটি অবশ্যই প্যাসিভ মোডে 25px এর বেশি বা সমান এবং সক্রিয় মোডে 40px এর থেকে বেশি বা সমান হতে হবে।
`modes`	FedCM UI কিভাবে বিভিন্ন মোডে প্রদর্শিত হবে তার স্পেসিফিকেশন ধারণ করে এমন বস্তু: `active` `passive`
`modes.active`	বৈশিষ্ট্য ধারণকারী বস্তু যা একটি নির্দিষ্ট মোডে FedCM আচরণ কাস্টমাইজ করার অনুমতি দেয়। উভয় `modes.active` এবং `modes.passive` নিম্নলিখিত প্যারামিটার থাকতে পারে: `supports_use_other_account` : ব্যবহারকারী বর্তমানে যে অ্যাকাউন্টে লগ ইন করেছেন তার থেকে ভিন্ন একটি অ্যাকাউন্ট দিয়ে সাইন ইন করতে পারবে কিনা তা বুলিয়ান নির্দিষ্ট করে (যদি আইডিপি একাধিক অ্যাকাউন্ট সমর্থন করে)। দ্রষ্টব্য: অন্যান্য অ্যাকাউন্ট বৈশিষ্ট্য ব্যবহার করুন এবং সক্রিয় মোড Chrome 132 থেকে সমর্থিত।
`modes.passive`

এখানে আইডিপি থেকে একটি উদাহরণ প্রতিক্রিয়া বডি রয়েছে:

  {
    "accounts_endpoint": "/accounts.example",
    "client_metadata_endpoint": "/client_metadata.example",
    "id_assertion_endpoint": "/assertion.example",
    "disconnect_endpoint": "/disconnect.example",
    "login_url": "/login",
    // When RPs use this config file, only those accounts will be
    //returned that include `developer` label in the accounts endpoint.
    "accounts": {"include": "developer"},
    "modes": {
        "active": {
          "supports_use_other_account": true,
        }
    },
    "branding": {
      "background_color": "green",
      "color": "#FFEEAA",
      "icons": [{
        "url": "https://idp.example/icon.ico",
        "size": 25
      }]
    }
  }

ব্রাউজার একবার কনফিগার ফাইলটি আনলে, এটি পরবর্তী অনুরোধগুলি আইডিপি এন্ডপয়েন্টগুলিতে পাঠায়:

অন্য অ্যাকাউন্ট ব্যবহার করুন

ব্যবহারকারীরা একটি অ্যাকাউন্টে স্যুইচ করতে পারেন যা তারা বর্তমানে যে অ্যাকাউন্টে লগ ইন করেছেন তার থেকে আলাদা, যদি আইডিপি একাধিক অ্যাকাউন্ট সমর্থন করে বা বিদ্যমান অ্যাকাউন্ট প্রতিস্থাপন করে।

ব্যবহারকারীকে অন্য অ্যাকাউন্ট বেছে নিতে সক্ষম করতে, আইডিপিকে অবশ্যই কনফিগার ফাইলে এই বৈশিষ্ট্যটি উল্লেখ করতে হবে:

  {
    "accounts_endpoint" : "/accounts.example",
    "modes": {
      "active": {
        // Allow the user to choose other account (false by default)
        "supports_use_other_account": true
      }
      // "passive" mode can be configured separately
    }
  }

অ্যাকাউন্টস এন্ডপয়েন্ট

IdP-এর অ্যাকাউন্টের এন্ডপয়েন্ট অ্যাকাউন্টগুলির একটি তালিকা প্রদান করে যেগুলি ব্যবহারকারী IdP-এ সাইন ইন করেছেন। যদি আইডিপি একাধিক অ্যাকাউন্ট সমর্থন করে, তাহলে এই শেষ পয়েন্টটি সমস্ত সাইন ইন করা অ্যাকাউন্ট ফিরিয়ে দেবে।

ব্রাউজার SameSite=None সহ কুকি সহ একটি GET অনুরোধ পাঠায়, কিন্তু একটি client_id প্যারামিটার, Origin হেডার বা Referer হেডার ছাড়াই। ব্যবহারকারী কোন RP-এ সাইন ইন করার চেষ্টা করছে তা শিখতে এটি কার্যকরভাবে আইডিপিকে বাধা দেয়। যেমন:

  GET /accounts.example HTTP/1.1
  Host: accounts.idp.example
  Accept: application/json
  Cookie: 0x23223
  Sec-Fetch-Dest: webidentity

অনুরোধ পাওয়ার পরে, সার্ভারের উচিত:

যাচাই করুন যে অনুরোধটিতে একটি Sec-Fetch-Dest: webidentity HTTP হেডার রয়েছে।
ইতিমধ্যে সাইন-ইন করা অ্যাকাউন্টের আইডির সাথে সেশন কুকিজ মিলান।
অ্যাকাউন্টের তালিকা দিয়ে উত্তর দিন।

ব্রাউজার একটি JSON প্রতিক্রিয়া আশা করে যাতে নিম্নলিখিত বৈশিষ্ট্য সহ অ্যাকাউন্ট তথ্যের অ্যারে সহ একটি accounts সম্পত্তি অন্তর্ভুক্ত থাকে:

সম্পত্তি	বর্ণনা
`id` (প্রয়োজনীয়)	ব্যবহারকারীর অনন্য আইডি।
`name` (প্রয়োজনীয়)	ব্যবহারকারীর দেওয়া এবং পারিবারিক নাম।
`email` (প্রয়োজনীয়)	ব্যবহারকারীর ইমেল ঠিকানা।
`given_name` (ঐচ্ছিক)	ব্যবহারকারীর নাম দেওয়া হয়েছে।
`picture` (ঐচ্ছিক)	ব্যবহারকারী অবতার ছবির URL।
`approved_clients` (ঐচ্ছিক)	RP ক্লায়েন্ট আইডিগুলির একটি অ্যারে যার সাথে ব্যবহারকারী নিবন্ধন করেছেন৷
`login_hints` (ঐচ্ছিক)	সমস্ত সম্ভাব্য ফিল্টার প্রকারের একটি অ্যারে যা আইডিপি একটি অ্যাকাউন্ট নির্দিষ্ট করতে সমর্থন করে। নির্দিষ্ট অ্যাকাউন্টটি বেছে নেওয়ার জন্য RP `loginHint` প্রপার্টির সাথে `navigator.credentials.get()` ব্যবহার করতে পারে।
`domain_hints` (ঐচ্ছিক)	অ্যাকাউন্টের সাথে সংশ্লিষ্ট সমস্ত ডোমেনের একটি অ্যারে। অ্যাকাউন্টগুলি ফিল্টার করার জন্য RP একটি `domainHint` বৈশিষ্ট্য সহ `navigator.credentials.get()` কল করতে পারে।
`labels` (ঐচ্ছিক)	স্ট্রিং কাস্টম অ্যাকাউন্ট লেবেলের অ্যারে যা একটি অ্যাকাউন্টের সাথে যুক্ত। একটি আইডিপি নিম্নরূপ কাস্টম অ্যাকাউন্ট লেবেলিং প্রয়োগ করতে পারে: অ্যাকাউন্টের শেষ পয়েন্টে অ্যাকাউন্ট লেবেলগুলি নির্দিষ্ট করুন (এই `labels` প্যারামিটার ব্যবহার করে)। প্রতিটি নির্দিষ্ট লেবেলের জন্য একটি কনফিগার ফাইল তৈরি করুন। উদাহরণ স্বরূপ, একটি আইডিপি `https://idp.example/developer-config.json` কনফিগার ফাইল `"accounts": {"include": "developer"}` উল্লেখ করে প্রয়োগ করে। আইডিপি অ্যাকাউন্টের শেষ পয়েন্টে `labels` প্যারামিটার ব্যবহার করে কিছু অ্যাকাউন্টকে `"developer"` লেবেল দিয়ে চিহ্নিত করে। যখন একজন RP `https://idp.example/developer-config.json` কনফিগারেশন ফাইলের সাথে `navigator.credentials.get()` কল করে, তখন শুধুমাত্র `"developer"` লেবেল সহ অ্যাকাউন্টগুলি ফেরত দেওয়া হবে। কাস্টম অ্যাকাউন্ট লেবেলগুলি লগইন ইঙ্গিত এবং ডোমেন ইঙ্গিত থেকে এমনভাবে আলাদা যে সেগুলি সম্পূর্ণরূপে আইডিপি সার্ভার দ্বারা রক্ষণাবেক্ষণ করা হয় এবং আরপি শুধুমাত্র ব্যবহার করার জন্য কনফিগার ফাইলটি নির্দিষ্ট করে৷

উদাহরণ প্রতিক্রিয়া বডি:

  {
    "accounts": [{
      "id": "1234",
      "given_name": "John",
      "name": "John Doe",
      "email": "john_doe@idp.example",
      "picture": "https://idp.example/profile/123",
      // Ids of those RPs where this account can be used
      "approved_clients": ["123", "456", "789"],
      // This account has 'login_hints`. When an RP calls `navigator.credentials.get()`
      // with a `loginHint` value specified, for example, `exampleHint`, only those
      // accounts will be shown to the user whose 'login_hints' array contains the `exampleHint`.
      "login_hints": ["demo1", "exampleHint"],
      // This account is labelled. IdP can implement a specific config file for a
      // label, for example, `https://idp.example/developer-config.json`. Like that
      // RPs can filter out accounts by calling `navigator.credentials.get()` with
      // `https://idp.example/developer-config.json` config file.
      "labels": ["hr", "developer"]
    }, {
      "id": "5678",
      "given_name": "Johnny",
      "name": "Johnny",
      "email": "johnny@idp.example",
      "picture": "https://idp.example/profile/456",
      "approved_clients": ["abc", "def", "ghi"],
      "login_hints": ["demo2"],
      "domain_hints": ["@domain.example"]
    }]
  }

ব্যবহারকারী সাইন ইন না করলে, HTTP 401 (অননুমোদিত) দিয়ে প্রতিক্রিয়া জানাতে।

ফেরত দেওয়া অ্যাকাউন্টের তালিকা ব্রাউজার ব্যবহার করে এবং RP-এর কাছে উপলব্ধ হবে না।

আইডি দাবী শেষ পয়েন্ট

আইডিপি-এর আইডি অ্যাসারশন এন্ডপয়েন্ট তাদের সাইন-ইন করা ব্যবহারকারীর জন্য একটি দাবি প্রদান করে। ব্যবহারকারী যখন navigator.credentials.get() কল ব্যবহার করে একটি RP ওয়েবসাইটে সাইন ইন করেন, তখন ব্রাউজার SameSite=None এর সাথে কুকিজ সহ একটি POST অনুরোধ পাঠায় এবং এই এন্ডপয়েন্টে একটি কন্টেন্ট-টাইপ application/x-www-form-urlencoded নিম্নলিখিত তথ্য:

সম্পত্তি	বর্ণনা
`client_id` (প্রয়োজনীয়)	RP-এর ক্লায়েন্ট শনাক্তকারী।
`account_id` (প্রয়োজনীয়)	সাইন ইন করা ব্যবহারকারীর অনন্য আইডি।
`disclosure_text_shown`	`"true"` বা `"false"` (বুলিয়ানের পরিবর্তে) একটি স্ট্রিংয়ে ফলাফল। এই ক্ষেত্রে ফলাফল `"false"` : যদি ডিসক্লোজার টেক্সট দেখানো না হয় কারণ RP-এর ক্লায়েন্ট আইডি অ্যাকাউন্ট এন্ডপয়েন্ট থেকে প্রতিক্রিয়ার `approved_clients` সম্পত্তি তালিকায় অন্তর্ভুক্ত ছিল। যদি প্রকাশের পাঠ্যটি দেখানো না হয় কারণ ব্রাউজার অতীতে `approved_clients` অনুপস্থিতিতে একটি সাইন-আপ মুহূর্ত পর্যবেক্ষণ করেছে। যদি `fields` পরামিতি তিনটি ক্ষেত্রের এক বা একাধিক ("নাম", "ইমেল" এবং "ছবি") অন্তর্ভুক্ত না করে, উদাহরণস্বরূপ, `fields=[ ]` , বা `fields=['name', 'picture']` । পুরানো আইডিপি বাস্তবায়নের সাথে পশ্চাদমুখী সামঞ্জস্যের জন্য এটি প্রয়োজন যা একটি ডিসক্লোজার স্ট্রিং সর্বদা তিনটি ক্ষেত্র অন্তর্ভুক্ত করবে বলে আশা করে।
`is_auto_selected`	যদি RP-তে স্বয়ংক্রিয়-পুনঃপ্রমাণকরণ করা হয়, তাহলে `is_auto_selected` `"true"` নির্দেশ করে। অন্যথায় `"false"` । এটি আরও নিরাপত্তা সম্পর্কিত বৈশিষ্ট্য সমর্থন করতে সহায়ক। উদাহরণস্বরূপ, কিছু ব্যবহারকারী একটি উচ্চতর নিরাপত্তা স্তর পছন্দ করতে পারে যার জন্য প্রমাণীকরণে স্পষ্ট ব্যবহারকারীর মধ্যস্থতা প্রয়োজন। যদি কোনও আইডিপি এই ধরনের মধ্যস্থতা ছাড়াই একটি টোকেন অনুরোধ পায়, তবে তারা অনুরোধটি ভিন্নভাবে পরিচালনা করতে পারে। উদাহরণস্বরূপ, একটি ত্রুটি কোড ফেরত দিন যাতে RP `mediation: required` ।
`fields` (ঐচ্ছিক)	স্ট্রিংগুলির অ্যারে যা ব্যবহারকারীর তথ্য ("নাম", "ইমেল", "ছবি") নির্দিষ্ট করে যা তাদের সাথে ভাগ করার জন্য RP-এর আইডিপি প্রয়োজন। ব্রাউজার POST অনুরোধে নির্দিষ্ট ক্ষেত্র তালিকাভুক্ত করার জন্য `fields` , `disclosure_text_shown` , এবং `disclosure_shown_for` পাঠাবে, যেমনটি নিম্নলিখিত উদাহরণে । দ্রষ্টব্য: ক্ষেত্র প্যারামিটার Chrome 132 থেকে সমর্থিত।
`params` (ঐচ্ছিক)	যেকোন বৈধ JSON অবজেক্ট যা অতিরিক্ত কাস্টম কী-মানের প্যারামিটার নির্দিষ্ট করতে দেয়, উদাহরণস্বরূপ: `scope` : একটি স্ট্রিং মান যেখানে অতিরিক্ত অনুমতি রয়েছে যা RP-কে অনুরোধ করতে হবে, উদাহরণস্বরূপ `"drive.readonly calendar.readonly"` `nonce` : এই নির্দিষ্ট অনুরোধের জন্য প্রতিক্রিয়া জারি করা হয়েছে তা নিশ্চিত করতে RP দ্বারা প্রদত্ত একটি র্যান্ডম স্ট্রিং। রিপ্লে আক্রমণ প্রতিরোধ করে। অন্যান্য কাস্টম কী-মানের প্যারামিটার। যখন ব্রাউজার একটি POST অনুরোধ পাঠায়, তখন `params` মান JSON-এ সিরিয়ালাইজ করা হবে এবং তারপর শতাংশ-এনকোড করা হবে । দ্রষ্টব্য: পরামিতি API Chrome 132 এবং পরবর্তীতে সমর্থিত।

উদাহরণ HTTP হেডার:

  POST /assertion.example HTTP/1.1
  Host: accounts.idp.example
  Origin: https://rp.example/
  Content-Type: application/x-www-form-urlencoded
  Cookie: 0x23223
  Sec-Fetch-Dest: webidentity

  // disclosure_text_shown is set to 'false', as the 'name' field value is missing in 'fields' array
  // params value is serialized to JSON and then percent-encoded.
  account_id=123&client_id=client1234&disclosure_text_shown=false&is_auto_selected=true&params=%22%7B%5C%22nonce%5C%22%3A%5C%22nonce-value%5C%22%7D%22.%0D%0A4&disclosure_text_shown=true&fields=email,picture&disclosure_shown_for=email,picture

অনুরোধ পাওয়ার পরে, সার্ভারের উচিত:

CORS (ক্রস-অরিজিন রিসোর্স শেয়ারিং) এর সাথে অনুরোধে সাড়া দিন।
যাচাই করুন যে অনুরোধটিতে একটি Sec-Fetch-Dest: webidentity HTTP হেডার রয়েছে।
client_id দ্বারা নির্ধারিত RP অরিজিনের সাথে Origin হেডার মিলান। যদি তারা মেলে না তাহলে প্রত্যাখ্যান করুন।
ইতিমধ্যে সাইন-ইন করা অ্যাকাউন্টের আইডির সাথে account_id মেলে। যদি তারা মেলে না তাহলে প্রত্যাখ্যান করুন।
একটি টোকেন দিয়ে সাড়া দিন। যদি অনুরোধ প্রত্যাখ্যান করা হয়, একটি ত্রুটি প্রতিক্রিয়া সঙ্গে প্রতিক্রিয়া.

সতর্কতা: CORS অনুরোধটি অবশ্যই শংসাপত্রযুক্ত হতে হবে, যার অর্থ Access-Control-Allow-Origin প্রতিক্রিয়া শিরোনামটি অবশ্যই "*" ব্যবহার করে ওয়াইল্ডকার্ডের পরিবর্তে একটি স্পষ্ট উত্স নির্দেশ করবে৷

HTTP/1.1 200 OK
Access-Control-Allow-Origin: https://rp.example
Access-Control-Allow-Credentials: true

আইডিপি সিদ্ধান্ত নিতে পারে তারা কিভাবে টোকেন ইস্যু করবে। সাধারণভাবে, এটি অ্যাকাউন্ট আইডি, ক্লায়েন্ট আইডি, ইস্যুকারীর মূল এবং ননসের মতো তথ্য সহ স্বাক্ষরিত হয়, যাতে RP টোকেনটি আসল কিনা তা যাচাই করতে পারে।

ব্রাউজার একটি JSON প্রতিক্রিয়া আশা করে যাতে নিম্নলিখিত বৈশিষ্ট্য অন্তর্ভুক্ত থাকে:

সম্পত্তি	বর্ণনা
`token`	একটি টোকেন হল একটি স্ট্রিং যাতে প্রমাণীকরণ সম্পর্কে দাবি থাকে।
`continue_on`	পুনঃনির্দেশিত URL যা একটি বহু-পদক্ষেপ সাইন-ইন প্রবাহ সক্ষম করে৷

প্রত্যাবর্তিত টোকেন ব্রাউজার দ্বারা RP-এ পাঠানো হয়, যাতে RP প্রমাণীকরণ যাচাই করতে পারে।

  {
    // IdP can respond with a token to authenticate the user
    "token": "***********"
  }

বৈশিষ্ট্য চালিয়ে যান

আইডিপি একটি বহু-পদক্ষেপ সাইন-ইন প্রবাহ সক্ষম করতে আইডি অ্যাসারশন এন্ডপয়েন্ট প্রতিক্রিয়াতে একটি পুনঃনির্দেশ URL প্রদান করতে পারে। যখন IdP-কে অতিরিক্ত তথ্য বা অনুমতির অনুরোধ করতে হয়, উদাহরণস্বরূপ:

ব্যবহারকারীর সার্ভার-সাইড রিসোর্স অ্যাক্সেস করার অনুমতি।
যাচাইকরণ যে যোগাযোগের তথ্য আপ-টু-ডেট।
অভিভাবকীয় নিয়ন্ত্রণ।

আইডি অ্যাসারশন এন্ডপয়েন্ট একটি continue_on প্রপার্টি ফেরত দিতে পারে যার মধ্যে আইডি অ্যাসারশন এন্ডপয়েন্টের একটি পরম বা আপেক্ষিক পথ রয়েছে।

  {
    // In the id_assertion_endpoint, instead of returning a typical
    // "token" response, the IdP decides that it needs the user to
    // continue on a popup window:
    "continue_on": "https://idp.example/continue_on_url"
  }

যদি প্রতিক্রিয়াটিতে continue_on প্যারামিটার থাকে, একটি নতুন পপআপ উইন্ডো খোলা হয় এবং ব্যবহারকারীকে নির্দিষ্ট পথে নেভিগেট করে। continue_on পৃষ্ঠার সাথে ব্যবহারকারীর ইন্টারঅ্যাকশনের পরে, IdP-এর উচিত IdentityProvider.resolve() কে আর্গুমেন্ট হিসাবে পাস করা টোকেন সহ কল করা যাতে মূল navigator.credentials.get() কল থেকে প্রতিশ্রুতিটি সমাধান করা যায়:

  document.getElementById('example-button').addEventListener('click', async () => {
    let accessToken = await fetch('/generate_access_token.cgi');
    // Closes the window and resolves the promise (that is still hanging
    // in the relying party's renderer) with the value that is passed.
    IdentityProvider.resolve(accessToken);
  });

ব্রাউজার তখন স্বয়ংক্রিয়ভাবে পপআপ বন্ধ করবে এবং API কলারকে টোকেন ফিরিয়ে দেবে। একটি এককালীন IdentityProvider.resolve() কল হল প্যারেন্ট উইন্ডো (RP) এবং পপআপ উইন্ডোর (IdP) যোগাযোগের একমাত্র উপায়৷
ব্যবহারকারী অনুরোধ প্রত্যাখ্যান করলে, IdP IdentityProvider.close() কল করে উইন্ডোটি বন্ধ করতে পারে।

  IdentityProvider.close();

Continuation API-এর কাজ করার জন্য স্পষ্ট ব্যবহারকারীর মিথস্ক্রিয়া (ক্লিক) প্রয়োজন। কন্টিনিউয়েশন API বিভিন্ন মধ্যস্থতা মোডের সাথে কীভাবে কাজ করে তা এখানে:

প্যাসিভ মোডে :
- mediation: 'optional' (ডিফল্ট): Continuation API শুধুমাত্র ব্যবহারকারীর অঙ্গভঙ্গির সাথে কাজ করবে, যেমন পৃষ্ঠায় বা FedCM UI-তে একটি বোতামে ক্লিক করা। যখন ব্যবহারকারীর অঙ্গভঙ্গি ছাড়াই স্বয়ংক্রিয় পুনরায় প্রমাণীকরণ ট্রিগার করা হয়, তখন কোনও পপআপ উইন্ডো খোলা হয় না এবং প্রতিশ্রুতি প্রত্যাখ্যান করা হয়।
- mediation: 'required' : সর্বদা ব্যবহারকারীকে যোগাযোগ করতে বলে, তাই কন্টিনিউয়েশন API সর্বদা কাজ করে।
সক্রিয় মোডে :
- ব্যবহারকারী সক্রিয়করণ সবসময় প্রয়োজন হয়. Continuation API সামঞ্জস্যপূর্ণ।

যদি কোনো কারণে ব্যবহারকারী পপআপে তাদের অ্যাকাউন্ট পরিবর্তন করে থাকেন (উদাহরণস্বরূপ, আইডিপি একটি "অন্য অ্যাকাউন্ট ব্যবহার করুন" ফাংশন অফার করে, বা প্রতিনিধিদের ক্ষেত্রে), সমাধান কলটি একটি ঐচ্ছিক দ্বিতীয় যুক্তি নেয় যা কিছু করার অনুমতি দেয়:

  IdentityProvider.resolve(token, {accountId: '1234');

একটি ত্রুটি প্রতিক্রিয়া ফেরত দিন

id_assertion_endpoint একটি "ত্রুটি" প্রতিক্রিয়াও দিতে পারে, যার দুটি ঐচ্ছিক ক্ষেত্র রয়েছে:

code : IdP OAuth 2.0 নির্দিষ্ট ত্রুটির তালিকা থেকে পরিচিত ত্রুটিগুলির মধ্যে একটি বেছে নিতে পারে ( invalid_request , unauthorized_client , access_denied , server_error এবং temporarily_unavailable ) অথবা যেকোনো ইচ্ছামত স্ট্রিং ব্যবহার করতে পারে। যদি পরেরটি হয়, Chrome একটি সাধারণ ত্রুটি বার্তা সহ ত্রুটি UI রেন্ডার করে এবং কোডটি RP-তে পাস করে।
url : এটি ব্যবহারকারীদের ত্রুটি সম্পর্কে অতিরিক্ত তথ্য প্রদানের জন্য ত্রুটি সম্পর্কে তথ্য সহ একটি মানব-পাঠযোগ্য ওয়েব পৃষ্ঠা সনাক্ত করে। এই ক্ষেত্রটি ব্যবহারকারীদের জন্য উপযোগী কারণ ব্রাউজারগুলি বিল্ট-ইন UI-তে সমৃদ্ধ ত্রুটি বার্তা প্রদান করতে পারে না। উদাহরণস্বরূপ: পরবর্তী পদক্ষেপের জন্য লিঙ্ক, বা গ্রাহক পরিষেবা যোগাযোগের তথ্য। যদি কোনও ব্যবহারকারী ত্রুটির বিবরণ এবং কীভাবে এটি ঠিক করতে হয় সে সম্পর্কে আরও জানতে চান, তারা আরও বিশদ বিবরণের জন্য ব্রাউজার UI থেকে প্রদত্ত পৃষ্ঠায় যেতে পারেন। ইউআরএলটি অবশ্যই আইডিপি configURL এর মতো একই সাইটের হতে হবে।

  // id_assertion_endpoint response
  {
    "error" : {
      "code": "access_denied",
      "url" : "https://idp.example/error?type=access_denied"
    }
  }

কাস্টম অ্যাকাউন্ট লেবেল

কাস্টম অ্যাকাউন্ট লেবেলগুলির সাথে, আইডিপি লেবেল সহ ব্যবহারকারীর অ্যাকাউন্টগুলিকে টীকা করতে পারে এবং RP সেই নির্দিষ্ট লেবেলের জন্য configURL নির্দিষ্ট করে শুধুমাত্র নির্দিষ্ট লেবেল সহ অ্যাকাউন্টগুলি আনতে বেছে নিতে পারে। এটি উপযোগী হতে পারে যখন একটি RP-কে নির্দিষ্ট মানদণ্ড অনুসারে অ্যাকাউন্টগুলি ফিল্টার করতে হবে, উদাহরণস্বরূপ, শুধুমাত্র ভূমিকা-নির্দিষ্ট অ্যাকাউন্টগুলি যেমন "developer" বা "hr" প্রদর্শন করতে।

navigator.credentials.get() কলে উল্লেখ করে ডোমেন ইঙ্গিত এবং লগইন ইঙ্গিত বৈশিষ্ট্যগুলি ব্যবহার করে অনুরূপ ফিল্টারিং সম্ভব। যাইহোক, কাস্টম অ্যাকাউন্ট লেবেলগুলি কনফিগার ফাইলটি নির্দিষ্ট করে ব্যবহারকারীদের ফিল্টার করতে পারে, যা একাধিক কনফিগার ইউআরএল ব্যবহার করা হলে বিশেষত কার্যকর। কাস্টম অ্যাকাউন্ট লেবেলগুলিও আলাদা যে সেগুলি আইডিপি সার্ভার থেকে প্রদান করা হয়, যেমন RP থেকে, লগইন বা ডোমেন ইঙ্গিতের মতো।

একটি আইডিপি বিবেচনা করুন যা "developer" এবং "hr" অ্যাকাউন্টগুলির মধ্যে পার্থক্য করতে চায়৷ এটি অর্জন করতে, আইডিপিকে যথাক্রমে "developer" এবং "hr" এর জন্য দুটি কনফিগারেশন সমর্থন করতে হবে:

ডেভেলপার কনফিগারেশন ফাইল https://idp.example/developer/fedcm.json একটি "developer" লেবেল রয়েছে এবং এন্টারপ্রাইজ কনফিগারেশন ফাইল https://idp.example/hr/fedcm.json একটি "hr" লেবেল রয়েছে :

  // The developer config file at `https://idp.example/developer/fedcm.json`
  {
    "accounts_endpoint": "https://idp.example/accounts",
    "client_metadata_endpoint": "/client_metadata",
    "login_url": "https://idp.example/login",
    "id_assertion_endpoint": "/assertion",
    "accounts": {
      // Account label
      "include": "developer"
    }
  }

  // The hr config file at `https://idp.example/hr/fedcm.json`
  {
    "accounts_endpoint": "https://idp.example/accounts",
    "client_metadata_endpoint": "/client_metadata",
    "login_url": "https://idp.example/login",
    "id_assertion_endpoint": "/assertion",
    "accounts": {
      // Account label
      "include": "hr"
    }
  }

এই ধরনের সেটআপের সাথে, সুপরিচিত ফাইলটিতে একাধিক কনফিগারেশনের অনুমতি দেওয়ার জন্য accounts_endpoint এবং login_url অন্তর্ভুক্ত করা উচিত:

  {
    "provider_urls": [ "https://idp.example/fedcm.json" ],
    "accounts_endpoint": "https://idp.example/accounts",
    "login_url": "https://idp.example/login"
  }

সাধারণ আইডিপি অ্যাকাউন্টের এন্ডপয়েন্ট (এই উদাহরণে https://idp.example/accounts ) অ্যাকাউন্টগুলির একটি তালিকা প্রদান করে যাতে প্রতিটি অ্যাকাউন্টের জন্য একটি অ্যারেতে অ্যাসাইন করা লেবেল সহ একটি labels বৈশিষ্ট্য অন্তর্ভুক্ত থাকে:

  {
  "accounts": [{
    "id": "123",
    "given_name": "John",
    "name": "John Doe",
    "email": "john_doe@idp.example",
    "picture": "https://idp.example/profile/123",
    "labels": ["developer"]
    }], [{
    "id": "4567",
    "given_name": "Jane",
    "name": "Jane Doe",
    "email": "jane_doe@idp.example",
    "picture": "https://idp.example/profile/4567",
    "labels": ["hr"]
    }]
  }

যখন একটি RP "hr" ব্যবহারকারীদের সাইন ইন করার অনুমতি দিতে চায়, তারা navigator.credentials.get() কলে configURL https://idp.example/hr/fedcm.json নির্দিষ্ট করতে পারে:

  let { token } = await navigator.credentials.get({
    identity: {
      providers: [{
        clientId: '1234',
        nonce: '234234',
        configURL: 'https://idp.example/hr/fedcm.json',
      },
    }
  });

ফলস্বরূপ, ব্যবহারকারীর সাইন ইন করার জন্য শুধুমাত্র 4567 -এর অ্যাকাউন্ট আইডি উপলব্ধ। 123 এর অ্যাকাউন্ট আইডি ব্রাউজার দ্বারা নিঃশব্দে লুকানো থাকে যাতে ব্যবহারকারীকে এমন একটি অ্যাকাউন্ট সরবরাহ করা না হয় যা এই আইডিপি দ্বারা সমর্থিত নয়। সাইট

লেবেল হল স্ট্রিং। যদি labels অ্যারে বা include ক্ষেত্রে এমন কিছু থাকে যা একটি স্ট্রিং নয়, এটি উপেক্ষা করা হয়।
configURL এ কোনো লেবেল নির্দিষ্ট না থাকলে, সমস্ত অ্যাকাউন্ট FedCM অ্যাকাউন্ট চয়নকারীতে প্রদর্শিত হবে।
যদি কোনো অ্যাকাউন্টের জন্য কোনো লেবেল নির্দিষ্ট করা না থাকে, তাহলে এটি শুধুমাত্র অ্যাকাউন্ট চয়নকারীতে প্রদর্শিত হবে যদি configURL একটি লেবেলও নির্দিষ্ট না করে।
যদি কোনো অ্যাকাউন্ট প্যাসিভ মোডে অনুরোধ করা লেবেলের সাথে মেলে না (ডোমেন ইঙ্গিত বৈশিষ্ট্যের অনুরূপ), FedCM ডায়ালগ একটি লগইন প্রম্পট দেখায়, যা ব্যবহারকারীকে একটি IdP অ্যাকাউন্টে সাইন ইন করতে দেয়। সক্রিয় মোডের জন্য, লগইন পপআপ উইন্ডোটি সরাসরি খোলা হয়।

এন্ডপয়েন্ট সংযোগ বিচ্ছিন্ন করুন

IdentityCredential.disconnect() চালু করার মাধ্যমে, ব্রাউজার SameSite=None সহ কুকি সহ একটি ক্রস-অরিজিন POST অনুরোধ পাঠায় এবং নিম্নলিখিত তথ্য সহ এই সংযোগ বিচ্ছিন্ন প্রান্তবিন্দুতে একটি সামগ্রী-প্রকার application/x-www-form-urlencoded :

সম্পত্তি	বর্ণনা
`account_hint`	আইডিপি অ্যাকাউন্টের জন্য একটি ইঙ্গিত..
`client_id`	RP-এর ক্লায়েন্ট শনাক্তকারী।

  POST /disconnect.example HTTP/1.1
  Host: idp.example
  Origin: rp.example
  Content-Type: application/x-www-form-urlencoded
  Cookie: 0x123
  Sec-Fetch-Dest: webidentity

  account_hint=account456&client_id=rp123

অনুরোধ পাওয়ার পরে, সার্ভারের উচিত:

CORS (ক্রস-অরিজিন রিসোর্স শেয়ারিং) এর সাথে অনুরোধে সাড়া দিন।
যাচাই করুন যে অনুরোধটিতে একটি Sec-Fetch-Dest: webidentity HTTP হেডার রয়েছে।
client_id দ্বারা নির্ধারিত RP অরিজিনের সাথে Origin হেডার মিলান। যদি তারা মেলে না তাহলে প্রত্যাখ্যান করুন।
ইতিমধ্যেই সাইন-ইন করা অ্যাকাউন্টগুলির আইডিগুলির সাথে account_hint মেলান৷
RP থেকে ব্যবহারকারীর অ্যাকাউন্ট সংযোগ বিচ্ছিন্ন করুন।
একটি JSON বিন্যাসে চিহ্নিত ব্যবহারকারীর অ্যাকাউন্টের তথ্য সহ ব্রাউজারে প্রতিক্রিয়া জানান।

HTTP/1.1 200 OK
Access-Control-Allow-Origin: https://rp.example
Access-Control-Allow-Credentials: true

একটি উদাহরণ প্রতিক্রিয়া JSON পেলোড এই মত দেখায়:

  {
    "account_id": "account456"
  }

পরিবর্তে, যদি আইডিপি ব্রাউজারটি RP-এর সাথে যুক্ত সমস্ত অ্যাকাউন্ট সংযোগ বিচ্ছিন্ন করতে চায়, তাহলে একটি স্ট্রিং পাস করুন যা কোনো অ্যাকাউন্ট আইডির সাথে মেলে না, উদাহরণস্বরূপ "*" ।

ক্লায়েন্ট মেটাডেটা শেষ পয়েন্ট

আইডিপির ক্লায়েন্ট মেটাডেটা এন্ডপয়েন্ট নির্ভরকারী পক্ষের মেটাডেটা প্রদান করে যেমন RP-এর গোপনীয়তা নীতি, পরিষেবার শর্তাবলী এবং লোগো আইকন। RP-এর উচিত তাদের গোপনীয়তা নীতি এবং পরিষেবার শর্তাবলীর লিঙ্ক আগে থেকেই আইডিপি-তে দেওয়া। এই লিঙ্কগুলি সাইন-ইন ডায়ালগে প্রদর্শিত হয় যখন ব্যবহারকারী এখনও আইডিপি-তে RP-এ নিবন্ধন করেননি৷

ব্রাউজার কুকি ছাড়া client_id navigator.credentials.get ব্যবহার করে একটি GET অনুরোধ পাঠায়। যেমন:

  GET /client_metadata.example?client_id=1234 HTTP/1.1
  Host: accounts.idp.example
  Origin: https://rp.example/
  Accept: application/json
  Sec-Fetch-Dest: webidentity

অনুরোধ পাওয়ার পরে, সার্ভারের উচিত:

client_id এর জন্য RP নির্ধারণ করুন।
ক্লায়েন্ট মেটাডেটা সঙ্গে প্রতিক্রিয়া.

ক্লায়েন্ট মেটাডেটা শেষ পয়েন্টের বৈশিষ্ট্যগুলির মধ্যে রয়েছে:

সম্পত্তি	বর্ণনা
`privacy_policy_url` (ঐচ্ছিক)	RP গোপনীয়তা নীতি URL.
`terms_of_service_url` (ঐচ্ছিক)	RP পরিষেবার শর্তাবলী URL।
`icons` (ঐচ্ছিক)	অবজেক্টের অ্যারে, যেমন `[{ "url": "https://rp.example/rp-icon.ico", "size": 40}]`

ব্রাউজার শেষ পয়েন্ট থেকে একটি JSON প্রতিক্রিয়া আশা করে:

  {
    "privacy_policy_url": "https://rp.example/privacy_policy.html",
    "terms_of_service_url": "https://rp.example/terms_of_service.html",
    "icons": [{
          "url": "https://rp.example/rp-icon.ico",
          "size": 40
      }]
  }

ফিরে আসা ক্লায়েন্ট মেটাডেটা ব্রাউজার দ্বারা গ্রাস করা হয় এবং RP-এর কাছে উপলব্ধ হবে না।

ব্যবহারকারীকে আইডিপিতে সাইন ইন করতে দেওয়ার জন্য এই এন্ডপয়েন্ট ব্যবহার করা হয়।

লগইন স্থিতি API এর সাথে, আইডিপিকে অবশ্যই ব্যবহারকারীর লগইন অবস্থা ব্রাউজারে জানাতে হবে। যাইহোক, স্থিতি সিঙ্কের বাইরে হতে পারে, যেমন সেশনের মেয়াদ শেষ হলে। এই ধরনের পরিস্থিতিতে, ব্রাউজারটি গতিশীলভাবে ব্যবহারকারীকে আইডিপি কনফিগারেশন ফাইলের login_url এর সাথে নির্দিষ্ট করা লগইন পৃষ্ঠা URL-এর মাধ্যমে আইডিপিতে সাইন ইন করতে দিতে পারে।

FedCM ডায়ালগ একটি সাইন ইন করার পরামর্শ দিয়ে একটি বার্তা প্রদর্শন করে, যেমনটি নিচের ছবিতে দেখানো হয়েছে।

একটি FedCM ডায়ালগ IdP-এ সাইন ইন করার পরামর্শ দিচ্ছে৷

ব্যবহারকারী যখন Continue বাটনে ক্লিক করেন, ব্রাউজারটি IdP-এর লগইন পৃষ্ঠার জন্য একটি পপআপ উইন্ডো খোলে।

একটি উদাহরণ FedCM ডায়ালগ। — আইডিপি বোতামে সাইন ইনে ক্লিক করার পরে দেখানো একটি উদাহরণ ডায়ালগ।

ডায়ালগ হল একটি নিয়মিত ব্রাউজার উইন্ডো যাতে প্রথম পক্ষের কুকিজ থাকে। ডায়ালগের মধ্যে যা ঘটে তা আইডিপির উপর নির্ভর করে এবং RP পৃষ্ঠায় ক্রস-অরিজিন যোগাযোগের অনুরোধ করার জন্য কোনও উইন্ডো হ্যান্ডেল উপলব্ধ নেই। ব্যবহারকারী সাইন ইন করার পরে, আইডিপির উচিত:

Set-Login: logged-in header পাঠান বা navigator.login.setStatus("logged-in") API এ কল করুন যাতে ব্রাউজারকে জানানো হয় যে ব্যবহারকারী সাইন ইন করেছেন৷
ডায়ালগ বন্ধ করতে IdentityProvider.close() এ কল করুন।

একজন ব্যবহারকারী FedCM ব্যবহার করে IdP-এ সাইন ইন করার পর একটি RP-এ সাইন ইন করেন।

লগইন স্ট্যাটাস এপিআই হল একটি মেকানিজম যেখানে একটি ওয়েবসাইট, বিশেষ করে একটি আইডিপি, ব্রাউজারকে আইডিপি-তে ব্যবহারকারীর লগইন অবস্থা সম্পর্কে অবহিত করে। এই API এর সাহায্যে, ব্রাউজারটি আইডিপি-তে অপ্রয়োজনীয় অনুরোধগুলি কমাতে পারে এবং সম্ভাব্য টাইমিং আক্রমণগুলি হ্রাস করতে পারে ৷

আইডিপিগুলি একটি HTTP শিরোনাম পাঠিয়ে বা একটি JavaScript API কল করার মাধ্যমে ব্রাউজারে ব্যবহারকারীর লগইন অবস্থা সংকেত দিতে পারে যখন ব্যবহারকারী IdP-এ সাইন ইন থাকে বা ব্যবহারকারী যখন তাদের সমস্ত IdP অ্যাকাউন্ট থেকে সাইন আউট হয়। প্রতিটি আইডিপি (এর কনফিগার ইউআরএল দ্বারা চিহ্নিত) জন্য ব্রাউজার সম্ভাব্য মান সহ লগইন অবস্থার প্রতিনিধিত্ব করে একটি ত্রি-রাষ্ট্র পরিবর্তনশীল রাখে:

logged-in
logged-out
unknown (ডিফল্ট)

লগইন অবস্থা	বর্ণনা
`logged-in`	যখন ব্যবহারকারীর লগইন অবস্থা `logged-in` জন্য সেট করা হয়, তখন RP কলিং FedCM আইডিপি-এর অ্যাকাউন্টের এন্ডপয়েন্টে অনুরোধ করে এবং FedCM ডায়ালগে ব্যবহারকারীর কাছে উপলব্ধ অ্যাকাউন্টগুলি প্রদর্শন করে।
`logged-out`	ব্যবহারকারীর লগইন স্ট্যাটাস `logged-out` হলে, IdP-এর অ্যাকাউন্টের এন্ডপয়েন্টে অনুরোধ না করে FedCM-কে নীরবে কল করা ব্যর্থ হয়।
`unknown` (ডিফল্ট)	লগইন স্ট্যাটাস API ব্যবহার করে আইডিপি একটি সংকেত পাঠানোর আগে `unknown` স্থিতি সেট করা হয়। স্ট্যাটাস `unknown` হলে, ব্রাউজার আইডিপি-এর অ্যাকাউন্টের এন্ডপয়েন্টে একটি অনুরোধ করে এবং অ্যাকাউন্টের এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়ার ভিত্তিতে স্ট্যাটাস আপডেট করে।

ব্যবহারকারী সাইন ইন করেছেন তা সংকেত দিতে, শীর্ষ-স্তরের নেভিগেশনে একটি Set-Login: logged-in HTTP শিরোনাম পাঠান বা আইডিপি মূলে একই-সাইট সাবরিসোর্স অনুরোধ পাঠান:

  Set-Login: logged-in

বিকল্পভাবে, একটি শীর্ষ-স্তরের নেভিগেশনে IdP মূল থেকে JavaScript পদ্ধতি navigator.login.setStatus('logged-in') কল করুন:

  navigator.login.setStatus('logged-in')

ব্যবহারকারীর লগইন অবস্থা logged-in হিসাবে সেট করা হবে।

ব্যবহারকারীকে তাদের সমস্ত অ্যাকাউন্ট থেকে সাইন আউট করার সংকেত দিতে, শীর্ষ-স্তরের নেভিগেশনে একটি Set-Login: logged-out HTTP শিরোনাম পাঠান বা আইডিপি মূলে একই-সাইট সাবরিসোর্স অনুরোধ পাঠান:

  Set-Login: logged-out

বিকল্পভাবে, একটি শীর্ষ-স্তরের নেভিগেশনে আইডিপি মূল থেকে JavaScript API navigator.login.setStatus('logged-out') কল করুন:

  navigator.login.setStatus('logged-out')

ব্যবহারকারীর লগইন অবস্থা logged-out হিসাবে সেট করা হবে।

লগইন স্ট্যাটাস API ব্যবহার করে আইডিপি একটি সংকেত পাঠানোর আগে unknown স্থিতি সেট করা হয়। ব্রাউজারটি আইডিপির অ্যাকাউন্টের এন্ডপয়েন্টে একটি অনুরোধ করে এবং অ্যাকাউন্টের এন্ডপয়েন্টের প্রতিক্রিয়ার ভিত্তিতে স্ট্যাটাস আপডেট করে:

যদি এন্ডপয়েন্ট সক্রিয় অ্যাকাউন্টগুলির একটি তালিকা প্রদান করে, logged-in জন্য স্থিতি আপডেট করুন এবং সেই অ্যাকাউন্টগুলি দেখানোর জন্য FedCM ডায়ালগ খুলুন।
যদি এন্ডপয়েন্ট কোনো অ্যাকাউন্ট না দেয়, logged-out স্ট্যাটাস আপডেট করুন এবং FedCM কল ব্যর্থ করুন।

দ্রষ্টব্য: Chrome 122 থেকে শুরু করে একই-সাইটের সাবরিসোর্স থেকেও লগইন স্ট্যাটাস হেডার পাঠানো যেতে পারে। এটি উপযোগী, উদাহরণস্বরূপ, যখন একটি ওয়েবসাইট যা ব্যবহারকারীদের idp.example এ তাদের ব্যবহারকারীর নাম এবং পাসওয়ার্ড লিখতে দেয়, কিন্তু শংসাপত্রগুলি পোস্ট করা হয় fetch() সহ login.idp.example । login.idp.example থেকে পাওয়া প্রতিক্রিয়া এখনও Set-Login: logged-in HTTP হেডার পাঠিয়ে idp.example এর জন্য লগইন স্থিতি সেট করতে পারে।

একটি গতিশীল লগইন প্রবাহের মাধ্যমে ব্যবহারকারীকে সাইন ইন করতে দিন

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

এই গতিশীল লগইন অভিজ্ঞতার উদ্দেশ্যে করা হয় যখন একটি IdP সেশন একটি স্পষ্ট সাইন-আউট ছাড়াই মেয়াদ শেষ হয়ে যায়, যার ফলে ব্রাউজারের লগইন অবস্থা ব্যবহারকারীর প্রকৃত অবস্থার সাথে বিরোধিতা করে। যারা এখনও আইডিপিতে সাইন ইন করেননি তাদের জন্য এটি ট্রিগার করা হয়নি। এই ফ্লোটি এমন ক্ষেত্রে কভার করার জন্য ডিজাইন করা হয়েছে যেখানে ব্রাউজারে ব্যবহারকারীর আইডিপি লগইন স্ট্যাটাস logged-in কিন্তু আইডিপি-এর অ্যাকাউন্টের এন্ডপয়েন্ট কোনও অ্যাকাউন্ট ফেরত দেয় না। অনুমান করে লগইন স্ট্যাটাস এপিআই অবিলম্বে কল করা হয়, যখন FedCM আমন্ত্রণ করা হয়, নিম্নলিখিত পরিস্থিতিগুলির মধ্যে যেকোনো একটি ঘটতে পারে:

ব্যবহারকারীর লগইন স্থিতি অজানা হিসাবে সেট করা থাকলে, অ্যাকাউন্টের শেষ পয়েন্ট থেকে আইডিপি-এর প্রতিক্রিয়ার উপর নির্ভর করে স্ট্যাটাস আপডেট করা হয় (হয় logged-in বা logged-out )। একটি গতিশীল লগইন প্রবাহ ট্রিগার করা হবে না।
যদি কোনো ব্যবহারকারী ব্রাউজারে IdP-এ সাইন ইন করে থাকে এবং তারপর IdP থেকে স্পষ্টভাবে সাইন আউট করে থাকে, তাহলে ডায়নামিক লগইন ফ্লো ট্রিগার হবে না।
যদি কোনো ব্যবহারকারী ব্রাউজারে আইডিপি-তে সাইন ইন করে থাকেন, কিন্তু logged-out কোনো স্পষ্ট আপডেট ছাড়াই সেশনের মেয়াদ শেষ হয়ে যায়, তাহলে গতিশীল লগইন প্রবাহ শুরু হয়।

লগইন স্ট্যাটাস এপিআই আইডিপি-তে সাইন ইন করেননি এমন ব্যবহারকারীদের জন্য "আইডিপিতে সাইন-ইন করুন" ডায়ালগ প্রদর্শন করার জন্য RP-এর ক্ষমতা প্রদান করে না। এটি একটি পৃথক বৈশিষ্ট্য যা ভবিষ্যতে যোগ করা যেতে পারে।

RP হিসাবে FedCM প্রয়োগ করুন

IdP-এর কনফিগারেশন এবং এন্ডপয়েন্ট উপলব্ধ হয়ে গেলে, RPs navigator.credentials.get() কল করে অনুরোধ করতে পারে যাতে ব্যবহারকারীরা IdP-এর সাথে RP-এ সাইন ইন করতে পারেন।

API কল করার আগে, আপনাকে নিশ্চিত করতে হবে যে FedCM ব্যবহারকারীর ব্রাউজারে উপলব্ধ । FedCM উপলব্ধ কিনা তা পরীক্ষা করতে, আপনার FedCM বাস্তবায়নের চারপাশে এই কোডটি মোড়ানো:

  if ('IdentityCredential' in window) {
    // If the feature is available, take action
  } else {
    // FedCM is not supported, use a different identity solution
  }

FedCM ব্যবহার করে ব্যবহারকারীদের একটি RP-এ IdP-এ সাইন ইন করার অনুমতি দেওয়ার জন্য, RP navigator.credentials.get() কল করতে পারে, উদাহরণস্বরূপ:

  const credential = await navigator.credentials.get({
    identity: {
      context: 'signin',
      providers: [{
        configURL: 'https://accounts.idp.example/config.json',
        clientId: '********',
        mode: 'active',
        params: {
          nonce: '******'
        }
      }]
    }
  });
  const { token } = credential;

প্রসঙ্গ সম্পত্তি

ঐচ্ছিক context সম্পত্তির সাহায্যে, RP FedCM ডায়ালগ UI-তে স্ট্রিং পরিবর্তন করতে পারে (উদাহরণস্বরূপ, "rp.example…তে সাইন ইন করুন", "idp.example ব্যবহার করুন...") পূর্বনির্ধারিত প্রমাণীকরণ প্রসঙ্গগুলিকে সামঞ্জস্য করতে। context সম্পত্তির নিম্নলিখিত মান থাকতে পারে:

signin (ডিফল্ট)
signup
use

FedCM ডায়ালগের UI উপাদানগুলি ব্যাখ্যা করে চিত্র: উপরের বাম দিকে, একটি আইকন প্রদর্শিত হয়৷ আইকনের ডানদিকে একটি প্রসঙ্গ উপাদান রয়েছে যা 'আইডিপি দিয়ে RP-এ সাইন ইন করুন' বার্তাটি প্রদর্শন করে। নীচে কাস্টম পাঠ্য এবং পটভূমির রঙ সহ একটি 'চালিয়ে যান' বোতাম রয়েছে৷ — কিভাবে ব্র্যান্ডিং FedCM ডায়ালগে প্রয়োগ করা হয়

উদাহরণস্বরূপ, use জন্য context সেট করার ফলে নিম্নলিখিত বার্তা আসবে:

একটি FedCM ডায়ালগ একটি কাস্টমাইজড প্রসঙ্গ বার্তা প্রদর্শন করে: FedCM-এর সাথে 'সাইন ইন'-এর পরিবর্তে প্রসঙ্গ বার্তাটি বলে 'FedCM ব্যবহার করুন'৷ — FedCM ডায়ালগ একটি কাস্টমাইজড প্রসঙ্গ বার্তা প্রদর্শন করছে।

অ্যাকাউন্ট তালিকার শেষ পয়েন্ট থেকে প্রতিক্রিয়ায় approved_clients অস্তিত্বের উপর নির্ভর করে ব্রাউজার সাইন-আপ এবং সাইন-ইন ব্যবহারের ক্ষেত্রে ভিন্নভাবে পরিচালনা করে। যদি ব্যবহারকারী ইতিমধ্যেই RP-তে সাইন আপ করে থাকেন তাহলে ব্রাউজারটি "এর সাথে চালিয়ে যাওয়ার জন্য ..." একটি প্রকাশের পাঠ্য প্রদর্শন করবে না।
providers সম্পত্তি IdentityProvider অবজেক্টের একটি অ্যারে নেয় যার নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

প্রদানকারী সম্পত্তি

providers সম্পত্তি IdentityProvider অবজেক্টের একটি অ্যারে নেয় যার নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

সম্পত্তি	বর্ণনা
`configURL` (প্রয়োজনীয়)	আইডিপি কনফিগারেশন ফাইলের একটি সম্পূর্ণ পথ।
`clientId` (প্রয়োজনীয়)	আইডিপি দ্বারা জারি করা RP-এর ক্লায়েন্ট শনাক্তকারী।
`nonce` (ঐচ্ছিক)	এই নির্দিষ্ট অনুরোধের জন্য প্রতিক্রিয়া জারি করা হয়েছে তা নিশ্চিত করার জন্য একটি র্যান্ডম স্ট্রিং। রিপ্লে আক্রমণ প্রতিরোধ করে।
`loginHint` (ঐচ্ছিক)	অ্যাকাউন্টের এন্ডপয়েন্ট দ্বারা প্রদত্ত `login_hints` মানগুলির একটি নির্দিষ্ট করে, FedCM ডায়ালগ বেছে বেছে নির্দিষ্ট অ্যাকাউন্ট দেখায়।
`domainHint` (ঐচ্ছিক)	অ্যাকাউন্টের এন্ডপয়েন্ট দ্বারা প্রদত্ত `domain_hints` মানগুলির একটি নির্দিষ্ট করে, FedCM ডায়ালগ বেছে বেছে নির্দিষ্ট অ্যাকাউন্ট দেখায়।
`mode` (ঐচ্ছিক)	স্ট্রিং যা FedCM এর UI মোড নির্দিষ্ট করে। এটি এই মানগুলির মধ্যে একটি হতে পারে: `"active"` : ফেডসিএম প্রম্পট অবশ্যই ব্যবহারকারীর ইন্টারঅ্যাকশন দ্বারা শুরু করা উচিত (যেমন একটি বোতাম ক্লিক করা)। `"passive"` : ফেডসিএম প্রম্পট সরাসরি ব্যবহারকারীর মিথস্ক্রিয়া ছাড়াই শুরু করা হবে। সক্রিয় এবং প্যাসিভ মোডগুলির মধ্যে পার্থক্য সম্পর্কে আরও জানতে ওভারভিউ পৃষ্ঠাটি দেখুন। দ্রষ্টব্য: `mode` প্যারামিটার ক্রোম 132 থেকে সমর্থিত।
`fields` (al চ্ছিক)	স্ট্রিংগুলির অ্যারে যা ব্যবহারকারীর তথ্য ("নাম", "ইমেল", "চিত্র") নির্দিষ্ট করে যা তাদের সাথে ভাগ করে নেওয়ার জন্য আরপির আইডিপি প্রয়োজন। দ্রষ্টব্য: ফিল্ড এপিআই ক্রোম 132 এবং পরে সমর্থিত।
`parameters` (ঐচ্ছিক)	কাস্টম অবজেক্ট যা অতিরিক্ত কী-মান পরামিতি নির্দিষ্ট করতে দেয়: `scope` : আরপি অনুরোধ করা দরকার এমন অতিরিক্ত অনুমতিগুলি সমন্বিত একটি স্ট্রিং মান, উদাহরণস্বরূপ `"drive.readonly calendar.readonly"` `nonce` : এই নির্দিষ্ট অনুরোধের জন্য প্রতিক্রিয়া জারি করা হয়েছে তা নিশ্চিত করার জন্য একটি এলোমেলো স্ট্রিং। রিপ্লে আক্রমণ প্রতিরোধ করে। অন্যান্য কাস্টম কী-মান পরামিতি। দ্রষ্টব্য: `parameters` ক্রোম 132 থেকে সমর্থিত।

সক্রিয় মোড

ফেডসিএম বিভিন্ন ইউএক্স মোড কনফিগারেশন সমর্থন করে। প্যাসিভ মোড হ'ল ডিফল্ট মোড, এবং বিকাশকারীদের এটি কনফিগার করার দরকার নেই।

সক্রিয় মোডে ফেডসিএম ব্যবহার করতে:

ব্যবহারকারীর ব্রাউজারে বৈশিষ্ট্য প্রাপ্যতা পরীক্ষা করুন।
একটি ক্ষণস্থায়ী ব্যবহারকারীর অঙ্গভঙ্গি দিয়ে এপিআইকে অনুরোধ করুন, যেমন একটি বোতাম ক্লিক করুন।
mode প্যারামিটারটি এপিআই কলটিতে পাস করুন:

  let supportsFedCmMode = false;
  try {
    navigator.credentials.get({
      identity: Object.defineProperty(
        // Check if this Chrome version supports the Mode API.
        {}, 'mode', {
          get: function () { supportsFedCmMode = true; }
        }
      )
    });
  } catch(e) {}

  if (supportsFedCmMode) {
    // The button mode is supported. Call the API with mode property:
    return await navigator.credentials.get({
      identity: {
        providers: [{
          configURL: 'https://idp.example/config.json',
          clientId: '123',
        }],
        // The 'mode' value defines the UX mode of FedCM.
        // - 'active': Must be initiated by user interaction (e.g., clicking a button).
        // - 'passive': Can be initiated without direct user interaction.
        mode: 'active'
      }
    });
  }

সক্রিয় মোডে কাস্টম আইকন

অ্যাক্টিভ মোড আইডিপিগুলিকে সরাসরি ক্লায়েন্ট মেটাডেটা এন্ডপয়েন্ট পয়েন্ট প্রতিক্রিয়াতে আরপির অফিসিয়াল লোগো আইকন অন্তর্ভুক্ত করার অনুমতি দেয়। আরপি অবশ্যই তাদের ব্র্যান্ডিং ডেটা অগ্রিম সরবরাহ করতে হবে।

ক্রস-অরিজিন ইফ্রেমের মধ্যে থেকে ফেডসিএম কল করুন

প্যারেন্ট ফ্রেম যদি এটির অনুমতি দেয় তবে ফেডসিএমকে একটি identity-credentials-get অনুমতি নীতি ব্যবহার করে ক্রস-উত্স আইফ্রেমের মধ্যে থেকে প্রার্থনা করা যেতে পারে। এটি করার জন্য, নিম্নলিখিত হিসাবে আইফ্রেম ট্যাগের জন্য allow="identity-credentials-get" বৈশিষ্ট্যটি সংযোজন করুন:

  <iframe src="https://fedcm-cross-origin-iframe.glitch.me" allow="identity-credentials-get"></iframe>

আপনি এটি একটি উদাহরণস্বরূপ কর্মে দেখতে পারেন।

Ally চ্ছিকভাবে, যদি প্যারেন্ট ফ্রেম ফেডসিএমকে কল করতে উত্সকে সীমাবদ্ধ করতে চায় তবে অনুমোদিত উত্সের একটি তালিকা সহ একটি Permissions-Policy শিরোনাম প্রেরণ করুন।

  Permissions-Policy: identity-credentials-get=(self "https://fedcm-cross-origin-iframe.glitch.me")

অনুমতি নীতি সহ ব্রাউজার বৈশিষ্ট্যগুলি নিয়ন্ত্রণে অনুমতি নীতি কীভাবে কাজ করে সে সম্পর্কে আপনি আরও জানতে পারেন।

লগইন ইঙ্গিতটি ব্যবহার করে, আরপি সুপারিশ করতে পারে যে কোনও ব্যবহারকারীর সাথে সাইন ইন করা উচিত। এটি ব্যবহারকারীদের পুনরায় প্রমাণীকরণের জন্য সহায়ক হতে পারে যারা নিশ্চিত না যে তারা কোন অ্যাকাউন্টটি আগে ব্যবহার করেছে।

আরপিএস নির্বাচন করে navigator.credentials.get() loginHint সম্পত্তি সহ login_hints মানগুলির সাথে অ্যাকাউন্টের তালিকা শেষ পয়েন্ট থেকে প্রাপ্ত একটি নির্দিষ্ট অ্যাকাউন্ট প্রদর্শন করতে পারে, নিম্নলিখিত কোড নমুনায় দেখানো হয়েছে:

  return await navigator.credentials.get({
    identity: {
      providers: [{
        configURL: 'https://idp.example/manifest.json',
        clientId: '123',
        // Accounts endpoint can specify a 'login_hints' array for an account.
        // When RP specifies a 'exampleHint' value, only those accounts will be
        // shown to the user whose 'login_hints' array contains the 'exampleHint'
        // value
        loginHint : 'exampleHint'
      }]
    }
  });

যখন কোনও অ্যাকাউন্ট loginHint সাথে মেলে না, ফেডসিএম ডায়ালগটি একটি লগইন প্রম্পট দেখায়, যা ব্যবহারকারীকে আরপি দ্বারা অনুরোধ করা ইঙ্গিতের সাথে মেলে একটি আইডিপি অ্যাকাউন্টে লগইন করতে দেয়। যখন ব্যবহারকারী প্রম্পটে ট্যাপ করে, কনফিগারেশন ফাইলে নির্দিষ্ট করা লগইন ইউআরএল দিয়ে একটি পপআপ উইন্ডো খোলা হয়। লিঙ্কটি তারপরে লগইন ইঙ্গিত এবং ডোমেন ইঙ্গিত ক্যোয়ারী প্যারামিটারগুলির সাথে যুক্ত করা হয়।

ডোমেন ইঙ্গিত এপিআই

আরপিএস একটি নির্দিষ্ট ডোমেনের সাথে যুক্ত কেবলমাত্র অ্যাকাউন্টগুলি নির্বাচন করে প্রদর্শন করতে পারে। এটি কর্পোরেট ডোমেনের মধ্যে সীমাবদ্ধ আরপিএসের জন্য কার্যকর হতে পারে।

কেবলমাত্র নির্দিষ্ট ডোমেন অ্যাকাউন্টগুলি প্রদর্শন করতে, আরপিকে domainHint সম্পত্তি সহ domain_hints সম্পত্তি সহ navigator.credentials.get() কল করা উচিত, নিম্নলিখিত কোড নমুনায় দেখানো হয়েছে:

  return await navigator.credentials.get({
    identity: {
      providers: [{
        configURL: 'https://idp.example/manifest.json',
        clientId: 'abc',
        // Accounts endpoint can specify a 'domain_hints' array for an account.
        // When RP specifies a '@domain.example' value, only those accounts will be
        // shown to the user whose 'domain_hints' array contains the
        // '@domain.example' value
        domainHint : '@domain.example'
      }]
    }
  });

দ্রষ্টব্য: যখন domainHint: 'any' ব্যবহৃত হয়, ক্রোম এমন অ্যাকাউন্টগুলি ফিল্টার করে যার কোনও ডোমেন নেই (এটি domain_hints পাস হয় না বা খালি থাকে)। উদাহরণস্বরূপ, এটি এমন কেসগুলি ব্যবহারের অনুমতি দেয় যেখানে আরপি কেবল তার সাইনআপ প্রক্রিয়াতে পরিচালিত অ্যাকাউন্টগুলিকে অনুমতি দেয়।

যখন কোনও অ্যাকাউন্ট domainHint সাথে মেলে না, ফেডসিএম ডায়ালগটি একটি লগইন প্রম্পট দেখায়, যা ব্যবহারকারীকে আরপি দ্বারা অনুরোধ করা ইঙ্গিতের সাথে মেলে একটি আইডিপি অ্যাকাউন্টে লগইন করতে দেয়। যখন ব্যবহারকারী প্রম্পটে ট্যাপ করে, কনফিগারেশন ফাইলে নির্দিষ্ট করা লগইন ইউআরএল দিয়ে একটি পপআপ উইন্ডো খোলা হয়। লিঙ্কটি তারপরে লগইন ইঙ্গিত এবং ডোমেন ইঙ্গিত ক্যোয়ারী প্যারামিটারগুলির সাথে যুক্ত করা হয়।

কোনও অ্যাকাউন্ট ডোমেনহিন্টের সাথে মেলে না এমন উদাহরণ লগইন প্রম্পট। — কোনও অ্যাকাউন্ট `domainHint` সাথে মেলে না এমন উদাহরণ লগইন প্রম্পট।

কাস্টম পরামিতি

কাস্টম প্যারামিটার বৈশিষ্ট্যটি আরপিকে আইডি দৃ ser ়তা শেষ পয়েন্টে অতিরিক্ত কী-মান পরামিতি সরবরাহ করতে দেয়। প্যারামিটার এপিআইয়ের সাহায্যে, আরপিএস বেসিক সাইন-ইন ছাড়িয়ে সংস্থানগুলির জন্য অনুমতিগুলির জন্য অনুরোধ করতে আইডিপিতে অতিরিক্ত পরামিতিগুলি পাস করতে পারে। অতিরিক্ত পরামিতিগুলি পাস করা এই দৃশ্যে কার্যকর হতে পারে:

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

এপিআই ব্যবহার করতে, আরপি navigator.credentials.get() কল params

  let {token} = await navigator.credentials.get({
    identity: {
      providers: [{
        clientId: '1234',
        configURL: 'https://idp.example/fedcm.json',
        // Key/value pairs that need to be passed from the
        // RP to the IdP but that don't really play any role with
        // the browser.
        params: {
          IDP_SPECIFIC_PARAM: '1',
          foo: 'BAR'
        }
      },
    }
  });

ব্রাউজারটি স্বয়ংক্রিয়ভাবে এটি একক ইউআরএল-এনকোডেড জেএসএন-সিরিয়ালাইজড অবজেক্ট হিসাবে প্যারামিটার সহ আইডিপিতে একটি পোস্ট অনুরোধে অনুবাদ করবে:

  // The assertion endpoint is drawn from the config file
  POST /fedcm_assertion_endpoint HTTP/1.1
  Host: idp.example
  Origin: https://rp.example/
  Content-Type: application/x-www-form-urlencoded
  Cookie: 0x23223
  Sec-Fetch-Dest: webidentity

  // params are translated into urlencoded version of `{"IDP_SPECIFIC_PARAM":"1","foo":"bar"}`
  account_id=123&client_id=client1234&params=%22%7B%5C%22IDP_SPECIFIC_PARAM%5C%22%3A1%2C%5C%22foo%5C%22%3A%5C%22BAR%5C%22%7D%22.

যদি আরপির কোনও অতিরিক্ত অনুমতি প্রয়োজন হয় তবে আইডিপি একটি পুনঃনির্দেশ লিঙ্ক সরবরাহ করতে পারে। উদাহরণস্বরূপ, নোড.জেএসে:

  if (rpRequestsPermissions) {
    // Response with a URL if the RP requests additional permissions
    return res.json({
      continue_on: '/example-redirect',
    });
  }

ক্ষেত্র

আরপি ব্যবহারকারীর তথ্য নির্দিষ্ট করতে পারে (নাম, ইমেল ঠিকানা এবং প্রোফাইল ছবির কোনও সংমিশ্রণ) তাদের সাথে ভাগ করে নেওয়ার জন্য তাদের আইডিপি প্রয়োজন। অনুরোধ করা তথ্য ফেডসিএম ডায়ালগের প্রকাশ ইউআইতে অন্তর্ভুক্ত করা হবে। ব্যবহারকারী তাদের জানিয়ে একটি বার্তা দেখতে পাবে যে idp.example অনুরোধ করা তথ্যগুলি rp.example সাথে ভাগ করে নেবে যদি ব্যবহারকারী সাইন ইন করতে পছন্দ করেন।

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

ক্ষেত্রগুলি বৈশিষ্ট্যটি ব্যবহার করতে, আরপি -র navigator.credentials.get() কলগুলিতে একটি fields অ্যারে যুক্ত করা উচিত। ক্ষেত্রগুলিতে name , email এবং picture কোনও অনুপাত থাকতে পারে। ভবিষ্যতে আরও মান অন্তর্ভুক্ত করার জন্য এটি প্রসারিত করা যেতে পারে। fields সহ একটি অনুরোধ এটির মতো দেখতে হবে:

  let { token } = await navigator.credentials.get({
    identity: {
      providers: [{
        // RP requests the IdP to share only user email and profile picture
        fields: [ 'email', 'picture'],
        clientId: '1234',
        configURL: 'https://idp.example/fedcm.json',

      },
    }
  });

ব্রাউজারটি স্বয়ংক্রিয়ভাবে এটিকে এইচটিটিপি অনুরোধে আইডি দৃ ser ়তা শেষ পয়েন্টে অনুবাদ করবে যাতে আরপি-নির্দিষ্ট fields প্যারামিটার অন্তর্ভুক্ত রয়েছে, যে ক্ষেত্রগুলি ব্রাউজারটি ব্যবহারকারীকে একটি disclosure_shown_for প্যারামিটারে প্রকাশ করেছে। পিছনের সামঞ্জস্যের জন্য, ব্রাউজারটি প্রকাশের পাঠ্যটি প্রদর্শিত হয় এবং অনুরোধ করা ক্ষেত্রগুলিতে তিনটি ক্ষেত্র : 'name' , 'email' এবং 'picture' অন্তর্ভুক্ত থাকলে disclosure_text_shown=true প্রেরণ করবে।

  POST /id_assertion_endpoint HTTP/1.1
  Host: idp.example
  Origin: https://rp.example/
  Content-Type: application/x-www-form-urlencoded
  Cookie: 0x23223
  Sec-Fetch-Dest: webidentity

  // The RP only requested to share email and picture. The browser will send `disclosure_text_shown=false`, as the 'name' field value is missing
  account_id=123&client_id=client1234&disclosure_text_shown=false&fields=email,picture&disclosure_shown_for=email,picture

fields যদি খালি অ্যারে হয় তবে ব্যবহারকারী এজেন্ট প্রকাশ ইউআই এড়িয়ে যাবে।

একটি ফেডসিএম প্যাসিভ মোড ডায়ালগ যা প্রকাশের ইউআই বার্তা প্রদর্শন করে না। — প্রকাশের বার্তা প্যাসিভ মোডে প্রদর্শিত হয় না। বোতাম প্রবাহে, প্রকাশের ইউআই পুরোপুরি এড়িয়ে যায়।

এটি কেস এমনকি যদি অ্যাকাউন্টগুলির শেষ পয়েন্টের প্রতিক্রিয়াটিতে কোনও ক্লায়েন্ট আইডি না থাকে যা approved_clients আরপির সাথে মেলে।

এই ক্ষেত্রে, এইচটিটিপি বডিটিতে আইডি দৃ ser ়তা শেষ পয়েন্টে প্রেরিত disclosure_text_shown মিথ্যা:

  POST /id_assertion_endpoint HTTP/1.1
  Host: idp.example
  Origin: https://rp.example/
  Content-Type: application/x-www-form-urlencoded
  Cookie: 0x23223
  Sec-Fetch-Dest: webidentity

  account_id=123&client_id=client1234&nonce=234234&disclosure_text_shown=false

একটি ত্রুটি বার্তা দেখান

কখনও কখনও, আইডিপি বৈধ কারণে কোনও টোকেন জারি করতে সক্ষম না হতে পারে যেমন ক্লায়েন্ট যখন অননুমোদিত হয়, বা সার্ভার অস্থায়ীভাবে অনুপলব্ধ থাকে। যদি আইডিপি একটি "ত্রুটি" প্রতিক্রিয়া দেয় তবে আরপি এটি ধরতে পারে এবং ক্রোম আইডিপি দ্বারা সরবরাহিত ত্রুটি সম্পর্কিত তথ্য সহ ব্রাউজার ইউআইকে দেখিয়ে ব্যবহারকারীকে অবহিত করতে পারে।

ব্যবহারকারীর সাইন-ইন প্রচেষ্টা ব্যর্থ হওয়ার পরে ত্রুটি বার্তা দেখানো একটি ফেডসিএম ডায়ালগ। স্ট্রিংটি ত্রুটির ধরণের সাথে সম্পর্কিত।

  try {
    const cred = await navigator.credentials.get({
      identity: {
        providers: [
          {
            configURL: 'https://idp.example/manifest.json',
            clientId: '1234',
          },
        ],
      }
    });
  } catch (e) {
    const code = e.code;
    const url = e.url;
  }

প্রাথমিক প্রমাণীকরণের পরে ব্যবহারকারীরা অটো-রিমেন্টেক্টেট ব্যবহারকারীদের

FEDCM অটো-রিফেন্টিশন (সংক্ষেপে "অটো-রিটান") ব্যবহারকারীরা ফেডসিএম ব্যবহার করে তাদের প্রাথমিক প্রমাণীকরণের পরে ফিরে আসার পরে স্বয়ংক্রিয়ভাবে পুনরায় অনুমোদন দিতে পারে। এখানে "প্রাথমিক প্রমাণীকরণ" এর অর্থ হ'ল ব্যবহারকারী একই ব্রাউজারের উদাহরণে প্রথমবারের জন্য ফেডসিএমের সাইন-ইন ডায়ালগের "চালিয়ে যাওয়া ..." বোতামটি আলতো চাপিয়ে আরপির ওয়েবসাইটে একটি অ্যাকাউন্ট তৈরি করে বা সাইন করে।

ব্যবহারকারী ট্র্যাকিং প্রতিরোধের জন্য ফেডারেটেড অ্যাকাউন্ট তৈরি করার আগে সুস্পষ্ট ব্যবহারকারীর অভিজ্ঞতাটি বোধগম্য হয় (যা ফেডসিএমের অন্যতম প্রধান লক্ষ্য), ব্যবহারকারী একবারে যাওয়ার পরে এটি অযথা জটিল হয়: ব্যবহারকারী অনুমতি দেওয়ার পরে ব্যবহারকারী অনুমতি দেওয়ার অনুমতি দেওয়ার পরে অনুমতি দেওয়ার পরে অনুমতি দেওয়ার পরে আরপি এবং আইডিপির মধ্যে যোগাযোগ, তারা ইতিমধ্যে আগে থাকা কোনও কিছুর জন্য অন্য স্পষ্টত ব্যবহারকারীর নিশ্চিতকরণ কার্যকর করার জন্য কোনও গোপনীয়তা বা সুরক্ষা সুবিধা নেই স্বীকৃত

অটো-রিউটনের সাথে, ব্রাউজারটি navigator.credentials.get() কল করার সময় আপনি mediation জন্য নির্দিষ্ট করা বিকল্পের উপর নির্ভর করে তার আচরণ পরিবর্তন করে।

  const cred = await navigator.credentials.get({
    identity: {
      providers: [{
        configURL: 'https://idp.example/fedcm.json',
        clientId: '1234',
      }],
    },
    mediation: 'optional', // this is the default
  });

  // `isAutoSelected` is `true` if auto-reauthn was performed.
  const isAutoSelected = cred.isAutoSelected;

mediation শংসাপত্র পরিচালন এপিআইয়ের একটি সম্পত্তি , এটি পাসওয়ার্ড ক্রেডেন্টিয়াল এবং ফেডারেটেডক্রিডেনশিয়াল হিসাবে যেমন আচরণ করে তেমন আচরণ করে এবং এটি আংশিকভাবে পাবলিককেক্রিডেনশিয়াল দ্বারা সমর্থিত। সম্পত্তি নিম্নলিখিত চারটি মান গ্রহণ করে:

'optional' (ডিফল্ট): স্বয়ংক্রিয়ভাবে পুনরায় অনুমোদন যদি সম্ভব হয় তবে যদি না হয় তবে মধ্যস্থতা প্রয়োজন। আমরা সাইন-ইন পৃষ্ঠায় এই বিকল্পটি বেছে নেওয়ার পরামর্শ দিই।
'required' : সর্বদা এগিয়ে যাওয়ার জন্য একটি মধ্যস্থতা প্রয়োজন, উদাহরণস্বরূপ, ইউআইতে "চালিয়ে যান" বোতামটি ক্লিক করা। যদি আপনার ব্যবহারকারীরা প্রতিবার প্রমাণীকরণের প্রয়োজন হয় তবে আপনার ব্যবহারকারীরা স্পষ্টভাবে অনুমতি প্রদান করবেন বলে এই বিকল্পটি চয়ন করুন।
'silent' : স্বয়ংক্রিয়ভাবে পুনরায় অনুমোদন যদি সম্ভব হয় তবে নিঃশব্দে কোনও মধ্যস্থতার প্রয়োজন ছাড়াই ব্যর্থ হন। আমরা ডেডিকেটেড সাইন-ইন পৃষ্ঠা ব্যতীত অন্য পৃষ্ঠাগুলিতে এই বিকল্পটি বেছে নেওয়ার পরামর্শ দিই তবে যেখানে আপনি ব্যবহারকারীদের স্বাক্ষর রাখতে চান-উদাহরণস্বরূপ, শিপিং ওয়েবসাইটে একটি আইটেম পৃষ্ঠা বা কোনও নিউজ ওয়েবসাইটে একটি নিবন্ধ পৃষ্ঠা।
'conditional' : ওয়েবআউথনের জন্য ব্যবহৃত এবং এই মুহুর্তে ফেডসিএমের জন্য উপলভ্য নয়।

এই কল দিয়ে, স্বতঃ-পুনরায় সংযুক্তি নিম্নলিখিত শর্তে ঘটে:

ফেডসিএম ব্যবহারের জন্য উপলব্ধ। উদাহরণস্বরূপ, ব্যবহারকারী বিশ্বব্যাপী বা সেটিংসে আরপির জন্য ফেডসিএম অক্ষম করেনি।
ব্যবহারকারী এই ব্রাউজারে ওয়েবসাইটে সাইন করতে ফেডসিএম এপিআইয়ের সাথে কেবল একটি অ্যাকাউন্ট ব্যবহার করেছিলেন।
ব্যবহারকারী সেই অ্যাকাউন্টের সাথে আইডিপিতে স্বাক্ষরিত হয়।
গত 10 মিনিটের মধ্যে অটো-রিউথান ঘটেনি।
আরপি পূর্ববর্তী সাইন ইন করার পরে navigator.credentials.preventSilentAccess() কল করেনি।

যখন এই শর্তগুলি পূরণ করা হয়, তখন ফেডসিএম navigator.credentials.get() এর সাথে সাথে ব্যবহারকারীকে স্বয়ংক্রিয়ভাবে পুনরায় অনুমোদনের চেষ্টা শুরু হয়।

যখন mediation: optional , কেবল ব্রাউজারই জানে এমন কারণে অটো-রিউটান অনুপলব্ধ হতে পারে; আরপি পরীক্ষা করতে পারে যে isAutoSelected সম্পত্তি পরীক্ষা করে অটো-রিউটন সম্পাদিত হয়েছে কিনা।

এটি এপিআই পারফরম্যান্স মূল্যায়ন করতে এবং সেই অনুযায়ী ইউএক্স উন্নত করতে সহায়ক। এছাড়াও, যখন এটি অনুপলব্ধ থাকে, তখন ব্যবহারকারীকে সুস্পষ্ট ব্যবহারকারী মধ্যস্থতার সাথে সাইন ইন করার জন্য অনুরোধ করা যেতে পারে, যা mediation: required ।

ফেডসিএমের মাধ্যমে একজন ব্যবহারকারী অটো-র-এথেন্টিকেটিং করছেন।

`preventSilentAccess()` সাথে মধ্যস্থতা প্রয়োগ করুন

সাইন আউট করার সাথে সাথে ব্যবহারকারীরা খুব ভাল ব্যবহারকারীর অভিজ্ঞতা অর্জন করতে পারে না তা অবিলম্বে অটো-রিমেন্টেটিং ব্যবহারকারীরা। এজন্য এই আচরণটি রোধ করার জন্য ফেডসিএমের একটি অটো-রিউটনের পরে 10 মিনিটের শান্ত সময় রয়েছে। এর অর্থ হ'ল ব্যবহারকারী 10 মিনিটের মধ্যে ফিরে স্বাক্ষর না করে প্রতি 10-মিনিটে একবারে অটো-রিউটন সর্বাধিক একবার ঘটে। আরপিকে navigator.credentials.preventSilentAccess() কল করা উচিত।

  function signout() {
    navigator.credentials.preventSilentAccess();
    location.href = '/signout';
  }

ব্যবহারকারীরা সেটিংসে অটো-রিউটন থেকে অপ্ট-আউট করতে পারেন

ব্যবহারকারীরা সেটিংস মেনু থেকে অটো-রিউথ থেকে অপ্ট-আউট করতে পারেন:

ডেস্কটপ ক্রোমে, chrome://password-manager/settings > স্বয়ংক্রিয়ভাবে সাইন ইন করুন।
অ্যান্ড্রয়েড ক্রোমে, ওপেন সেটিংস > পাসওয়ার্ড ম্যানেজার > উপরের ডানদিকে কোণে একটি কগে আলতো চাপুন> অটো সাইন-ইন করুন।

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

আরপি থেকে আইডিপি সংযোগ বিচ্ছিন্ন করুন

যদি কোনও ব্যবহারকারী আগে ফেডসিএমের মাধ্যমে আইডিপি ব্যবহার করে আরপিতে স্বাক্ষর করে থাকেন তবে সম্পর্কটি সংযুক্ত অ্যাকাউন্টগুলির তালিকা হিসাবে স্থানীয়ভাবে ব্রাউজারটি মুখস্থ করে। আরপি IdentityCredential.disconnect() ফাংশনটি অনুরোধ করে একটি সংযোগ বিচ্ছিন্ন করতে পারে। এই ফাংশনটি শীর্ষ স্তরের আরপি ফ্রেম থেকে কল করা যেতে পারে। আরপিকে একটি configURL পাস করতে হবে, আইডিপির অধীনে এটি ব্যবহার করা clientId এবং আইডিপি সংযোগ বিচ্ছিন্ন হওয়ার জন্য একটি accountHint । একটি অ্যাকাউন্টের ইঙ্গিতটি যতক্ষণ না সংযোগ বিচ্ছিন্ন শেষ পয়েন্টটি অ্যাকাউন্টটি সনাক্ত করতে পারে ততক্ষণ একটি স্বেচ্ছাসেবী স্ট্রিং হতে পারে, উদাহরণস্বরূপ কোনও ইমেল ঠিকানা বা ব্যবহারকারী আইডি যা অ্যাকাউন্টের তালিকার শেষ পয়েন্টটি সরবরাহ করেছে এমন অ্যাকাউন্ট আইডির সাথে মেলে না:

  // Disconnect an IdP account 'account456' from the RP 'https://idp.com/'. This is invoked on the RP domain.
  IdentityCredential.disconnect({
    configURL: 'https://idp.com/config.json',
    clientId: 'rp123',
    accountHint: 'account456'
  });

IdentityCredential.disconnect() একটি Promise দেয়। এই প্রতিশ্রুতি নিম্নলিখিত কারণগুলির জন্য একটি ব্যতিক্রম ছুঁড়ে ফেলতে পারে:

ফেডসিএমের মাধ্যমে আইডিপি ব্যবহার করে ব্যবহারকারী আরপিতে সাইন ইন করেননি।
এপিআই ফেডসিএম অনুমতি নীতি ব্যতীত আইফ্রেমের মধ্যে থেকে আহ্বান করা হয়।
কনফিগারেলটি অবৈধ বা সংযোগ বিচ্ছিন্ন শেষ পয়েন্টটি অনুপস্থিত।
সামগ্রী সুরক্ষা নীতি (সিএসপি) চেক ব্যর্থ হয়েছে।
একটি মুলতুবি সংযোগ বিচ্ছিন্ন অনুরোধ আছে।
ব্যবহারকারী ব্রাউজার সেটিংসে ফেডসিএম অক্ষম করেছেন।

যখন আইডিপির সংযোগ বিচ্ছিন্ন শেষ পয়েন্টটি কোনও প্রতিক্রিয়া দেয় , তখন আরপি এবং আইডিপি ব্রাউজারে সংযোগ বিচ্ছিন্ন হয়ে যায় এবং প্রতিশ্রুতিটি সমাধান করা হয়। সংযোগ বিচ্ছিন্ন অ্যাকাউন্টগুলির আইডি সংযোগ বিচ্ছিন্ন শেষ পয়েন্ট থেকে প্রতিক্রিয়াতে নির্দিষ্ট করা হয়।

FedCM এর সাথে একটি পরিচয় সমাধান প্রয়োগ করুন

একটি আইডিপি হিসাবে FedCM প্রয়োগ করুন

একটি সুপরিচিত ফাইল তৈরি করুন

একটি আইডিপি কনফিগারেশন ফাইল এবং শেষ পয়েন্ট তৈরি করুন

অন্য অ্যাকাউন্ট ব্যবহার করুন

অ্যাকাউন্টস এন্ডপয়েন্ট

আইডি দাবী শেষ পয়েন্ট

বৈশিষ্ট্য চালিয়ে যান

একটি ত্রুটি প্রতিক্রিয়া ফেরত দিন

কাস্টম অ্যাকাউন্ট লেবেল

এন্ডপয়েন্ট সংযোগ বিচ্ছিন্ন করুন

ক্লায়েন্ট মেটাডেটা শেষ পয়েন্ট

লগইন URL

ব্যবহারকারীর লগইন অবস্থা সম্পর্কে ব্রাউজারকে অবহিত করুন

একটি গতিশীল লগইন প্রবাহের মাধ্যমে ব্যবহারকারীকে সাইন ইন করতে দিন

RP হিসাবে FedCM প্রয়োগ করুন

প্রসঙ্গ সম্পত্তি

প্রদানকারী সম্পত্তি

সক্রিয় মোড

সক্রিয় মোডে কাস্টম আইকন

ক্রস-অরিজিন ইফ্রেমের মধ্যে থেকে ফেডসিএম কল করুন

লগইন ইঙ্গিত এপিআই

ডোমেন ইঙ্গিত এপিআই

কাস্টম পরামিতি

ক্ষেত্র

একটি ত্রুটি বার্তা দেখান

প্রাথমিক প্রমাণীকরণের পরে ব্যবহারকারীরা অটো-রিমেন্টেক্টেট ব্যবহারকারীদের

preventSilentAccess() সাথে মধ্যস্থতা প্রয়োগ করুন

ব্যবহারকারীরা সেটিংসে অটো-রিউটন থেকে অপ্ট-আউট করতে পারেন

আরপি থেকে আইডিপি সংযোগ বিচ্ছিন্ন করুন

`preventSilentAccess()` সাথে মধ্যস্থতা প্রয়োগ করুন