Google ব্যবহারকারীর ডেটা অ্যাক্সেস অনুমোদন করুন

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

অ্যাপের চাহিদার উপর ভিত্তি করে প্রমাণীকরণ এবং অনুমোদন কল দুটি পৃথক এবং স্বতন্ত্র প্রবাহ হতে হবে।

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

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

অনুমোদনকে প্রমাণীকরণ থেকে আলাদা করে, আপনি নতুন ব্যবহারকারীদের অতিরিক্ত চাপ এড়াতে পারেন, অথবা ব্যবহারকারীদের কেন তাদের কাছ থেকে নির্দিষ্ট অনুমতি চাওয়া হচ্ছে তা নিয়ে বিভ্রান্তি এড়াতে পারেন।

প্রমাণীকরণের জন্য, আমরা ক্রেডেনশিয়াল ম্যানেজার API ব্যবহার করার পরামর্শ দিই। Google দ্বারা সংরক্ষিত ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন এমন ক্রিয়াকলাপ অনুমোদনের জন্য, আমরা AuthorizationClient ব্যবহার করার পরামর্শ দিই।

আপনার সেট আপ করুন Google Cloud Console প্রকল্প

1. আপনার প্রজেক্টটি খুলুনCloud Console অথবা, আপনার যদি আগে থেকে কোনো প্রজেক্ট না থাকে, তাহলে একটি তৈরি করুন।
2. উপরেBranding page নিশ্চিত করুন যে সমস্ত তথ্য সম্পূর্ণ এবং নির্ভুল।
   1. আপনার অ্যাপের জন্য সঠিক অ্যাপের নাম, অ্যাপ লোগো এবং অ্যাপ হোমপেজ বরাদ্দ করা আছে কিনা তা নিশ্চিত করুন। সাইন আপের সময় সাইন ইন উইথ গুগল সম্মতি স্ক্রিনে এবং তৃতীয় পক্ষের অ্যাপস এবং পরিষেবা স্ক্রিনে ব্যবহারকারীদের কাছে এই মানগুলি উপস্থাপন করা হবে।
   2. আপনার অ্যাপের গোপনীয়তা নীতি এবং পরিষেবার শর্তাবলীর URL গুলি নির্দিষ্ট করেছেন কিনা তা নিশ্চিত করুন।
3. মধ্যেClients page আপনার অ্যাপের জন্য একটি অ্যান্ড্রয়েড ক্লায়েন্ট আইডি তৈরি করুন, যদি আগে থেকে না থাকে। আপনাকে আপনার অ্যাপের প্যাকেজ নেম এবং SHA-1 সিগনেচার উল্লেখ করতে হবে।
   1. যানClients page .
   2. ক্লায়েন্ট তৈরি করুন -এ ক্লিক করুন।
   3. অ্যান্ড্রয়েড অ্যাপ্লিকেশনের ধরণ নির্বাচন করুন।
   4. OAuth ক্লায়েন্টের জন্য একটি নাম লিখুন। এই নামটি আপনার প্রোজেক্টে প্রদর্শিত হবে।Clients page ক্লায়েন্টকে শনাক্ত করতে।
   5. আপনার অ্যান্ড্রয়েড অ্যাপের প্যাকেজ নামটি লিখুন। এই মানটি আপনার AndroidManifest.xml ফাইলের <manifest> এলিমেন্টের package অ্যাট্রিবিউটে নির্ধারিত থাকে।
   6. অ্যাপ ডিস্ট্রিবিউশনের SHA-1 স্বাক্ষরকারী শংসাপত্রের আঙ্গুলের ছাপ লিখুন।
   7. আপনার অ্যাপটি যদি গুগল প্লে-এর অ্যাপ সাইনিং ব্যবহার করে, তাহলে প্লে কনসোলের অ্যাপ সাইনিং পেজ থেকে SHA-1 ফিঙ্গারপ্রিন্টটি কপি করুন।
   8. আপনি যদি নিজের কীস্টোর এবং সাইনিং কী পরিচালনা করেন, তাহলে সার্টিফিকেটের তথ্য সহজে পাঠযোগ্য ফরম্যাটে প্রিন্ট করার জন্য জাভার সাথে অন্তর্ভুক্ত keytool ইউটিলিটিটি ব্যবহার করুন। keytool আউটপুটের ' Certificate fingerprints অংশ থেকে SHA-1 ভ্যালুটি কপি করুন। আরও তথ্যের জন্য Google APIs for Android ডকুমেন্টেশনের 'Authenticating Your Client' অংশটি দেখুন।
   9. (ঐচ্ছিক) আপনার অ্যান্ড্রয়েড অ্যাপ্লিকেশনটির মালিকানা যাচাই করুন ।
