আউট-অফ-ব্যান্ড (OOB) ফ্লো মাইগ্রেশন গাইড

এক নজরে

১৬ ফেব্রুয়ারি ২০২২-এ, আমরা আরও সুরক্ষিত OAuth ফ্লো ব্যবহার করে Google OAuth ইন্টার‍্যাকশন আরও নিরাপদ করার পরিকল্পনা ঘোষণা করেছি। এই নির্দেশিকা আপনাকে OAuth আউট-অফ-ব্যান্ড (OOB) ফ্লো থেকে কাজ করে এমন বিকল্পে সফলভাবে মাইগ্রেট করার জন্য প্রয়োজনীয় পরিবর্তন এবং পদক্ষেপগুলি বুঝতে সাহায্য করে।

Google-এর OAuth 2.0 অনুমোদন এন্ডপয়েন্টের সাথে ইন্টার‍্যাক্ট করার সময় ফিশিং ও অ্যাপের ছদ্মবেশে আক্রমণ থেকে রক্ষা করার জন্য এই পদক্ষেপ নেওয়া হয়েছে।

OOB কী?

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

সব ধরনের অ্যাপ্লিকেশনের জন্য OOB ফ্লো বন্ধ করা হচ্ছে—অর্থাৎ, ওয়েব অ্যাপ্লিকেশন, Android, iOS, ইউনিভার্সাল Windows প্ল্যাটফর্ম (UWP), Chrome অ্যাপ, টিভি ও সীমিত-ইনপুট ডিভাইস, ডেস্কটপ অ্যাপ।

সম্মতি সংক্রান্ত গুরুত্বপূর্ণ তারিখ

  • ২৮ ফেব্রুয়ারি, ২০২২ - OOB ফ্লোয়ের জন্য নতুন OAuth ব্যবহার ব্লক করা হয়েছে
  • ৫ সেপ্টেম্বর, ২০২২ - নীতি মেনে চলছে না এমন OAuth অনুরোধের ক্ষেত্রে ব্যবহারকারীকে সতর্কতামূলক মেসেজ দেখানো হতে পারে
  • ৩ অক্টোবর, ২০২২ - ২৮ ফেব্রুয়ারি, ২০২২-এর আগে তৈরি করা OAuth ক্লায়েন্টের জন্য OOB ফ্লো বন্ধ করে দেওয়া হয়েছে
  • ৩১ জানুয়ারি, ২০২৩ - আগে থেকে থাকা সব ক্লায়েন্টকে ব্লক করা হয়েছে (ছাড়প্রাপ্ত ক্লায়েন্ট সহ)

নীতি মেনে চলে না এমন অনুরোধের ক্ষেত্রে ব্যবহারকারী নিজে ইন্টার‌্যাক্ট করতে পারেন এমন ত্রুটি মেসেজ দেখানো হবে। এই মেসেজ ব্যবহারকারীদের জানাবে যে অ্যাপটি ব্লক করা হয়েছে এবং একই সাথে সহায়তা ইমেল দেখাবে যা আপনি Google Cloud কনসোলে OAuth সম্মতি স্ক্রিনে রেজিস্টার করেছেন।

মাইগ্রেশন প্রসেস সম্পূর্ণ করার দুটি প্রধান ধাপ আছে:

  1. আপনি প্রভাবিত হয়েছেন কিনা তা নির্ধারণ করুন।
  2. আপনি প্রভাবিত হলে, আরও সুরক্ষিত বিকল্পে মাইগ্রেট করুন।

আপনি প্রভাবিত হয়েছেন কিনা তা নির্ধারণ করুন

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

Google Cloud Console-এর OAuth ব্র্যান্ডিং পৃষ্ঠায় আপনার প্রকাশনার স্ট্যাটাস পর্যালোচনা করুন এবং "প্রোডাকশনে আছে" প্রকাশনার স্ট্যাটাস সহ কোনও প্রোজেক্টে OOB ফ্লো ব্যবহার করলে পরবর্তী ধাপে এগিয়ে যান।

আপনার অ্যাপ OOB ফ্লো ব্যবহার করছে কিনা তা কীভাবে নির্ধারণ করবেন

আপনার অ্যাপের করা Google OAuth অনুমোদনের অনুরোধ OOB রিডাইরেক্ট URI ভ্যালু ব্যবহার করছে কিনা তা নির্ধারণ করতে, আপনার অ্যাপ কোড বা আউটগোয়িং নেটওয়ার্ক কল (আপনার অ্যাপ OAuth লাইব্রেরি ব্যবহার করলে) ভাল করে দেখুন।

আপনার অ্যাপ্লিকেশন কোড পরীক্ষা করুন

