OAuth এর সাথে Google অ্যাকাউন্ট লিঙ্ক করা

শিল্প-মানসম্মত OAuth 2.0 অনুমোদন কোড প্রবাহ ব্যবহার করে অ্যাকাউন্টগুলো সংযুক্ত করা হয়।

এজেন্টদের জন্য OAuth 2.1 এবং PKCE

স্টেটলেস এআই এজেন্ট এবং মাল্টি-মোডাল পাইপলাইনের জন্য OAuth 2.1 প্রয়োগের সুপারিশ করা হয়।

• PKCE (প্রুফ কী ফর কোড এক্সচেঞ্জ) : অনুমোদন কোডের প্রবাহ সুরক্ষিত করতে এবং আড়িপাতার আক্রমণ প্রতিরোধ করতে এটি অবশ্যই ব্যবহার করতে হবে।
• কোনো অন্তর্নিহিত প্রবাহ নেই : অন্তর্নিহিত প্রবাহ URL-এ অ্যাক্সেস টোকেন প্রকাশ করে, যা এজেন্ট পরিবেশের জন্য একটি নিরাপত্তা ঝুঁকি।

আপনার পরিষেবাতে অবশ্যই OAuth 2.0/2.1 অনুবর্তী অনুমোদন এবং টোকেন বিনিময় এন্ডপয়েন্ট সমর্থন থাকতে হবে।

প্রকল্পটি তৈরি করুন

অ্যাকাউন্ট লিঙ্কিং ব্যবহার করার জন্য আপনার প্রজেক্ট তৈরি করতে:

1. গুগল এপিআই কনসোলে যান।
2. প্রজেক্ট তৈরি করুন -এ ক্লিক করুন।
3. একটি নাম লিখুন অথবা তৈরি হওয়া পরামর্শটি গ্রহণ করুন।
4. অবশিষ্ট ক্ষেত্রগুলি নিশ্চিত করুন বা সম্পাদনা করুন।
5. তৈরি করুন- এ ক্লিক করুন।

আপনার প্রজেক্ট আইডি দেখতে:

1. গুগল এপিআই কনসোলে যান।
2. ল্যান্ডিং পেজের টেবিলে আপনার প্রজেক্টটি খুঁজুন। প্রজেক্ট আইডিটি ' ID' কলামে দেখা যাবে।

আপনার OAuth সম্মতি স্ক্রিন কনফিগার করুন

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

1. গুগল এপিআই কনসোলের OAuth সম্মতি স্ক্রিন পৃষ্ঠাটি খুলুন।
2. অনুরোধ করা হলে, আপনার এইমাত্র তৈরি করা প্রজেক্টটি নির্বাচন করুন।

3. "OAuth সম্মতি স্ক্রিন" পৃষ্ঠায়, ফর্মটি পূরণ করুন এবং "সংরক্ষণ করুন" বোতামে ক্লিক করুন।

   অ্যাপ্লিকেশনের নাম: যে অ্যাপ্লিকেশনটি সম্মতি চাইছে তার নাম। নামটি আপনার অ্যাপ্লিকেশনকে সঠিকভাবে প্রতিফলিত করবে এবং ব্যবহারকারীরা অন্যত্র যে অ্যাপ্লিকেশনের নাম দেখেন তার সাথে সামঞ্জস্যপূর্ণ হবে। অ্যাকাউন্ট লিঙ্কিং সম্মতি স্ক্রিনে অ্যাপ্লিকেশনের নামটি দেখানো হবে।

   অ্যাপ্লিকেশন লোগো: সম্মতি স্ক্রিনের একটি ছবি যা ব্যবহারকারীদের আপনার অ্যাপটি চিনতে সাহায্য করবে। লোগোটি অ্যাকাউন্ট লিঙ্কিং সম্মতি স্ক্রিনে এবং অ্যাকাউন্ট সেটিংসে দেখানো হয়।

   সহায়তা ইমেল: ব্যবহারকারীরা তাদের সম্মতি সংক্রান্ত প্রশ্ন নিয়ে আপনার সাথে যোগাযোগ করতে পারেন।

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

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

   অ্যাপ্লিকেশন হোমপেজ লিঙ্ক: আপনার অ্যাপ্লিকেশনের হোম পেজ। এটি অবশ্যই একটি অনুমোদিত ডোমেইনে হোস্ট করা থাকতে হবে।

   অ্যাপ্লিকেশন গোপনীয়তা নীতি লিঙ্ক: গুগল অ্যাকাউন্ট লিঙ্ক করার সম্মতি স্ক্রিনে দেখানো হয়। অবশ্যই একটি অনুমোদিত ডোমেইনে হোস্ট করা থাকতে হবে।

   অ্যাপ্লিকেশন পরিষেবার শর্তাবলীর লিঙ্ক (ঐচ্ছিক): অবশ্যই একটি অনুমোদিত ডোমেইনে হোস্ট করতে হবে।

   

   চিত্র ১। Tunery নামক একটি কাল্পনিক অ্যাপ্লিকেশনের গুগল অ্যাকাউন্ট লিঙ্ক করার সম্মতি স্ক্রিন।