4. মধ্যেClients page যদি আগে থেকে তৈরি না করে থাকেন, তাহলে একটি নতুন "ওয়েব অ্যাপ্লিকেশন" ক্লায়েন্ট আইডি তৈরি করুন। আপাতত আপনি "অথরাইজড জাভাস্ক্রিপ্ট অরিজিনস" এবং "অথরাইজড রিডাইরেক্ট ইউআরআই" ফিল্ডগুলো উপেক্ষা করতে পারেন। গুগলের অথেনটিকেশন সার্ভিসের সাথে যোগাযোগের সময় আপনার ব্যাকএন্ড সার্ভারকে শনাক্ত করতে এই ক্লায়েন্ট আইডিটি ব্যবহৃত হবে।
   1. যানClients page .
   2. ক্লায়েন্ট তৈরি করুন -এ ক্লিক করুন।
   3. ওয়েব অ্যাপ্লিকেশনটির ধরন নির্বাচন করুন।

অ্যাপের মালিকানা যাচাই করুন

অ্যাপ ছদ্মবেশের ঝুঁকি কমাতে আপনি আপনার অ্যাপ্লিকেশনের মালিকানা যাচাই করতে পারেন।

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

• আপনি যে অ্যান্ড্রয়েড OAuth ক্লায়েন্টের জন্য যাচাইকরণ সম্পন্ন করছেন, তার প্যাকেজ নাম এবং SHA-1 সাইনিং সার্টিফিকেট ফিঙ্গারপ্রিন্টের সাথে একই প্যাকেজ নাম এবং SHA-1 সাইনিং সার্টিফিকেট ফিঙ্গারপ্রিন্টসহ আপনার একটি অ্যাপ্লিকেশন অবশ্যই গুগল প্লে কনসোলে নিবন্ধিত থাকতে হবে।
• গুগল প্লে কনসোলে অ্যাপটির জন্য আপনার অবশ্যই অ্যাডমিন অনুমতি থাকতে হবে। গুগল প্লে কনসোলে অ্যাক্সেস ব্যবস্থাপনা সম্পর্কে আরও জানুন ।

অ্যান্ড্রয়েড ক্লায়েন্টের ' অ্যাপের মালিকানা যাচাই করুন' (Verify App Ownership) বিভাগে, যাচাইকরণ প্রক্রিয়াটি সম্পন্ন করতে 'মালিকানা যাচাই করুন' (Verify Ownership) বোতামটিতে ক্লিক করুন।

যাচাইকরণ সফল হলে, যাচাইকরণ প্রক্রিয়ার সাফল্য নিশ্চিত করতে একটি বিজ্ঞপ্তি প্রদর্শিত হবে। অন্যথায়, একটি ত্রুটির বার্তা দেখানো হবে।

ব্যর্থ যাচাইকরণ ঠিক করতে, নিম্নলিখিতগুলি চেষ্টা করুন:

• নিশ্চিত করুন যে আপনি যে অ্যাপটি যাচাই করছেন সেটি গুগল প্লে কনসোলে নিবন্ধিত একটি অ্যাপ।
• গুগল প্লে কনসোলে অ্যাপটির জন্য আপনার অ্যাডমিন অনুমতি আছে কিনা, তা নিশ্চিত করুন।

Declare dependencies

আপনার মডিউলের build.gradle ফাইলে, Google Identity Services লাইব্রেরির সর্বশেষ সংস্করণ ব্যবহার করে ডিপেন্ডেন্সিগুলো ঘোষণা করুন।

dependencies {
  // ... other dependencies

  implementation "com.google.android.gms:play-services-auth:21.5.1"
}

