সার্ভার থেকে সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার করা

Google OAuth 2.0 সিস্টেম সার্ভার-টু-সার্ভার ইন্টার‍্যাকশন সমর্থন করে, যেমন একটি ওয়েব অ্যাপ্লিকেশন এবং একটি Google পরিষেবার মধ্যে। এই পরিস্থিতিতে আপনার একটি পরিষেবা অ্যাকাউন্ট প্রয়োজন, যা এমন একটি অ্যাকাউন্ট যা কোনও ব্যক্তিগত ব্যবহারকারীর পরিবর্তে আপনার অ্যাপ্লিকেশনের অন্তর্গত। আপনার অ্যাপ্লিকেশন পরিষেবা অ্যাকাউন্টের হয়ে Google API কল করে, তাই ব্যবহারকারীরা সরাসরি যুক্ত থাকেন না। এই পরিস্থিতিকে কখনও কখনও "টু-লেগড OAuth" বা "2LO" বলা হয়। (সম্পর্কিত শব্দ "থ্রি-লেগড OAuth" এমন পরিস্থিতিকে বোঝায় যেখানে আপনার অ্যাপ্লিকেশন ব্যবহারকারীর হয়ে Google API কল করে এবং যেখানে কখনও কখনও ব্যবহারকারীর সম্মতি প্রয়োজন হয়।)

আরও তথ্যের জন্য পরিষেবা অ্যাকাউন্টের জন্য পেশাদার পদ্ধতি দেখুন।

সাধারণত, কোনও অ্যাপ্লিকেশন যখন ব্যবহারকারীর ডেটার পরিবর্তে নিজের ডেটা নিয়ে কাজ করার জন্য Google API ব্যবহার করে, তখন সেটি একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে। যেমন, ডেটা পারসিস্টেন্সের জন্য Google Cloud Datastore ব্যবহার করে এমন অ্যাপ্লিকেশন, Google Cloud Datastore API-তে করা কল যাচাই করার জন্য পরিষেবা অ্যাকাউন্ট ব্যবহার করবে।

এছাড়াও, Google Workspace ডোমেন অ্যাডমিনিস্ট্রেটররা পরিষেবা অ্যাকাউন্টকে ডোমেন-ব্যাপী কর্তৃত্ব প্রদান করতে পারেন যাতে ডোমেনের ব্যবহারকারীদের হয়ে তাদের ডেটা অ্যাক্সেস করা যায়।

এই ডকুমেন্ট বর্ণনা করে যে কীভাবে একটি অ্যাপ্লিকেশন Google APIs ক্লায়েন্ট লাইব্রেরি (সাজেস্ট করা) অথবা HTTP ব্যবহার করে সার্ভার-টু-সার্ভার OAuth 2.0 ফ্লো সম্পূর্ণ করতে পারে।

এক নজরে

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

তারপর, আপনার অ্যাপ্লিকেশন OAuth 2.0 অথ সার্ভার থেকে অ্যাক্সেস টোকেনের অনুরোধ করার জন্য পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করে অনুমোদিত API কল করার প্রস্তুতি নেয়।

শেষে, আপনার অ্যাপ্লিকেশন Google API কল করার জন্য অ্যাক্সেস টোকেন ব্যবহার করতে পারবে।

পরিষেবার অ্যাকাউন্ট তৈরি করা

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

আপনার অ্যাপ্লিকেশন Google App Engine-এ রান করলে, আপনি প্রোজেক্ট তৈরি করার সময় একটি পরিষেবা অ্যাকাউন্ট অটোমেটিক সেট-আপ হয়ে যায়।

আপনার অ্যাপ্লিকেশন Google Compute Engine-এ রান করলে, আপনার প্রোজেক্ট তৈরি করার সময় একটি পরিষেবা অ্যাকাউন্টও অটোমেটিক সেট-আপ হয়ে যায়, তবে আপনি Google Compute Engine ইনস্ট্যান্স তৈরি করার সময় আপনার অ্যাপ্লিকেশনকে যে স্কোপে অ্যাক্সেস দিতে চান তা উল্লেখ করতে হবে। আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট ব্যবহার করার জন্য ইনস্ট্যান্স প্রস্তুত করা দেখুন।

আপনার অ্যাপ্লিকেশন Google App Engine বা Google Compute Engine-এ না চললে, আপনাকে Google API Console থেকে এইসব ক্রেডেনশিয়াল পেতে হবে। পরিষেবা-অ্যাকাউন্ট ক্রেডেনশিয়াল তৈরি করতে অথবা আপনার আগে থেকে তৈরি করা সর্বজনীন ক্রেডেনশিয়াল দেখতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

প্রথমে, একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন:

  1. পরিষেবার অ্যাকাউন্ট-এর পৃষ্ঠা খুলুন।
  2. প্রম্পট করা হলে, কোনও প্রোজেক্ট বেছে নিন অথবা নতুন একটি তৈরি করুন।
  3.  পরিষেবা অ্যাকাউন্ট তৈরি করুন বিকল্পে ক্লিক করুন।
  4. পরিষেবা অ্যাকাউন্টের বিবরণ বিকল্পের অধীনে, পরিষেবা অ্যাকাউন্টের জন্য একটি নাম, আইডি এবং বিবরণ টাইপ করুন, তারপর তৈরি করুন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।
  5. ঐচ্ছিক: এই পরিষেবা অ্যাকাউন্টকে প্রোজেক্ট অ্যাক্সেস করার অনুমতি দিন বিকল্পের অধীনে, পরিষেবা অ্যাকাউন্টকে অনুমতি দেওয়ার জন্য IAM ভূমিকা বেছে নিন।
  6. চালিয়ে যান বিকল্পে ক্লিক করুন।
  7. ঐচ্ছিক: এই পরিষেবা অ্যাকাউন্টে ব্যবহারকারীদের অ্যাক্সেস দিন বিকল্পের অধীনে, সেইসব ব্যবহারকারী বা গ্রুপ যোগ করুন যাদের পরিষেবা অ্যাকাউন্ট ব্যবহার ও ম্যানেজ করার অনুমতি আছে।
  8. হয়ে গেছে বিকল্পে ক্লিক করুন।

এরপর, পরিষেবা অ্যাকাউন্টের কী তৈরি করুন:

  1. আপনার তৈরি করা পরিষেবা অ্যাকাউন্টের ইমেল আইডিতে ক্লিক করুন।
  2. কী ট্যাবে ক্লিক করুন।
  3. কী যোগ করুন ড্রপ-ডাউন তালিকা থেকে, নতুন কী তৈরি করুন বিকল্প বেছে নিন।
  4. তৈরি করুন বিকল্পে ক্লিক করুন।