4. 'ভেরিফিকেশন স্ট্যাটাস' দেখুন, যদি আপনার অ্যাপ্লিকেশনটির ভেরিফিকেশনের প্রয়োজন হয়, তাহলে ভেরিফিকেশনের জন্য আপনার অ্যাপ্লিকেশনটি জমা দিতে 'সাবমিট ফর ভেরিফিকেশন' বোতামে ক্লিক করুন। বিস্তারিত জানার জন্য OAuth ভেরিফিকেশনের প্রয়োজনীয়তাগুলো দেখুন।

আপনার OAuth সার্ভার বাস্তবায়ন করুন

অথরাইজেশন কোড ফ্লো-এর একটি OAuth 2.0 সার্ভার ইমপ্লিমেন্টেশনে দুটি এন্ডপয়েন্ট থাকে, যা আপনার সার্ভিস HTTPS-এর মাধ্যমে উপলব্ধ করে। প্রথম এন্ডপয়েন্টটি হলো অথরাইজেশন এন্ডপয়েন্ট, যা ডেটা অ্যাক্সেসের জন্য ব্যবহারকারীদের কাছ থেকে সম্মতি খোঁজা বা সংগ্রহ করার দায়িত্বে থাকে। যে সকল ব্যবহারকারী আগে থেকে সাইন-ইন করেননি, অথরাইজেশন এন্ডপয়েন্ট তাদের সামনে একটি সাইন-ইন UI উপস্থাপন করে এবং অনুরোধ করা অ্যাক্সেসের জন্য সম্মতি রেকর্ড করে। দ্বিতীয় এন্ডপয়েন্টটি হলো টোকেন এক্সচেঞ্জ এন্ডপয়েন্ট, যা টোকেন নামক এনক্রিপ্টেড স্ট্রিং সংগ্রহ করতে ব্যবহৃত হয়, যা একজন ব্যবহারকারীকে আপনার সার্ভিস অ্যাক্সেস করার অনুমোদন দেয়।

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

গুগল অ্যাকাউন্ট লিঙ্কিং: OAuth অনুমোদন কোড প্রবাহ

নিম্নলিখিত সিকোয়েন্স ডায়াগ্রামটি ব্যবহারকারী, গুগল এবং আপনার পরিষেবার এন্ডপয়েন্টগুলির মধ্যেকার মিথস্ক্রিয়া বিশদভাবে বর্ণনা করে।

ভূমিকা ও দায়িত্ব

নিম্নলিখিত সারণীটি গুগল অ্যাকাউন্ট লিঙ্কিং (GAL) OAuth ফ্লো-তে অংশগ্রহণকারীদের ভূমিকা ও দায়িত্ব সংজ্ঞায়িত করে। উল্লেখ্য যে, GAL-এ গুগল OAuth ক্লায়েন্ট হিসেবে কাজ করে, অপরদিকে আপনার পরিষেবাটি আইডেন্টিটি/সার্ভিস প্রোভাইডার হিসেবে কাজ করে।

গুগল দ্বারা শুরু করা একটি OAuth 2.0 অনুমোদন কোড ফ্লো সেশনের প্রবাহটি নিম্নরূপ:

1. গুগল ব্যবহারকারীর ব্রাউজারে আপনার অথরাইজেশন এন্ডপয়েন্টটি খোলে। যদি কোনো অ্যাকশনের জন্য ফ্লোটি শুধুমাত্র ভয়েস-ভিত্তিক কোনো ডিভাইসে শুরু হয়ে থাকে, তাহলে গুগল সেটির এক্সিকিউশন একটি ফোনে স্থানান্তর করে।
2. ব্যবহারকারী আগে থেকে সাইন ইন করা না থাকলে সাইন ইন করেন এবং আগে থেকে অনুমতি না দিয়ে থাকলে আপনার এপিআই (API) ব্যবহার করে তাদের ডেটা অ্যাক্সেস করার জন্য গুগলকে অনুমতি দেন।
3. আপনার পরিষেবা একটি অনুমোদন কোড তৈরি করে এবং সেটি গুগলে ফেরত পাঠায়। এটি করার জন্য, অনুরোধের সাথে অনুমোদন কোডটি সংযুক্ত করে ব্যবহারকারীর ব্রাউজারকে আবার গুগলে পুনঃনির্দেশিত করুন।
4. গুগল আপনার টোকেন এক্সচেঞ্জ এন্ডপয়েন্টে অথরাইজেশন কোডটি পাঠায়, যা কোডটির সত্যতা যাচাই করে একটি অ্যাক্সেস টোকেন এবং একটি রিফ্রেশ টোকেন ফেরত দেয়। অ্যাক্সেস টোকেন হলো একটি স্বল্পস্থায়ী টোকেন, যা আপনার পরিষেবা এপিআই (API) অ্যাক্সেস করার জন্য ক্রেডেনশিয়াল হিসেবে গ্রহণ করে। রিফ্রেশ টোকেন হলো একটি দীর্ঘস্থায়ী টোকেন, যা গুগল সংরক্ষণ করতে পারে এবং মেয়াদ শেষ হয়ে গেলে নতুন অ্যাক্সেস টোকেন সংগ্রহ করতে ব্যবহার করতে পারে।
5. ব্যবহারকারী অ্যাকাউন্ট লিঙ্ক করার প্রক্রিয়াটি সম্পন্ন করার পর, গুগল থেকে পাঠানো পরবর্তী প্রতিটি অনুরোধে একটি অ্যাক্সেস টোকেন থাকে।

বাস্তবায়ন রেসিপি

অথরাইজেশন কোড ফ্লো বাস্তবায়ন করতে এই ধাপগুলো অনুসরণ করুন।

ধাপ ১: অনুমোদনের অনুরোধগুলো পরিচালনা করুন

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

অনুরোধটি পরিচালনা করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:

1. অনুরোধটি যাচাই করুন :

   • নিশ্চিত করুন যে client_id টি Google-কে বরাদ্দ করা Client ID-র সাথে মেলে।
   • নিশ্চিত করুন যে redirect_uri প্রত্যাশিত Google রিডাইরেক্ট URL-এর সাথে মেলে:
     • Prod: https://oauth-redirect.googleusercontent.com/r/YOUR_PROJECT_ID
     • স্যান্ডবক্স: https://oauth-redirect-sandbox.googleusercontent.com/r/YOUR_PROJECT_ID
   • যাচাই করুন যে response_type হলো code ।

2. ব্যবহারকারীকে প্রমাণীকরণ করুন :

   • ব্যবহারকারী আপনার পরিষেবাতে সাইন ইন করেছেন কিনা তা যাচাই করুন।
   • যদি ব্যবহারকারী সাইন ইন করা না থাকেন, তাহলে তাকে আপনার সাইন-ইন বা সাইন-আপ প্রক্রিয়াটি সম্পন্ন করতে বলুন।

3. অনুমোদন কোড তৈরি করুন :

   • ব্যবহারকারী এবং ক্লায়েন্টের সাথে যুক্ত একটি অনন্য ও অনুমান-অযোগ্য অনুমোদন কোড তৈরি করুন।
   • কোডটির মেয়াদ আনুমানিক ১০ মিনিটে শেষ হওয়ার জন্য সেট করুন।

4. Google-এ ফেরত পাঠান :

   • ব্রাউজারকে redirect_uri তে দেওয়া URL-এ রিডাইরেক্ট করুন।
   • নিম্নলিখিত কোয়েরি প্যারামিটারগুলো যুক্ত করুন:
     • code : আপনার তৈরি করা অনুমোদন কোড।
     • state : গুগল থেকে প্রাপ্ত অপরিবর্তিত অবস্থার মান।

ধাপ ২: টোকেন বিনিময়ের অনুরোধগুলো পরিচালনা করুন