আপনার অ্যাপ্লিকেশন কোডের সেই বিভাগটি পর্যালোচনা করুন যেখানে আপনি Google OAuth অনুমোদন এন্ডপয়েন্ট-এ কল করছেন এবং redirect_uri প্যারামিটারে নিম্নলিখিত কোনও ভ্যালু আছে কিনা তা নির্ধারণ করুন:

  • redirect_uri=urn:ietf:wg:oauth:2.0:oob
  • redirect_uri=urn:ietf:wg:oauth:2.0:oob:auto
  • redirect_uri=oob

OOB রিডাইরেক্ট ফ্লো অনুরোধের একটি স্যাম্পেল নিচে দেওয়া হল:

https://accounts.google.com/o/oauth2/v2/auth?
response_type=code&
scope=<SCOPES>&
state=<STATE>&
redirect_uri=urn:ietf:wg:oauth:2.0:oob&
client_id=<CLIENT_ID>

আউটগোয়িং নেটওয়ার্ক কল পরীক্ষা করুন

আপনার অ্যাপ্লিকেশনের ধরনের উপর নির্ভর করে নেটওয়ার্ক কল পরীক্ষা করার পদ্ধতি আলাদা হবে।

নেটওয়ার্ক কল পরীক্ষা করার সময়, Google OAuth অনুমোদন এন্ডপয়েন্টে পাঠানো অনুরোধগুলি দেখুন এবং redirect_uri প্যারামিটারে নিম্নলিখিত কোনও ভ্যালু আছে কিনা তা নির্ধারণ করুন:

  • redirect_uri=urn:ietf:wg:oauth:2.0:oob
  • redirect_uri=urn:ietf:wg:oauth:2.0:oob:auto
  • redirect_uri=oob

OOB রিডাইরেক্ট ফ্লো অনুরোধের একটি স্যাম্পেল নিচে দেওয়া হল:

https://accounts.google.com/o/oauth2/v2/auth?
response_type=code&
scope=<SCOPES>&
state=<STATE>&
redirect_uri=urn:ietf:wg:oauth:2.0:oob&
client_id=<CLIENT_ID>

একটি নিরাপদ বিকল্পে মাইগ্রেট করুন

মোবাইল ক্লায়েন্ট (Android ও iOS)

আপনি যদি দেখেন যে আপনার অ্যাপ Android বা iOS OAuth অ্যাপ্লিকেশন টাইপের সাথে OOB ফ্লো ব্যবহার করছে, তাহলে আপনাকে সাজেস্ট করা SDK (Android, iOS) ব্যবহার করার জন্য মাইগ্রেট করতে হবে।

SDK আপনাকে Google API অ্যাক্সেস করতে সাহায্য করে এবং Google-এর OAuth 2.0 অনুমোদনের এন্ডপয়েন্টে সমস্ত কল ম্যানেজ করে।

OOB রিডাইরেক্ট URI ব্যবহার না করে Google API অ্যাক্সেস করার জন্য সাজেস্ট করা SDK কীভাবে ব্যবহার করবেন সেই সম্পর্কে নিম্নলিখিত ডকুমেন্টেশন লিঙ্কে তথ্য দেওয়া আছে।

Android-এ Google API অ্যাক্সেস করা

ক্লায়েন্ট-সাইড অ্যাক্সেস

নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে কীভাবে সাজেস্ট করা Google Identity Services Android লাইব্রেরি ব্যবহার করে Android-এ ক্লায়েন্ট সাইডে Google API অ্যাক্সেস করতে হয়।

List<Scopes> requestedScopes = Arrays.asList(DriveScopes.DRIVE_APPDATA);
AuthorizationRequest authorizationRequest =
    AuthorizationRequest.builder()
        .setRequestedScopes(requestedScopes)
        .build();
Identity.getAuthorizationClient(activity)
    .authorize(authorizationRequest)
    .addOnSuccessListener(
        authorizationResult -> {
          if (authorizationResult.hasResolution()) {
            // Access needs to be granted by the user
            PendingIntent pendingIntent =
                authorizationResult.getPendingIntent();
            try {
              startIntentSenderForResult(
                  pendingIntent.getIntentSender(),
                  REQUEST_AUTHORIZE, null, 0, 0, 0, null);
            } catch (IntentSender.SendIntentException e) {
              Log.e(
                  TAG,
                  "Couldn't start Authorization UI: "
                      + e.getLocalizedMessage());
            }
          } else {
            // Access already granted, continue with user action
            saveToDriveAppFolder(authorizationResult);
          }
        })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to authorize", e));

ব্যবহারকারীর ড্রাইভ ফোল্ডারে কন্টেন্ট সেভ করতে আপনার নির্ধারিত পদ্ধতিতে authorizationResult পাস করুন। authorizationResult-এর কাছে getAccessToken() পদ্ধতি আছে যা অ্যাক্সেস টোকেন ফেরত পাঠায়।