আরও জানতে, সার্ভিস অ্যাকাউন্ট কী ম্যানেজ করার পেশাদার পদ্ধতি দেখুন।

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

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

পরিষেবা অ্যাকাউন্টে ডোমেন-ব্যাপী কর্তৃত্ব ডেলিগেট করুন

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

কোনও পরিষেবা অ্যাকাউন্টে ডোমেন-ব্যাপী কর্তৃত্ব ডেলিগেট করতে, Google Workspace ডোমেনের সুপার অ্যাডমিনিস্ট্রেটরকে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে হবে:

  1. আপনার Google Workspace ডোমেনের অ্যাডমিন কনসোল থেকে, প্রধান মেনু > নিরাপত্তা > অ্যাক্সেস ও ডেটা কন্ট্রোল > API কন্ট্রোল বিকল্পে যান।
  2. ডোমেন-ওয়াইড ডেলিগেশন প্যানে, ডোমেন-ওয়াইড ডেলিগেশন ম্যানেজ করুন বিকল্প বেছে নিন।
  3. নতুন যোগ করুন বিকল্পে ক্লিক করুন।
  4. ক্লায়েন্ট আইডি ফিল্ডে, পরিষেবা অ্যাকাউন্টের ক্লায়েন্ট আইডি লিখুন। আপনি পরিষেবা অ্যাকাউন্ট পৃষ্ঠা থেকে আপনার পরিষেবা অ্যাকাউন্টের ক্লায়েন্ট আইডি খুঁজে পাবেন।
  5. OAuth স্কোপ (কমা দিয়ে আলাদা করা) ফিল্ডে, আপনার অ্যাপ্লিকেশনকে যে স্কোপের অ্যাক্সেস দেওয়া উচিত তার তালিকা লিখুন। যেমন, আপনার অ্যাপ্লিকেশনের যদি Google Drive API এবং Google Calendar API-তে ডোমেন-জুড়ে সম্পূর্ণ অ্যাক্সেসের প্রয়োজন হয়, তাহলে লিখুন: https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/calendar।
  6. অনুমোদন করুন বিকল্পে ক্লিক করুন।

আপনার অ্যাপ্লিকেশনের কাছে এখন আপনার Workspace ডোমেনে ব্যবহারকারী হিসেবে API কল করার (ব্যবহারকারীদের "ছদ্মবেশ ধারণ" করতে) কর্তৃত্ব আছে। আপনি যখন এই ডেলিগেট করা API কল করার জন্য প্রস্তুত হন, তখন আপনি স্পষ্টভাবে ব্যবহারকারীকে ছদ্মবেশী করার জন্য নির্দিষ্ট করবেন।

ডেলিগেট করা API কল করুন

Google APIs ক্লায়েন্ট লাইব্রেরি ব্যবহার করে অথবা HTTP ব্যবহার করে OAuth 2.0 সিস্টেমের সাথে সরাসরি ইন্টার‍্যাক্ট করে কীভাবে অনুমোদিত API কল করতে হয় তা নিম্নলিখিত বিভাগে দেখানো হয়েছে।

Java

API Console থেকে ক্লায়েন্টের ইমেল আইডি ও ব্যক্তিগত কী পাওয়ার পরে, Java-র জন্য Google Auth লাইব্রেরি ব্যবহার করে পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল ও আপনার অ্যাপ্লিকেশনের অ্যাক্সেস প্রয়োজন এমন স্কোপ থেকে GoogleCredentials অবজেক্ট তৈরি করুন। যেমন:

import com.google.auth.oauth2.GoogleCredentials;
import com.google.api.services.sqladmin.SQLAdminScopes;

// ...

GoogleCredentials credentials = GoogleCredentials.fromStream(new FileInputStream("ServiceAccountKey.json"))
    .createScoped(Collections.singleton(SQLAdminScopes.SQLSERVICE_ADMIN));

আপনি Google Cloud-এ কোনও অ্যাপ ডেভেলপ করলে, এর পরিবর্তে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করতে পারেন, যা প্রসেসটিকে সহজ করে তুলতে পারে।

ডোমেন-ব্যাপী কর্তৃত্ব ডেলিগেট করুন

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

GoogleCredentials credentials = GoogleCredentials.fromStream(new FileInputStream("ServiceAccountKey.json"))
    .createScoped(Collections.singleton(SQLAdminScopes.SQLSERVICE_ADMIN))
    .createDelegated("workspace-user@example.com");

createDelegated() মেথড কল করার জন্য GoogleCredentials অবজেক্ট ব্যবহার করা হয়। createDelegated() পদ্ধতির আর্গুমেন্ট অবশ্যই এমন একজন ব্যবহারকারী হতে হবে যিনি আপনার Workspace অ্যাকাউন্টের সাথে যুক্ত। অনুরোধ করার জন্য আপনার কোড এই ক্রেডেনশিয়াল ব্যবহার করে আপনার পরিষেবা অ্যাকাউন্ট ব্যবহার করে Google API কল করবে।

Python

API Console থেকে ক্লায়েন্ট ইমেল আইডি এবং ব্যক্তিগত কী পাওয়ার পরে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে Python-এর জন্য Google APIs ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন:

  1. পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল এবং আপনার অ্যাপ্লিকেশনের অ্যাক্সেস প্রয়োজন এমন স্কোপ থেকে একটি Credentials অবজেক্ট তৈরি করুন। যেমন:
    from google.oauth2 import service_account
    
    SCOPES = ['https://www.googleapis.com/auth/sqlservice.admin']
    SERVICE_ACCOUNT_FILE = '/path/to/ServiceAccountKey.json'
    
    credentials = service_account.Credentials.from_service_account_file(
            SERVICE_ACCOUNT_FILE, scopes=SCOPES)

    আপনি Google Cloud-এ কোনও অ্যাপ ডেভেলপ করলে, এর পরিবর্তে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করতে পারেন, যা প্রসেসটিকে সহজ করতে পারে।

  2. ডোমেন-ব্যাপী কর্তৃত্ব ডেলিগেট করুন

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

    delegated_credentials = credentials.with_subject('user@example.org')

আপনার অ্যাপ্লিকেশনে Google API কল করতে ক্রেডেনশিয়াল অবজেক্ট ব্যবহার করুন।

HTTP/REST

API Console থেকে ক্লায়েন্ট আইডি এবং ব্যক্তিগত কী পাওয়ার পরে, আপনার অ্যাপ্লিকেশনকে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে হবে:

  1. JSON ওয়েব টোকেন (JWT, উচ্চারণ, "জট") তৈরি করুন যার মধ্যে হেডার, ক্লেম সেট এবং স্বাক্ষর অন্তর্ভুক্ত থাকে।
  2. Google OAuth 2.0 অনুমোদন সার্ভার থেকে অ্যাক্সেস টোকেনের অনুরোধ করুন।
  3. Authorization Server থেকে পাওয়া JSON রেসপন্স ম্যানেজ করুন।