ব্যবহারকারীর কার্যকলাপের জন্য প্রয়োজনীয় অনুমতি অনুরোধ করুন

যখনই কোনো ব্যবহারকারী এমন কোনো কাজ করেন যার জন্য অতিরিক্ত স্কোপের প্রয়োজন হয়, তখন AuthorizationClient.authorize() কল করুন। উদাহরণস্বরূপ, যদি কোনো ব্যবহারকারী এমন কোনো কাজ করেন যার জন্য তাদের Drive অ্যাপ স্টোরেজে অ্যাক্সেসের প্রয়োজন হয়, তাহলে নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন:

val requestedScopes: List<Scope> = listOf(DriveScopes.DRIVE_FILE)
val authorizationRequest = AuthorizationRequest.builder()
    .setRequestedScopes(requestedScopes)
    .build()

Identity.getAuthorizationClient(activity)
    .authorize(authorizationRequestBuilder.build())
    .addOnSuccessListener { authorizationResult ->
        if (authorizationResult.hasResolution()) {
            val pendingIntent = authorizationResult.pendingIntent
            // Access needs to be granted by the user
            startAuthorizationIntent.launch(IntentSenderRequest.Builder(pendingIntent!!.intentSender).build())
        } else {
            // Access was previously granted, continue with user action
            saveToDriveAppFolder(authorizationResult);
        }
    }
    .addOnFailureListener { e -> Log.e(TAG, "Failed to authorize", e) }

List<Scopes> requestedScopes = Arrays.asList(DriveScopes.DRIVE_FILE);
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
            startAuthorizationIntent.launch(
                new IntentSenderRequest.Builder(
                    authorizationResult.getPendingIntent().getIntentSender()
                ).build()
            );
        } else {
            // Access was previously granted, continue with user action
            saveToDriveAppFolder(authorizationResult);
        }
    })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to authorize", e));

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

private lateinit var startAuthorizationIntent: ActivityResultLauncher<IntentSenderRequest>

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
): View? {
    // ...
    startAuthorizationIntent =
        registerForActivityResult(ActivityResultContracts.StartIntentSenderForResult()) { activityResult ->
            try {
                // extract the result
                val authorizationResult = Identity.getAuthorizationClient(requireContext())
                    .getAuthorizationResultFromIntent(activityResult.data)
                // continue with user action
                saveToDriveAppFolder(authorizationResult);
            } catch (e: ApiException) {
                // log exception
            }
        }
}

private ActivityResultLauncher<IntentSenderRequest> startAuthorizationIntent;

@Override
public View onCreateView(
    @NonNull LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
// ...
startAuthorizationIntent =
    registerForActivityResult(
        new ActivityResultContracts.StartIntentSenderForResult(),
        activityResult -> {
            try {
            // extract the result
            AuthorizationResult authorizationResult =
                Identity.getAuthorizationClient(requireActivity())
                    .getAuthorizationResultFromIntent(activityResult.getData());
            // continue with user action
            saveToDriveAppFolder(authorizationResult);
            } catch (ApiException e) {
            // log exception
            }
        });
}

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

ব্যবহারকারীর ডেটা বা রিসোর্সের অনুমতি প্রত্যাহার করুন

পূর্বে প্রদত্ত অ্যাক্সেস প্রত্যাহার করতে, AuthorizationClient.revokeAccess() কল করুন। উদাহরণস্বরূপ, যদি ব্যবহারকারী আপনার অ্যাপ থেকে তার অ্যাকাউন্ট মুছে ফেলেন, এবং আপনার অ্যাপকে পূর্বে DriveScopes.DRIVE_FILE এ অ্যাক্সেস দেওয়া হয়ে থাকে, তাহলে অ্যাক্সেসটি প্রত্যাহার করতে নিম্নলিখিত কোডটি ব্যবহার করুন:

val requestedScopes: MutableList<Scope> = mutableListOf(DriveScopes.DRIVE_FILE)
RevokeAccessRequest revokeAccessRequest = RevokeAccessRequest.builder()
    .setAccount(account)
    .setScopes(requestedScopes)
    .build()