সার্ভার-সাইড (অফলাইন) অ্যাক্সেস

Android-এ সার্ভার সাইডে Google API কীভাবে অ্যাক্সেস করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

List<Scopes> requestedScopes = Arrays.asList(DriveScopes.DRIVE_APPDATA);
AuthorizationRequest authorizationRequest =
    AuthorizationRequest.builder()
        .requestOfflineAccess(webClientId)
        .setRequestedScopes(requestedScopes)
        .build();
Identity.getAuthorizationClient(activity)
    .authorize(authorizationRequest)
    .addOnSuccessListener(
        authorizationResult -> {
          if (authorizationResult.hasResolution()) {
            // Access needs to be granted by the user
            PendingIntent pendingIntent =
                authorizationResult.getPendingIntent();
            try {
              startIntentSenderForResult(
                  pendingIntent.getIntentSender(),
                  REQUEST_AUTHORIZE, null, 0, 0, 0, null);
            } catch (IntentSender.SendIntentException e) {
              Log.e(
                  TAG,
                  "Couldn't start Authorization UI: "
                      + e.getLocalizedMessage());
            }
          } else {
            String authCode =
                authorizationResult.getServerAuthCode();
          }
        })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to authorize", e));

authorizationResult-এ getServerAuthCode() পদ্ধতি আছে যা অথরাইজেশন কোড রিটার্ন করে। অ্যাক্সেস ও রিফ্রেশ টোকেন পেতে আপনি এটি আপনার ব্যাকএন্ডে পাঠাতে পারেন।

iOS অ্যাপে Google API অ্যাক্সেস করা

ক্লায়েন্ট-সাইড অ্যাক্সেস

নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে iOS-এ ক্লায়েন্ট সাইডে Google API অ্যাক্সেস করবেন।

user.authentication.do { authentication, error in
  guard error == nil else { return }
  guard let authentication = authentication else { return }
  
  // Get the access token to attach it to a REST or gRPC request.
  let accessToken = authentication.accessToken
  
  // Or, get an object that conforms to GTMFetcherAuthorizationProtocol for
  // use with GTMAppAuth and the Google APIs client library.
  let authorizer = authentication.fetcherAuthorizer()
}

API কল করার জন্য অ্যাক্সেস টোকেন ব্যবহার করুন, এর জন্য REST বা gRPC অনুরোধের হেডারে অ্যাক্সেস টোকেন অন্তর্ভুক্ত করুন (Authorization: Bearer ACCESS_TOKEN), অথবা Google APIs client library for Objective-C for REST-এর সাথে ফেচার অথরাইজার (GTMFetcherAuthorizationProtocol) ব্যবহার করুন।

ক্লায়েন্টের দিক থেকে কীভাবে Google API অ্যাক্সেস করতে হয় সেই বিষয়ে ক্লায়েন্টের দিক থেকে অ্যাক্সেস করার নির্দেশিকা পর্যালোচনা করুন।

সার্ভার-সাইড (অফলাইন) অ্যাক্সেস

iOS ক্লায়েন্টকে সহায়তা করার জন্য সার্ভার সাইডে কীভাবে Google API অ্যাক্সেস করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

GIDSignIn.sharedInstance.signIn(
    with: signInConfig, presenting: self
) { user, error in
  guard error == nil else { return }
  guard let user = user else { return }
  
  // request a one-time authorization code that your server exchanges for
  // an access token and refresh token
  let authCode = user.serverAuthCode
}

সার্ভার-সাইড থেকে কীভাবে Google API অ্যাক্সেস করবেন সেই সম্পর্কে সার্ভার-সাইড অ্যাক্সেস গাইড পর্যালোচনা করুন।

Chrome অ্যাপ ক্লায়েন্ট

আপনি যদি নির্ধারণ করেন যে আপনার অ্যাপ Chrome অ্যাপ ক্লায়েন্টে OOB ফ্লো ব্যবহার করছে, তাহলে আপনাকে Chrome Identity API ব্যবহার করার জন্য মাইগ্রেট করতে হবে।

OOB রিডাইরেক্ট URI ব্যবহার না করে কীভাবে সব ব্যবহারকারীর পরিচিতি পাওয়া যায় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

window.onload = function() {
  document.querySelector('button').addEventListener('click', function() {

  
  // retrieve access token
  chrome.identity.getAuthToken({interactive: true}, function(token) {
  
  // ..........


  // the following example shows how to use a retrieved access token with an
  // appropriate scope to call the Google People API contactGroups.get endpoint

  fetch(
    'https://people.googleapis.com/v1/contactGroups/all'
        + '?maxMembers=20&key=API_KEY',
    init)
    .then((response) => response.json())
    .then(function(data) {
      console.log(data)
    });
   });
 });
};