এই ধাপগুলি কীভাবে সম্পূর্ণ করবেন তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

উত্তরে অ্যাক্সেস টোকেন থাকলে, আপনি Google API কল করতে অ্যাক্সেস টোকেন ব্যবহার করতে পারবেন। (উত্তরে অ্যাক্সেস টোকেন না থাকলে, আপনার JWT এবং টোকেন অনুরোধ সঠিকভাবে তৈরি নাও হতে পারে, অথবা পরিষেবা অ্যাকাউন্টে অনুরোধ করা স্কোপ অ্যাক্সেস করার অনুমতি নাও থাকতে পারে।)

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

আপনার সার্ভার অ্যাপ্লিকেশন Google Authorization Server থেকে টোকেনের অনুরোধ করার জন্য JWT ব্যবহার করে, তারপর Google API এন্ডপয়েন্ট কল করার জন্য টোকেন ব্যবহার করে। কোনও
                  ব্যবহারকারী যুক্ত নেই।
ছবি ১. আপনার সার্ভার অ্যাপ্লিকেশন Google Authorization Server থেকে টোকেনের অনুরোধ করার জন্য JWT ব্যবহার করে, তারপর Google API এন্ডপয়েন্ট কল করার জন্য টোকেন ব্যবহার করে। কোনও ব্যবহারকারী যুক্ত নেই।

এই বিভাগের বাকি অংশে JWT তৈরি করা, JWT-তে স্বাক্ষর করা, অ্যাক্সেস টোকেন অনুরোধ তৈরি করা এবং উত্তর ম্যানেজ করার নির্দিষ্ট বিবরণ দেওয়া হয়েছে।

JWT তৈরি করুন

JWT তিনটি অংশ নিয়ে গঠিত: হেডার, ক্লেম সেট ও স্বাক্ষর। হেডার ও ক্লেম সেট হল JSON অবজেক্ট। এই JSON অবজেক্টগুলি UTF-8 বাইটে সিরিয়ালাইজ করা হয়, তারপর Base64url এনকোডিং ব্যবহার করে এনকোড করা হয়। এই এনকোডিং বারবার এনকোডিং অপারেশন করার কারণে এনকোডিং পরিবর্তনের বিরুদ্ধে স্থিতিস্থাপকতা প্রদান করে। হেডার, দাবি সেট এবং স্বাক্ষর একসাথে একটি পিরিয়ড (.) অক্ষরের সাথে কনক্যাটিনেট করা হয়।

JWT এইভাবে তৈরি করা হয়:

{Base64url encoded header}.{Base64url encoded claim set}.{Base64url encoded signature}

স্বাক্ষরের জন্য বেস স্ট্রিং নিচে দেওয়া হল:

{Base64url encoded header}.{Base64url encoded claim set}
JWT হেডার তৈরি করুন

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

  • অ্যালগরিদম বাধ্যতামূলক এবং এর শুধুমাত্র একটি ভ্যালু আছে: "alg": "RS256"।
  • ফর্ম্যাট বাধ্যতামূলক এবং এতে শুধু একটি ভ্যালু আছে: "typ": "JWT"।
  • কী আইডি ঐচ্ছিক এবং এটি হল পরিষেবা অ্যাকাউন্ট কী-এর আইডি যা JWT সাইন করতে ব্যবহার করা হয়। ভুল কী আইডি উল্লেখ করা হলে, পরিষেবা অ্যাকাউন্টের সাথে যুক্ত সব কী ব্যবহার করে চেষ্টা করা হয়। কোনও সঠিক 'কী' খুঁজে না পাওয়া গেলে, টোকেন বাতিল করা হয়। ভুল কী আইডি সহ টোকেন বাতিল করার অধিকার Google-এর আছে।

পরিষেবা অ্যাকাউন্ট RSA SHA-256 অ্যালগরিদম এবং JWT টোকেন ফর্ম্যাটের উপর নির্ভর করে। এর ফলে, হেডারের JSON উপস্থাপনা নিচে দেখানো হল:

{"alg":"RS256","typ":"JWT", "kid":"370ab79b4513eb9bad7c9bd16a95cb76b5b2a56a"}

Base64url-এ এটি এইভাবে দেখানো হয়:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsICJraWQiOiIzNzBhYjc5YjQ1MTNlYjliYWQ3YzliZDE2YTk1Y2I3NmI1YjJhNTZhIn0=
JWT দাবি সেট তৈরি করুন

JWT দাবি সেটে JWT সম্পর্কে তথ্য থাকে, যার মধ্যে অনুরোধ করা অনুমতি (স্কোপ), টোকেনের টার্গেট, ইস্যুকারী, টোকেন ইস্যু করার সময় এবং টোকেনের লাইফটাইম অন্তর্ভুক্ত থাকে। বেশিরভাগ ফিল্ডই বাধ্যতামূলক। JWT হেডারের মতো, JWT ক্লেম সেট হল একটি JSON অবজেক্ট এবং এটি সিগনেচার গণনা করার জন্য ব্যবহার করা হয়।

প্রয়োজনীয় দাবি

JWT দাবি সেটে প্রয়োজনীয় দাবিগুলি দাবি সেটের যেকোনও ক্রমে দেখা যেতে পারে।

নাম বিবরণ
iss পরিষেবা অ্যাকাউন্টের ইমেল আইডি।
scope অ্যাপ্লিকেশন যেসব অনুমতির জন্য অনুরোধ করে সেগুলির স্পেস-ডিলিমিটেড তালিকা।
aud অ্যাসারশনের অভিপ্রেত টার্গেটের বর্ণনাকারী। অ্যাক্সেস টোকেন অনুরোধ করার সময় এই ভ্যালু সবসময় https://oauth2.googleapis.com/token হয়।
exp অ্যাসারশনের মেয়াদ শেষ হওয়ার সময়, ১ জানুয়ারি, ১৯৭০, ০০:০০:০০ UTC থেকে সেকেন্ড হিসেবে নির্দিষ্ট করা, । এই ভ্যালু ইস্যু করার সময় থেকে সর্বাধিক ১ ঘণ্টা পর্যন্ত থাকে।
iat অ্যাসার্শন ইস্যু করার সময়, ১ জানুয়ারি, ১৯৭০, 00:00:00 UTC থেকে সেকেন্ড হিসেবে নির্দিষ্ট করা।

JWT ক্লেম সেটে প্রয়োজনীয় ফিল্ডের JSON উপস্থাপনার উদাহরণ এখানে দেওয়া হল:

{
  "iss": "761326798069-r5mljlln1rd4lrbhg75efgigp36m78j5@developer.gserviceaccount.com",
  "scope": "https://www.googleapis.com/auth/devstorage.read_only",
  "aud": "https://oauth2.googleapis.com/token",
  "exp": 1328554385,
  "iat": 1328550785
}
অতিরিক্ত দাবি

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

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

নাম বিবরণ
sub ব্যবহারকারীর ইমেল আইডি যার জন্য অ্যাপ্লিকেশন ডেলিগেট করা অ্যাক্সেসের অনুরোধ করছে।

কোনও অ্যাপ্লিকেশনের কাছে ব্যবহারকারীর ছদ্মবেশ ধারণ করার অনুমতি না থাকলে, অ্যাক্সেস টোকেনের অনুরোধের উত্তরে sub ফিল্ড অন্তর্ভুক্ত থাকলে, সেটি সমস্যা হিসেবে দেখানো হবে।

এটি JWT ক্লেম সেটের একটি উদাহরণ যাতে sub ফিল্ড অন্তর্ভুক্ত আছে:

{
  "iss": "761326798069-r5mljlln1rd4lrbhg75efgigp36m78j5@developer.gserviceaccount.com",
  "sub": "some.user@example.com",
  "scope": "https://www.googleapis.com/auth/prediction",
  "aud": "https://oauth2.googleapis.com/token",
  "exp": 1328554385,
  "iat": 1328550785
}
JWT দাবি সেট এনকোড করা হচ্ছে

JWT হেডারের মতো, JWT ক্লেম সেট UTF-8 এবং Base64url-নিরাপদ এনকোড করা হতে হবে। এটি JWT ক্লেম সেটের JSON উপস্থাপনার একটি উদাহরণ:

{
  "iss": "761326798069-r5mljlln1rd4lrbhg75efgigp36m78j5@developer.gserviceaccount.com",
  "scope": "https://www.googleapis.com/auth/prediction",
  "aud": "https://oauth2.googleapis.com/token",
  "exp": 1328554385,
  "iat": 1328550785
}
স্বাক্ষর গণনা করুন

JSON ওয়েব সিগনেচার (JWS) হল সেই স্পেসিফিকেশন যা JWT-এর জন্য সিগনেচার তৈরি করার মেকানিক্সকে গাইড করে। স্বাক্ষরের জন্য ইনপুট হল নিম্নলিখিত কন্টেন্টের বাইট অ্যারে:

{Base64url encoded header}.{Base64url encoded claim set}

স্বাক্ষর গণনা করার সময় JWT হেডারে সাইনিং অ্যালগরিদম ব্যবহার করতে হবে। Google OAuth 2.0 অনুমোদন সার্ভার দ্বারা সমর্থিত একমাত্র সাইনিং অ্যালগরিদম হল SHA-256 হ্যাশিং অ্যালগরিদম ব্যবহার করে RSA। এটি JWT হেডারের alg ফিল্ডে RS256 হিসেবে প্রকাশ করা হয়।

Google API Console থেকে পাওয়া ব্যক্তিগত কী-এর সাহায্যে SHA256withRSA (SHA-256 হ্যাশ ফাংশন সহ RSASSA-PKCS1-V1_5-SIGN নামেও পরিচিত) ব্যবহার করে ইনপুটের UTF-8 রিপ্রেজেন্টেশন সাইন করুন। আউটপুট একটি বাইট অ্যারে হবে।

তারপর Base64url এনকোড করা স্বাক্ষর থাকতে হবে। হেডার, দাবি সেট ও স্বাক্ষর একসাথে ফুলস্টপ (.) চিহ্ন দিয়ে যুক্ত করা হয়। ফলাফল হল JWT। এটি নিম্নলিখিত ফর্ম্যাটে হতে হবে (স্বচ্ছতার জন্য লাইন ব্রেক যোগ করা হয়েছে):

{Base64url encoded header}.
{Base64url encoded claim set}.
{Base64url encoded signature}

Base64url এনকোডিংয়ের আগে JWT-এর উদাহরণ:

{"alg":"RS256","typ":"JWT"}.
{
"iss":"761326798069-r5mljlln1rd4lrbhg75efgigp36m78j5@developer.gserviceaccount.com",
"scope":"https://www.googleapis.com/auth/prediction",
"aud":"https://oauth2.googleapis.com/token",
"exp":1328554385,
"iat":1328550785
}.
[signature bytes]

এটি একটি JWT-এর উদাহরণ যা সাইন করা হয়েছে এবং ট্রান্সমিশনের জন্য প্রস্তুত:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiI3NjEzMjY3OTgwNjktcjVtbGpsbG4xcmQ0bHJiaGc3NWVmZ2lncDM2bTc4ajVAZGV2ZWxvcGVyLmdzZXJ2aWNlYWNjb3VudC5jb20iLCJzY29wZSI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL2F1dGgvcHJlZGljdGlvbiIsImF1ZCI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL29hdXRoMi92NC90b2tlbiIsImV4cCI6MTMyODU1NDM4NSwiaWF0IjoxMzI4NTUwNzg1fQ.UFUt59SUM2_AW4cRU8Y0BYVQsNTo4n7AFsNrqOpYiICDu37vVt-tw38UKzjmUKtcRsLLjrR3gFW3dNDMx_pL9DVjgVHDdYirtrCekUHOYoa1CMR66nxep5q5cBQ4y4u2kIgSvChCTc9pmLLNoIem-ruCecAJYgI9Ks7pTnW1gkOKs0x3YpiLpzplVHAkkHztaXiJdtpBcY1OXyo6jTQCa3Lk2Q3va1dPkh_d--GU2M5flgd8xNBPYw4vxyt0mP59XZlHMpztZt0soSgObf7G3GXArreF_6tpbFsS3z2t5zkEiHuWJXpzcYr5zWTRPDEHsejeBSG8EgpLDce2380ROQ

অ্যাক্সেস টোকেনের জন্য অনুরোধ করা

স্বাক্ষরিত JWT তৈরি করার পরে, কোনও অ্যাপ্লিকেশন অ্যাক্সেস টোকেনের অনুরোধ করার জন্য এটি ব্যবহার করতে পারে। এই অ্যাক্সেস টোকেন অনুরোধ হল একটি HTTPS POST অনুরোধ এবং বডি হল URL এনকোড করা। যেমন:

https://oauth2.googleapis.com/token

HTTPS POST অনুরোধে নিম্নলিখিত প্যারামিটারগুলি প্রয়োজন:

নাম বিবরণ
grant_type প্রয়োজন অনুযায়ী URL-এনকোড করা নিম্নলিখিত স্ট্রিং ব্যবহার করুন: urn:ietf:params:oauth:grant-type:jwt-bearer
assertion স্বাক্ষর সহ JWT।