Identity.getAuthorizationClient(activity)
    .revokeAccess(revokeAccessRequest)
    .addOnSuccessListener { Log.i(TAG, "Successfully revoked access") }
    .addOnFailureListener { e -> Log.e(TAG, "Failed to revoke access", e) }

List<Scopes> requestedScopes = Arrays.asList(DriveScopes.DRIVE_FILE);
RevokeAccessRequest revokeAccessRequest = RevokeAccessRequest.builder()
    .setAccount(account)
    .setScopes(requestedScopes)
    .build();

Identity.getAuthorizationClient(activity)
    .revokeAccess(revokeAccessRequest)
    .addOnSuccessListener(unused -> Log.i(TAG, "Successfully revoked access"))
    .addOnFailureListener(e -> Log.e(TAG, "Failed to revoke access", e));

টোকেন ক্যাশে পরিষ্কার করুন

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

Identity.getAuthorizationClient(activity)
    .clearToken(ClearTokenRequest.builder().setToken(invalidAccessToken).build())
    .addOnSuccessListener { Log.i(TAG, "Successfully removed the token from the cache") }
    .addOnFailureListener{ e -> Log.e(TAG, "Failed to clear token", e) }

Identity.getAuthorizationClient(activity)
    .clearToken(ClearTokenRequest.builder().setToken(invalidAccessToken).build())
    .addOnSuccessListener(unused -> Log.i(TAG, "Successfully removed the token from the cache"))
    .addOnFailureListener(e -> Log.e(TAG, "Failed to clear the token cache", e));

অনুমোদনের সময় ব্যবহারকারীর তথ্য সংগ্রহ করুন

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

• অনুমোদনের জন্য অনুরোধ করার আগে ক্রেডেনশিয়াল ম্যানেজার এপিআই ব্যবহার করে ব্যবহারকারীকে তাদের গুগল অ্যাকাউন্ট দিয়ে সাইন ইন করান। ক্রেডেনশিয়াল ম্যানেজার থেকে প্রাপ্ত প্রমাণীকরণ প্রতিক্রিয়ায় ব্যবহারকারীর ইমেল ঠিকানার মতো তথ্য অন্তর্ভুক্ত থাকে এবং এটি অ্যাপের ডিফল্ট অ্যাকাউন্ট হিসেবে নির্বাচিত অ্যাকাউন্টটিকে সেট করে দেয়; প্রয়োজন হলে, আপনি আপনার অ্যাপে এই অ্যাকাউন্টটি ট্র্যাক করতে পারেন। পরবর্তী কোনো অনুমোদনের অনুরোধে অ্যাকাউন্টটি ডিফল্ট হিসেবে ব্যবহৃত হয় এবং অনুমোদন প্রক্রিয়ার অ্যাকাউন্ট নির্বাচনের ধাপটি এড়িয়ে যায়। অনুমোদনের জন্য একটি ভিন্ন অ্যাকাউন্ট ব্যবহার করতে, ‘ডিফল্ট নয় এমন অ্যাকাউন্ট থেকে অনুমোদন’ দেখুন।