Chrome Identity API-এর মাধ্যমে কীভাবে ব্যবহারকারীদের যাচাইকরণ করবেন এবং Google এন্ডপয়েন্ট কল করবেন সেই সম্পর্কে আরও তথ্যের জন্য Chrome Identity API নির্দেশিকা পর্যালোচনা করুন।

ওয়েব অ্যাপ্লিকেশন

আপনার অ্যাপ কোনও ওয়েব অ্যাপ্লিকেশনের জন্য OOB ফ্লো ব্যবহার করছে বলে আপনি নির্ধারণ করলে, আপনাকে আমাদের Google API ক্লায়েন্ট লাইব্রেরিগুলির মধ্যে কোনও একটিতে মাইগ্রেট করতে হবে। বিভিন্ন প্রোগ্রামিং ল্যাঙ্গুয়েজের জন্য Google API ক্লায়েন্ট লাইব্রেরির তালিকা দেখুন।

লাইব্রেরিগুলি Google API-তে অ্যাক্সেস সহজ করে এবং Google এন্ডপয়েন্টে সমস্ত কল ম্যানেজ করে।

সার্ভার-সাইড (অফলাইন) অ্যাক্সেস

সার্ভার-সাইড (অফলাইন) অ্যাক্সেস মোডের জন্য আপনাকে নিম্নলিখিত কাজগুলি করতে হবে :

  • একটি সার্ভার সেট-আপ করুন এবং অনুমোদন কোড পাওয়ার জন্য সর্বজনীনভাবে অ্যাক্সেসযোগ্য এন্ডপয়েন্ট (রিডাইরেক্ট URI) নির্ধারণ করুন।
  • Google Cloud Console-এর ক্লায়েন্ট পৃষ্ঠায় রিডাইরেক্ট URI কনফিগার করুন

নিম্নলিখিত কোড স্নিপেট NodeJS-এর একটি উদাহরণ দেখায় যেখানে Google Drive API ব্যবহার করে OOB রিডাইরেক্ট URI ব্যবহার না করেই সার্ভার-সাইডে ব্যবহারকারীর Google Drive ফাইলের তালিকা তৈরি করা হয়।

async function main() {
  const server = http.createServer(async function (req, res) {

  if (req.url.startsWith('/oauth2callback')) {
    let q = url.parse(req.url, true).query;

    if (q.error) {
      console.log('Error:' + q.error);
    } else {
      
      // Get access and refresh tokens (if access_type is offline)
      let { tokens } = await oauth2Client.getToken(q.code);
      oauth2Client.setCredentials(tokens);

      // Example of using Google Drive API to list filenames in user's Drive.
      const drive = google.drive('v3');
      drive.files.list({
        auth: oauth2Client,
        pageSize: 10,
        fields: 'nextPageToken, files(id, name)',
      }, (err1, res1) => {
        // TODO(developer): Handle response / error.
      });
    }
  }
}

সার্ভার-সাইড থেকে Google API কীভাবে অ্যাক্সেস করবেন সেই সম্পর্কে সার্ভার-সাইড ওয়েব অ্যাপ গাইড পর্যালোচনা করুন।

ক্লায়েন্ট-সাইড অ্যাক্সেস

JavaScript-এ নিম্নলিখিত কোড স্নিপেট, ক্লায়েন্ট সাইডে ব্যবহারকারীর ক্যালেন্ডার ইভেন্ট অ্যাক্সেস করার জন্য Google API ব্যবহার করার একটি উদাহরণ দেখায়।


// initTokenClient() initializes a new token client with your
// web app's client ID and the scope you need access to

const client = google.accounts.oauth2.initTokenClient({
  client_id: 'YOUR_GOOGLE_CLIENT_ID',
  scope: 'https://www.googleapis.com/auth/calendar.readonly',
  
  // callback function to handle the token response
  callback: (tokenResponse) => {
    if (tokenResponse && tokenResponse.access_token) { 
      gapi.client.setApiKey('YOUR_API_KEY');
      gapi.client.load('calendar', 'v3', listUpcomingEvents);
    }
  },
});

function listUpcomingEvents() {
  gapi.client.calendar.events.list(...);
}

ক্লায়েন্টের দিক থেকে কীভাবে Google API অ্যাক্সেস করতে হয় সেই সম্পর্কে জানতে ক্লায়েন্টের দিক থেকে ওয়েব অ্যাপ গাইড পর্যালোচনা করুন।

ডেস্কটপ ক্লায়েন্ট

আপনার অ্যাপ ডেস্কটপ ক্লায়েন্টে OOB ফ্লো ব্যবহার করছে বলে আপনি নির্ধারণ করলে, আপনাকে লুপব্যাক IP অ্যাড্রেস (localhost বা 127.0.0.1) ফ্লো ব্যবহার করার জন্য মাইগ্রেট করতে হবে।