এটি অ্যাক্সেস টোকেন অনুরোধে ব্যবহৃত HTTPS POST অনুরোধের একটি র ডাম্প:

POST /token HTTP/1.1
Host: oauth2.googleapis.com
Content-Type: application/x-www-form-urlencoded

grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Ajwt-bearer&assertion=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiI3NjEzMjY3OTgwNjktcjVtbGpsbG4xcmQ0bHJiaGc3NWVmZ2lncDM2bTc4ajVAZGV2ZWxvcGVyLmdzZXJ2aWNlYWNjb3VudC5jb20iLCJzY29wZSI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL2F1dGgvcHJlZGljdGlvbiIsImF1ZCI6Imh0dHBzOi8vYWNjb3VudHMuZ29vZ2xlLmNvbS9vL29hdXRoMi90b2tlbiIsImV4cCI6MTMyODU3MzM4MSwiaWF0IjoxMzI4NTY5NzgxfQ.ixOUGehweEVX_UKXv5BbbwVEdcz6AYS-6uQV6fGorGKrHf3LIJnyREw9evE-gs2bmMaQI5_UbabvI4k-mQE4kBqtmSpTzxYBL1TCd7Kv5nTZoUC1CmwmWCFqT9RE6D7XSgPUh_jF1qskLa2w0rxMSjwruNKbysgRNctZPln7cqQ

এটি একই অনুরোধ, curl ব্যবহার করে:

curl -d 'grant_type=urn%3Aietf%3Aparams%3Aoauth%3Agrant-type%3Ajwt-bearer&assertion=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiI3NjEzMjY3OTgwNjktcjVtbGpsbG4xcmQ0bHJiaGc3NWVmZ2lncDM2bTc4ajVAZGV2ZWxvcGVyLmdzZXJ2aWNlYWNjb3VudC5jb20iLCJzY29wZSI6Imh0dHBzOi8vd3d3Lmdvb2dsZWFwaXMuY29tL2F1dGgvcHJlZGljdGlvbiIsImF1ZCI6Imh0dHBzOi8vYWNjb3VudHMuZ29vZ2xlLmNvbS9vL29hdXRoMi90b2tlbiIsImV4cCI6MTMyODU3MzM4MSwiaWF0IjoxMzI4NTY5NzgxfQ.RZVpzWygMLuL-n3GwjW1_yhQhrqDacyvaXkuf8HcJl8EtXYjGjMaW5oiM5cgAaIorrqgYlp4DPF_GuncFqg9uDZrx7pMmCZ_yHfxhSCXru3gbXrZvAIicNQZMFxrEEn4REVuq7DjkTMyCMGCY1dpMa8aWfTQFt3Eh7smLchaZsU
' https://oauth2.googleapis.com/token

উত্তরের ম্যানেজমেন্ট

JWT এবং অ্যাক্সেস টোকেনের অনুরোধ সঠিকভাবে তৈরি করা হলে এবং পরিষেবা অ্যাকাউন্টের কাছে অপারেশনটি করার অনুমতি থাকলে, অথরাইজেশন সার্ভার থেকে JSON উত্তরে একটি অ্যাক্সেস টোকেন অন্তর্ভুক্ত থাকে। নিচে একটি উত্তর দেওয়া হল:

{
  "access_token": "1/8xbJqaOZXSUZbHLl5EOtu1pxz3fmmetKx9W8CV4t79M",
  "scope": "https://www.googleapis.com/auth/prediction"
  "token_type": "Bearer",
  "expires_in": 3600
}

expires_in ভ্যালু দ্বারা নির্দিষ্ট করা সময়সীমার মধ্যে অ্যাক্সেস টোকেন আবার ব্যবহার করা যেতে পারে।

নিরাপত্তা সংক্রান্ত গুরুত্বপূর্ণ বিষয়: ছদ্মবেশ ধারণ করা সম্পর্কে বোঝা

আপনি ডোমেন-ব্যাপী কর্তৃত্ব ডেলিগেট করলে, আপনি পরিষেবা অ্যাকাউন্টকে সমস্ত ব্যবহারকারীর ডেটাতে সরাসরি অ্যাক্সেস প্রদান করছেন না। পরিবর্তে, আপনি API কল করার সময় নির্দিষ্ট ব্যবহারকারীর ছদ্মবেশ ধারণ করার জন্য এটিকে অনুমোদন করছেন।
  • ব্যবহারকারীর হয়ে অ্যাক্সেস করা: প্রতিটি API অনুরোধের জন্য কোন ব্যবহারকারীর ছদ্মবেশ ধারণ করতে হবে তা আপনার অ্যাপ্লিকেশনকে অবশ্যই নির্দিষ্ট করতে হবে। অ্যাপ্লিকেশনটি তখন সেই নির্দিষ্ট ব্যবহারকারীর অনুমতি নিয়ে কাজ করে, কোনও উন্নত বা ডোমেন-ব্যাপী বিশেষাধিকার নিয়ে নয়।
  • অনুমতি সীমিত: পরিষেবা অ্যাকাউন্টের অ্যাক্সেস দুটি কারণে সীমাবদ্ধ: ছদ্মবেশী ব্যবহারকারীর অনুমতি এবং অ্যাডমিন কনসোলে আপনার অনুমোদিত OAuth স্কোপ। এটি এমন ডেটা অ্যাক্সেস করতে পারে না যা ছদ্মবেশী ব্যবহারকারী নিজে অ্যাক্সেস করতে পারেন না।
  • সবচেয়ে কম সুবিধা সম্পর্কিত নীতি: এই ফিচার ব্যবহারকারীর সরাসরি সম্মতি ছাড়াই তার ডেটা অ্যাক্সেস করার অনুমতি দেয়, তাই নিরাপত্তা সংক্রান্ত পেশাদার পদ্ধতি অনুসরণ করা অত্যন্ত গুরুত্বপূর্ণ। শুধুমাত্র প্রয়োজনীয় OAuth স্কোপের অনুমতি দিন এবং নিরাপত্তা সংক্রান্ত প্রভাব সম্পর্কে আপনি বুঝেছেন কিনা তা নিশ্চিত করুন।
নিরাপত্তা সংক্রান্ত বিস্তারিত নির্দেশিকার জন্য, ডোমেন-জুড়ে ডেলিগেশন সংক্রান্ত পেশাদার পদ্ধতি দেখুন।

Google API কল করুন

Java