• আপনার অনুমোদন অনুরোধে, আপনার কাঙ্ক্ষিত স্কোপগুলোর (যেমন, Drive scope ) পাশাপাশি userinfo , profile , এবং openid স্কোপগুলোর জন্যও অনুরোধ করুন। একটি অ্যাক্সেস টোকেন ফেরত আসার পর, আপনার পছন্দের HTTP লাইব্রেরি ব্যবহার করে এবং হেডারে প্রাপ্ত অ্যাক্সেস টোকেনটি অন্তর্ভুক্ত করে OAuth userinfo এন্ডপয়েন্টে (https://www.googleapis.com/oauth2/v3/userinfo) একটি GET HTTP অনুরোধ পাঠিয়ে ব্যবহারকারীর তথ্য সংগ্রহ করুন, যা নিম্নলিখিত curl কমান্ডের সমতুল্য:

  curl -X GET \ "https://www.googleapis.com/oauth2/v1/userinfo?alt=json" \ -H "Authorization: Bearer $TOKEN"
  

  প্রতিক্রিয়াটি হলো UserInfo , যা অনুরোধ করা স্কোপগুলোর মধ্যে সীমাবদ্ধ এবং JSON ফরম্যাটে বিন্যস্ত।

একটি নন-ডিফল্ট অ্যাকাউন্ট থেকে অনুমোদন

আপনি যদি প্রমাণীকরণের জন্য ক্রেডেনশিয়াল ম্যানেজার ব্যবহার করেন এবং AuthorizationClient.authorize() চালান, তাহলে আপনার অ্যাপের ডিফল্ট অ্যাকাউন্টটি ব্যবহারকারীর নির্বাচিত অ্যাকাউন্টে সেট হয়ে যায়। এর মানে হলো, পরবর্তী যেকোনো অনুমোদনের জন্য এই ডিফল্ট অ্যাকাউন্টটিই ব্যবহৃত হবে। অ্যাকাউন্ট সিলেক্টরটি দেখাতে বাধ্য করার জন্য, ক্রেডেনশিয়াল ম্যানেজারের clearCredentialState() API ব্যবহার করে ব্যবহারকারীকে অ্যাপ থেকে সাইন আউট করুন।

ব্যবহারকারীর ডেটাতে নিরবচ্ছিন্ন প্রবেশাধিকার বজায় রাখুন

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

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

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

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

// Ask for offline access during the first authorization request
val authorizationRequest = AuthorizationRequest.builder()
    .setRequestedScopes(requestedScopes)
    .requestOfflineAccess(serverClientId)
    .build()

Identity.getAuthorizationClient(activity)
    .authorize(authorizationRequest)
    .addOnSuccessListener { authorizationResult ->
        startAuthorizationIntent.launch(IntentSenderRequest.Builder(
            pendingIntent!!.intentSender
        ).build())
    }
    .addOnFailureListener { e -> Log.e(TAG, "Failed to authorize", e) }

// Ask for offline access during the first authorization request
AuthorizationRequest authorizationRequest = AuthorizationRequest.builder()
    .setRequestedScopes(requestedScopes)
    .requestOfflineAccess(serverClientId)
    .build();

Identity.getAuthorizationClient(getContext())
    .authorize(authorizationRequest)
    .addOnSuccessListener(authorizationResult -> {
        startAuthorizationIntent.launch(
            new IntentSenderRequest.Builder(
                authorizationResult.getPendingIntent().getIntentSender()
            ).build()
        );
    })
    .addOnFailureListener(e -> Log.e(TAG, "Failed to authorize"));

নিম্নলিখিত কোড স্নিপেটটি ধরে নেয় যে অনুমোদন প্রক্রিয়াটি একটি ফ্র্যাগমেন্ট থেকে শুরু করা হয়েছে।

private lateinit var startAuthorizationIntent: ActivityResultLauncher<IntentSenderRequest>

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?,
): View? {
    // ...
    startAuthorizationIntent =
        registerForActivityResult(ActivityResultContracts.StartIntentSenderForResult()) { activityResult ->
            try {
                val authorizationResult = Identity.getAuthorizationClient(requireContext())
                    .getAuthorizationResultFromIntent(activityResult.data)
                // short-lived access token
                accessToken = authorizationResult.accessToken
                // store the authorization code used for getting a refresh token safely to your app's backend server
                val authCode: String = authorizationResult.serverAuthCode
                storeAuthCodeSafely(authCode)
            } catch (e: ApiException) {
                // log exception
            }
        }
}

private ActivityResultLauncher<IntentSenderRequest> startAuthorizationIntent;

@Override
public View onCreateView(
    @NonNull LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    // ...
    startAuthorizationIntent =
        registerForActivityResult(
            new ActivityResultContracts.StartIntentSenderForResult(),
            activityResult -> {
                try {
                    AuthorizationResult authorizationResult =
                        Identity.getAuthorizationClient(requireActivity())
                            .getAuthorizationResultFromIntent(activityResult.getData());
                    // short-lived access token
                    accessToken = authorizationResult.getAccessToken();
                    // store the authorization code used for getting a refresh token safely to your app's backend server
                    String authCode = authorizationResult.getServerAuthCode()
                    storeAuthCodeSafely(authCode);
                } catch (ApiException e) {
                    // log exception
                }
            });
}