আপনার টোকেন এক্সচেঞ্জ এন্ডপয়েন্ট দুই ধরনের অনুরোধ প্রক্রিয়া করে: কোডের বিনিময়ে টোকেন গ্রহণ, এবং মেয়াদোত্তীর্ণ অ্যাক্সেস টোকেন নবায়ন। বিস্তারিত প্রোটোকল চুক্তি এবং প্যারামিটারের প্রয়োজনীয়তার জন্য, টোকেন এক্সচেঞ্জ এন্ডপয়েন্ট দেখুন।

এ. টোকেনের জন্য অনুমোদন কোড বিনিময় করুন

যখন গুগল অনুমোদন কোডটি পায়, তখন টোকেনগুলো সংগ্রহ করার জন্য এটি আপনার টোকেন এক্সচেঞ্জ এন্ডপয়েন্টে (POST) কল করে।

1. অনুরোধটি যাচাই করুন :

   • client_id এবং client_secret যাচাই করুন।
   • অনুমোদন কোডটি বৈধ এবং মেয়াদোত্তীর্ণ নয় তা যাচাই করুন।
   • নিশ্চিত করুন redirect_uri ধাপ ১-এ ব্যবহৃত মানের সাথে মেলে।
   • যাচাইকরণ ব্যর্থ হলে, {"error": "invalid_grant"} সহ একটি HTTP 400 Bad Request ফেরত দিন।

2. টোকেন ইস্যু করুন :

   • একটি দীর্ঘস্থায়ী refresh_token এবং একটি স্বল্পমেয়াদী access_token (সাধারণত ১ ঘণ্টা) তৈরি করুন।
   • স্ট্যান্ডার্ড JSON টোকেন প্রতিক্রিয়া সহ একটি HTTP 200 OK ফেরত দিন।

খ. অ্যাক্সেস টোকেন রিফ্রেশ করুন

অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, গুগল রিফ্রেশ টোকেন ব্যবহার করে একটি নতুন টোকেনের জন্য অনুরোধ করে।

1. অনুরোধটি যাচাই করুন :

   • client_id , client_secret এবং refresh_token যাচাই করুন।
   • যাচাইকরণ ব্যর্থ হলে, {"error": "invalid_grant"} সহ একটি HTTP 400 Bad Request ফেরত দিন।

2. নতুন অ্যাক্সেস টোকেন ইস্যু করুন :

   • একটি নতুন স্বল্পস্থায়ী access_token তৈরি করুন।
   • JSON টোকেন প্রতিক্রিয়া সহ একটি HTTP 200 OK ফেরত দিন (ঐচ্ছিকভাবে একটি নতুন রিফ্রেশ টোকেন অন্তর্ভুক্ত করে)।

ব্যবহারকারীর তথ্যের অনুরোধগুলি পরিচালনা করুন

ইউজারইনফো এন্ডপয়েন্ট হল একটি OAuth 2.0 সুরক্ষিত রিসোর্স যা লিঙ্ক করা ব্যবহারকারীর বিষয়ে দাবি ফেরত দেয়। ইউজার ইনফো এন্ডপয়েন্ট বাস্তবায়ন এবং হোস্ট করা ঐচ্ছিক, নিম্নলিখিত ব্যবহারের ক্ষেত্রে ছাড়া:

• Google One ট্যাপের মাধ্যমে লিঙ্ক করা অ্যাকাউন্টে সাইন-ইন করুন ।
• AndroidTV-তে ঘর্ষণহীন সাবস্ক্রিপশন ।

আপনার টোকেন এন্ডপয়েন্ট থেকে অ্যাক্সেস টোকেন সফলভাবে পুনরুদ্ধার করার পরে, Google লিঙ্ক করা ব্যবহারকারীর সম্পর্কে প্রাথমিক প্রোফাইল তথ্য পুনরুদ্ধার করার জন্য আপনার ব্যবহারকারীর তথ্য এন্ডপয়েন্টে একটি অনুরোধ পাঠায়।

উদাহরণস্বরূপ, যদি আপনার ব্যবহারকারীর তথ্যের এন্ডপয়েন্ট https://myservice.example.com/userinfo এ উপলব্ধ থাকে, তাহলে একটি অনুরোধ নিম্নলিখিতটির মতো দেখতে পারে:

GET /userinfo HTTP/1.1
Host: myservice.example.com
Authorization: Bearer ACCESS_TOKEN

অনুরোধগুলি পরিচালনা করার জন্য আপনার ব্যবহারকারীর তথ্যের শেষ পয়েন্টের জন্য, নিম্নলিখিত পদক্ষেপগুলি করুন:

1. অনুমোদন শিরোনাম থেকে অ্যাক্সেস টোকেন বের করুন এবং অ্যাক্সেস টোকেনের সাথে যুক্ত ব্যবহারকারীর জন্য তথ্য ফেরত দিন।
2. অ্যাক্সেস টোকেনটি অবৈধ হলে, WWW-Authenticate প্রতিক্রিয়া শিরোনাম ব্যবহার করে একটি HTTP 401 অননুমোদিত ত্রুটি ফেরত দিন। নীচে একটি ব্যবহারকারীর তথ্য ত্রুটি প্রতিক্রিয়ার একটি উদাহরণ:

   HTTP/1.1 401 Unauthorized
   WWW-Authenticate: error="invalid_token",
   error_description="The Access Token expired"
   

   লিঙ্কিং প্রক্রিয়া চলাকালীন যদি একটি 401 অননুমোদিত, বা অন্য কোনো অসফল ত্রুটির প্রতিক্রিয়া ফেরত দেওয়া হয়, তবে ত্রুটিটি পুনরুদ্ধারযোগ্য হবে না, পুনরুদ্ধার করা টোকেন বাতিল করা হবে এবং ব্যবহারকারীকে আবার লিঙ্কিং প্রক্রিয়া শুরু করতে হবে।

3. অ্যাক্সেস টোকেনটি বৈধ হলে, HTTPS প্রতিক্রিয়ার বডিতে নিম্নলিখিত JSON অবজেক্টের সাথে HTTP 200 প্রতিক্রিয়া ফেরত দিন:

   {
   "sub": "USER_UUID",
   "email": "EMAIL_ADDRESS",
   "given_name": "FIRST_NAME",
   "family_name": "LAST_NAME",
   "name": "FULL_NAME",
   "picture": "PROFILE_PICTURE",
   }

   যদি আপনার ব্যবহারকারীর তথ্য এন্ডপয়েন্ট একটি HTTP 200 সাফল্যের প্রতিক্রিয়া প্রদান করে, তবে পুনরুদ্ধার করা টোকেন এবং দাবিগুলি ব্যবহারকারীর Google অ্যাকাউন্টের বিরুদ্ধে নিবন্ধিত হয়।

   ব্যবহারকারীর তথ্য শেষ পয়েন্ট প্রতিক্রিয়া
   sub	একটি অনন্য আইডি যা আপনার সিস্টেমে ব্যবহারকারীকে শনাক্ত করে।
   email	ব্যবহারকারীর ইমেল ঠিকানা।
   given_name	ঐচ্ছিক: ব্যবহারকারীর প্রথম নাম।
   family_name	ঐচ্ছিক: ব্যবহারকারীর শেষ নাম।
   name	ঐচ্ছিক: ব্যবহারকারীর পুরো নাম।
   picture	ঐচ্ছিক: ব্যবহারকারীর প্রোফাইল ছবি।

আপনার বাস্তবায়ন যাচাই করা

You can validate your implementation by using the OAuth 2.0 Playground tool.

In the tool, do the following steps:

1. Click Configuration settings to open the OAuth 2.0 Configuration window.
2. In the OAuth flow field, select Client-side.
3. In the OAuth Endpoints field, select Custom.
4. Specify your OAuth 2.0 endpoint and the client ID you assigned to Google in the corresponding fields.
5. In the Step 1 section, don't select any Google scopes. Instead, leave this field blank or type a scope valid for your server (or an arbitrary string if you don't use OAuth scopes). When you're done, click Authorize APIs.
6. In the Step 2 and Step 3 sections, go through the OAuth 2.0 flow and verify that each step works as intended.

You can validate your implementation by using the Google Account Linking Demo tool.

In the tool, do the following steps:

1. Click the Sign in with Google button.
2. Choose the account you'd like to link.
3. Enter the service ID.
4. Optionally enter one or more scopes that you will request access for.
5. Click Start Demo.
6. When prompted, confirm that you may consent and deny the linking request.
7. Confirm that you are redirected to your platform.