নিম্নলিখিত ধাপগুলি সম্পূর্ণ করে Google APIs কল করার জন্য GoogleCredentials অবজেক্ট ব্যবহার করুন:

  1. GoogleCredentials অবজেক্ট ব্যবহার করে আপনি যে API কল করতে চান তার জন্য একটি পরিষেবা অবজেক্ট তৈরি করুন। যেমন:
    SQLAdmin sqladmin =
        new SQLAdmin.Builder(httpTransport, JSON_FACTORY, credentials).build();
  2. পরিষেবা অবজেক্টের মাধ্যমে প্রদান করা ইন্টারফেস ব্যবহার করে API পরিষেবার কাছে অনুরোধ করুন। যেমন, exciting-example-123 প্রোজেক্টে Cloud SQL ডেটাবেসের ইনস্ট্যান্সের তালিকা তৈরি করতে:
    SQLAdmin.Instances.List instances =
        sqladmin.instances().list("exciting-example-123").execute();

Python

নিম্নলিখিত ধাপগুলি সম্পূর্ণ করে Google API কল করার জন্য অনুমোদিত Credentials অবজেক্ট ব্যবহার করুন:

  1. আপনি যে API কল করতে চান তার জন্য একটি পরিষেবা অবজেক্ট তৈরি করুন। আপনি API-এর নাম ও ভার্সন এবং অনুমোদিত Credentials অবজেক্ট সহ build ফাংশন কল করে একটি পরিষেবা অবজেক্ট তৈরি করেন। যেমন, Cloud SQL Administration API-এর 1beta3 ভার্সন কল করতে:
    import googleapiclient.discovery
    
    sqladmin = googleapiclient.discovery.build('sqladmin', 'v1beta3', credentials=credentials)
  2. পরিষেবা অবজেক্টের মাধ্যমে প্রদান করা ইন্টারফেস ব্যবহার করে API পরিষেবার কাছে অনুরোধ করুন। যেমন, exciting-example-123 প্রোজেক্টে Cloud SQL ডেটাবেসের ইনস্ট্যান্সের তালিকা তৈরি করতে:
    response = sqladmin.instances().list(project='exciting-example-123').execute()

HTTP/REST

আপনার অ্যাপ্লিকেশন অ্যাক্সেস টোকেন পাওয়ার পরে, আপনি টোকেন ব্যবহার করে কোনও নির্দিষ্ট পরিষেবা অ্যাকাউন্ট বা ব্যবহারকারীর অ্যাকাউন্টের হয়ে Google API-এ কল করতে পারবেন, যদি API-এর জন্য প্রয়োজনীয় অ্যাক্সেসের স্কোপ অনুমোদন করা হয়ে থাকে। এটি করতে, API-তে করা অনুরোধে অ্যাক্সেস টোকেন যোগ করুন। এর জন্য access_token কোয়েরি প্যারামিটার অথবা Authorization HTTP হেডার Bearer ভ্যালু যোগ করুন। সম্ভব হলে, HTTP হেডার ব্যবহার করা ভাল, কারণ কোয়েরি স্ট্রিং সার্ভার লগে দেখা যেতে পারে। বেশিরভাগ ক্ষেত্রে, Google API-তে আপনার কল সেট-আপ করতে আপনি ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে পারবেন (যেমন, Drive Files API কল করার সময়)।

আপনি সব Google API ব্যবহার করে দেখতে এবং OAuth 2.0 Playground-এ সেগুলির স্কোপ দেখতে পারবেন।

HTTP GET-এর উদাহরণ

Authorization: Bearer HTTP হেডার ব্যবহার করে drive.files এন্ডপয়েন্টে (Drive Files API) করা কল নিম্নলিখিত উদাহরণের মতো হতে পারে। মনে রাখবেন, আপনাকে নিজের অ্যাক্সেস টোকেন উল্লেখ করতে হবে:

GET /drive/v2/files HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer access_token

access_token কোয়েরি স্ট্রিং প্যারামিটার ব্যবহার করে যাচাই করা ব্যবহারকারীর জন্য একই API-তে কল করার পদ্ধতি এখানে দেওয়া হল:

GET https://www.googleapis.com/drive/v2/files?access_token=access_token

curlটি উদাহরণ

আপনি curl কমান্ড-লাইন অ্যাপ্লিকেশনের মাধ্যমে এইসব কমান্ড পরীক্ষা করতে পারবেন। HTTP হেডার বিকল্প ব্যবহার করে এমন একটি উদাহরণ এখানে দেওয়া হল (পছন্দসই):

curl -H "Authorization: Bearer access_token" https://www.googleapis.com/drive/v2/files

অথবা, বিকল্প হিসেবে, কোয়েরি স্ট্রিং প্যারামিটার বিকল্প:

curl https://www.googleapis.com/drive/v2/files?access_token=access_token

অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে

Google OAuth 2.0 অনুমোদন সার্ভারের মাধ্যমে ইস্যু করা অ্যাক্সেস টোকেনের মেয়াদ expires_in ভ্যালুর মাধ্যমে প্রদান করা সময়সীমা শেষ হওয়ার পরে শেষ হয়ে যায়। অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, অ্যাপ্লিকেশনকে আরেকটি JWT তৈরি করতে হবে, এটিতে স্বাক্ষর করতে হবে এবং আরেকটি অ্যাক্সেস টোকেনের জন্য অনুরোধ করতে হবে।

JWT এরর কোড

error ফিল্ড error_description ফিল্ড অর্থ কীভাবে সমাধান করতে হয়
unauthorized_client Unauthorized client or scope in request. আপনি যদি ডোমেন-ওয়াইড ডেলিগেশন ব্যবহার করার চেষ্টা করেন, তাহলে ব্যবহারকারীর ডোমেনের অ্যাডমিন কনসোলে পরিষেবা অ্যাকাউন্টটি অনুমোদিত নয়।

নিশ্চিত করুন যে পরিষেবা অ্যাকাউন্টটি অ্যাডমিন কনসোলের ডোমেন-ওয়াইড ডেলিগেশন পৃষ্ঠায় অনুমোদিত হয়েছে, sub দাবি (ফিল্ড)-এ ব্যবহারকারীর জন্য।

সাধারণত কয়েক মিনিট সময় লাগলেও, আপনার Google অ্যাকাউন্টের সব ব্যবহারকারীর কাছে অনুমোদনের তথ্য পৌঁছাতে ২৪ ঘণ্টা পর্যন্ত সময় লাগতে পারে।

unauthorized_client Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested. অ্যাডমিন কনসোলে ক্লায়েন্ট আইডির (সংখ্যা) পরিবর্তে ক্লায়েন্ট ইমেল আইডি ব্যবহার করে কোনও পরিষেবা অ্যাকাউন্ট অনুমোদিত করা হয়েছে অথবা অনুমোদনের জন্য Google Group ব্যবহার করা হয়েছে। অ্যাডমিন কনসোলের ডোমেন-ওয়াইড ডেলিগেশন পৃষ্ঠায়, ক্লায়েন্টকে সরান এবং সংখ্যাসূচক আইডি দিয়ে এটি আবার যোগ করুন অথবা Google Group সরান এবং এটি পৃথক পরিষেবা বা ব্যবহারকারীর অ্যাকাউন্ট দিয়ে প্রতিস্থাপন করুন।
access_denied (যেকোনও ভ্যালু) আপনি ডোমেন-ওয়াইড ডেলিগেশন ব্যবহার করলে, এক বা একাধিক অনুরোধ করা স্কোপ অ্যাডমিন কনসোলে অনুমোদিত নয়।

নিশ্চিত করুন যে অ্যাডমিন কনসোলের ডোমেন-ওয়াইড ডেলিগেশন পৃষ্ঠায়, sub দাবির (ফিল্ড) ব্যবহারকারীর জন্য পরিষেবা অ্যাকাউন্টটি অনুমোদিত এবং এতে আপনার JWT-এর scope দাবিতে অনুরোধ করা সমস্ত স্কোপ অন্তর্ভুক্ত রয়েছে।

Google পরিষেবায় অ্যাক্সেস সীমাবদ্ধ করা হয়নি তা কনফার্ম করতে ব্যক্তিগতভাবে নিয়ন্ত্রণ করা হয় না এমন পরিষেবায় অ্যাক্সেস ম্যানেজ করুন বিকল্পটি পর্যালোচনা করুন।

সাধারণত কয়েক মিনিট সময় লাগলেও, আপনার Google অ্যাকাউন্টের সব ব্যবহারকারীর কাছে অনুমোদনের তথ্য পৌঁছাতে ২৪ ঘণ্টা পর্যন্ত সময় লাগতে পারে।

admin_policy_enforced (যেকোনও ভ্যালু) Google Workspace অ্যাডমিনিস্ট্রেটরের নীতির কারণে Google অ্যাকাউন্ট অনুরোধ করা এক বা একাধিক স্কোপ অনুমোদন করতে পারছে না।

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

invalid_client (যেকোনও ভ্যালু)

OAuth ক্লায়েন্ট বা JWT টোকেন ভুল বা ভুলভাবে কনফিগার করা হয়েছে।

বিস্তারিত জানতে সমস্যার বিবরণ দেখুন।

JWT টোকেনটি সঠিক এবং এতে সঠিক দাবি আছে কিনা তা নিশ্চিত করুন।

OAuth ক্লায়েন্ট ও পরিষেবা অ্যাকাউন্ট সঠিকভাবে কনফিগার করা হয়েছে কিনা এবং আপনি সঠিক ইমেল আইডি ব্যবহার করছেন কিনা তা চেক করুন।

JWT টোকেনটি সঠিক কিনা এবং অনুরোধে ক্লায়েন্ট আইডির জন্য ইস্যু করা হয়েছে কিনা তা চেক করুন।

deleted_client (যেকোনও ভ্যালু)

অনুরোধ করার জন্য যে OAuth ক্লায়েন্ট ব্যবহার করা হচ্ছে সেটি মুছে দেওয়া হয়েছে। ব্যবহার করা হয়নি এমন ক্লায়েন্টের ক্ষেত্রে ম্যানুয়ালি বা অটোমেটিক মুছে দেওয়া হতে পারে। মুছে ফেলা ক্লায়েন্টকে মুছে ফেলার ৩০ দিনের মধ্যে ফিরিয়ে আনা যাবে। আরও জানুন।

এখনও অ্যাক্টিভ আছে এমন ক্লায়েন্ট আইডি ব্যবহার করুন।

invalid_grant Not a valid email বা Invalid email or User ID. ব্যবহারকারীর অস্তিত্ব নেই। sub দাবি (ফিল্ড)-এ ইমেল আইডি সঠিক কিনা তা চেক করুন।
invalid_grant

Invalid JWT: Token must be a short-lived token (60 minutes) and in a reasonable timeframe. Check your 'iat' and 'exp' values and use a clock with skew to account for clock differences between systems.

সাধারণত, এর অর্থ হল লোকাল সিস্টেমের সময় সঠিক নয়। এছাড়াও, exp ভ্যালু iat ভ্যালুর থেকে ৬৫ মিনিটের বেশি হলে অথবা exp ভ্যালু iat ভ্যালুর থেকে কম হলে এমন হতে পারে।

যে সিস্টেমে JWT তৈরি করা হয়েছে সেটির ঘড়ি ঠিক আছে কিনা তা নিশ্চিত করুন। প্রয়োজন হলে, Google NTP-এর সাথে আপনার সময় সিঙ্ক করুন।

invalid_grant Invalid JWT Signature.

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

অথবা, JWT অ্যাসারশন ভুলভাবে এনকোড করা হতে পারে - এটি অবশ্যই Base64-এনকোড করা হতে হবে, নতুন লাইন বা প্যাডিং সমান চিহ্ন ছাড়া।

JWT ক্লেম সেট ডিকোড করুন এবং অ্যাসারশন সাইন করা কীটি পরিষেবা অ্যাকাউন্টের সাথে যুক্ত কিনা তা যাচাই করুন।

JWT সঠিকভাবে তৈরি হয়েছে কিনা তা নিশ্চিত করতে Google-এর প্রদান করা OAuth লাইব্রেরি ব্যবহার করে দেখুন।

invalid_scope Invalid OAuth scope or ID token audience provided. কোনও স্কোপের অনুরোধ করা হয়নি (স্কোপের তালিকা খালি আছে) অথবা অনুরোধ করা স্কোপগুলির মধ্যে একটির কোনও অস্তিত্ব নেই (অর্থাৎ, সেটি সঠিক নয়)।

JWT-এর scope দাবি (ফিল্ড) পূরণ করা হয়েছে কিনা তা নিশ্চিত করুন এবং এতে থাকা স্কোপের সাথে আপনি যে API ব্যবহার করতে চান তার জন্য ডকুমেন্ট করা স্কোপের তুলনা করুন, যাতে কোনও ভুল বা টাইপো না থাকে।

মনে রাখবেন যে scope দাবিতে স্কোপের তালিকা কমা দিয়ে নয়, স্পেস দিয়ে আলাদা করতে হবে।

disabled_client The OAuth client was disabled. JWT অ্যাসারশন সাইন করার জন্য ব্যবহৃত কী বন্ধ করা আছে।

Google API Console-এ যান এবং IAM ও অ্যাডমিন > পরিষেবা অ্যাকাউন্ট বিকল্পের অধীনে, অ্যাসারশন সাইন করার জন্য ব্যবহৃত "কী আইডি" আছে এমন পরিষেবা অ্যাকাউন্ট চালু করুন।

org_internal This client is restricted to users within its organization. অনুরোধে থাকা OAuth ক্লায়েন্ট আইডি হল এমন একটি প্রোজেক্টের অংশ যা নির্দিষ্ট Google Cloud সংস্থায় Google অ্যাকাউন্টের অ্যাক্সেস সীমিত করে।

যাচাই করার জন্য সংস্থার থেকে একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করুন। আপনার OAuth অ্যাপ্লিকেশনের জন্য ব্যবহারকারীর ধরন কনফিগারেশন কনফার্ম করুন।

সংযোজন: OAuth ছাড়া পরিষেবা অ্যাকাউন্ট অনুমোদন

কিছু Google API-এর মাধ্যমে, আপনি OAuth 2.0 অ্যাক্সেস টোকেনের পরিবর্তে সরাসরি বিয়ারার টোকেন হিসেবে স্বাক্ষরিত JWT ব্যবহার করে অনুমোদিত API কল করতে পারেন। এটি সম্ভব হলে, API কল করার আগে Google-এর অথরাইজেশন সার্ভারে নেটওয়ার্ক রিকোয়েস্ট পাঠানোর প্রয়োজন হয় না।

আপনি যে API কল করতে চান, সেটির পরিষেবার সংজ্ঞা যদি Google APIs GitHub রিপোজিটরিতে প্রকাশিত হয়ে থাকে, তাহলে আপনি অ্যাক্সেস টোকেনের পরিবর্তে JWT ব্যবহার করে অনুমোদিত API কল করতে পারবেন। এটি করতে:

  1. পরিষেবা অ্যাকাউন্ট তৈরি করুন। অ্যাকাউন্ট তৈরি করার সময় আপনি যে JSON ফাইল পাবেন, সেটি সংরক্ষণ করে রাখতে ভুলবেন না।
  2. যেকোনও স্ট্যান্ডার্ড JWT লাইব্রেরি ব্যবহার করে, যেমন jwt.io-তে পাওয়া যায়, নিচের উদাহরণের মতো হেডার ও পেলোড সহ JWT তৈরি করুন:
    {
      "alg": "RS256",
      "typ": "JWT",
      "kid": "abcdef1234567890"
    }
    .
    {
      "iss": "123456-compute@developer.gserviceaccount.com",
      "sub": "123456-compute@developer.gserviceaccount.com",
      "aud": "https://firestore.googleapis.com/",
      "iat": 1511900000,
      "exp": 1511903600
    }
    • হেডারের kid ফিল্ডের জন্য, আপনার পরিষেবা অ্যাকাউন্টের ব্যক্তিগত কী আইডি উল্লেখ করুন। আপনার পরিষেবা অ্যাকাউন্টের JSON ফাইলের private_key_id ফিল্ডে আপনি এই ভ্যালু খুঁজে পাবেন।
    • iss এবং sub ফিল্ডের জন্য, আপনার পরিষেবা অ্যাকাউন্টের ইমেল আইডি উল্লেখ করুন। আপনার পরিষেবা অ্যাকাউন্টের JSON ফাইলের client_email ফিল্ডে এই ভ্যালু খুঁজে পাবেন। এই মানটি অনন্যভাবে ক্লায়েন্টকে শনাক্ত করে এবং কার্যগতভাবে এটি হল ক্লায়েন্ট আইডি।
    • aud ফিল্ডের জন্য API এন্ডপয়েন্ট উল্লেখ করুন। যেমন: https://SERVICE.googleapis.com/.
    • iat ফিল্ডের জন্য, বর্তমান Unix সময় উল্লেখ করুন এবং exp ফিল্ডের জন্য, ঠিক ৩৬০০ সেকেন্ড পরের সময় উল্লেখ করুন, যখন JWT-এর মেয়াদ শেষ হয়ে যাবে।

আপনার পরিষেবা অ্যাকাউন্টের JSON ফাইলে পাওয়া ব্যক্তিগত কী ব্যবহার করে RSA-256-এর মাধ্যমে JWT সাইন করুন।

যেমন:

Java

google-auth-library-java এবং java-jwt ব্যবহার করে:

import com.google.auth.oauth2.ServiceAccountCredentials;
...
GoogleCredentials credentials =
        GoogleCredentials.fromStream(new FileInputStream("MyProject-1234.json"));
PrivateKey privateKey = ((ServiceAccountCredentials) credentials).getPrivateKey();
String privateKeyId = ((ServiceAccountCredentials) credentials).getPrivateKeyId();

long now = System.currentTimeMillis();

try {
    Algorithm algorithm = Algorithm.RSA256(null, privateKey);
    String signedJwt = JWT.create()
        .withKeyId(privateKeyId)
        .withIssuer("123456-compute@developer.gserviceaccount.com")
        .withSubject("123456-compute@developer.gserviceaccount.com")
        .withAudience("https://firestore.googleapis.com/")
        .withIssuedAt(new Date(now))
        .withExpiresAt(new Date(now + 3600 * 1000L))
        .sign(algorithm);
} catch ...

Python

PyJWT ব্যবহার করা:

iat = time.time()
exp = iat + 3600
payload = {'iss': '123456-compute@developer.gserviceaccount.com',
           'sub': '123456-compute@developer.gserviceaccount.com',
           'aud': 'https://firestore.googleapis.com/',
           'iat': iat,
           'exp': exp}
additional_headers = {'kid': PRIVATE_KEY_ID_FROM_JSON}
signed_jwt = jwt.encode(payload, PRIVATE_KEY_FROM_JSON, headers=additional_headers,
                       algorithm='RS256')
  1. বিয়ারার টোকেন হিসেবে সাইন-ইন করা JWT ব্যবহার করে API কল করুন:
    GET /v1/projects/abc/databases/123/indexes HTTP/1.1
    Authorization: Bearer SIGNED_JWT
    Host: firestore.googleapis.com

ক্রস-অ্যাকাউন্ট সুরক্ষা প্রয়োগ করা

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

Google-এর ক্রস-অ্যাকাউন্ট সুরক্ষা পরিষেবার মাধ্যমে আপনার অ্যাপে পাঠানো ইভেন্টের ধরনের কিছু উদাহরণ হল:

  • https://schemas.openid.net/secevent/risc/event-type/sessions-revoked
  • https://schemas.openid.net/secevent/oauth/event-type/token-revoked
  • https://schemas.openid.net/secevent/risc/event-type/account-disabled

ক্রস-অ্যাকাউন্ট সুরক্ষা কীভাবে প্রয়োগ করবেন এবং উপলভ্য ইভেন্টের সম্পূর্ণ তালিকা পেতে ক্রস-অ্যাকাউন্ট সুরক্ষা পৃষ্ঠার মাধ্যমে ব্যবহারকারীর অ্যাকাউন্ট সুরক্ষিত করুন দেখুন।