পরিধানযোগ্য উপর প্রমাণীকরণ

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

এই নির্দেশিকাটি Wear OS অ্যাপগুলির জন্য প্রস্তাবিত প্রমাণীকরণ পদ্ধতিগুলির পাশাপাশি বিকল্পগুলিকে কভার করে যখন সেই পদ্ধতিগুলি কোনও অ্যাপের ব্যবহারের ক্ষেত্রে খাপ খায় না৷

একটি ভাল সাইন-ইন অভিজ্ঞতা কীভাবে ডিজাইন করবেন সে সম্পর্কে আরও জানতে, সাইন-ইন UX গাইড দেখুন।

অতিথি মোড

সমস্ত কার্যকারিতার জন্য প্রমাণীকরণের প্রয়োজন নেই। পরিবর্তে, ব্যবহারকারীকে সাইন ইন করার প্রয়োজন ছাড়াই যতটা সম্ভব বৈশিষ্ট্য প্রদান করুন৷

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

কিছু ডিভাইস বেশিক্ষণ আনলক থাকতে পারে

Wear OS 5 বা উচ্চতর চালিত সমর্থিত ডিভাইসগুলিতে, ব্যবহারকারী তাদের কব্জিতে ডিভাইসটি পরেছেন কিনা তা সিস্টেম সনাক্ত করে। ব্যবহারকারী যদি কব্জি সনাক্তকরণ বন্ধ করে দেয় এবং তারপরে তাদের কব্জি থেকে ডিভাইসটি সরিয়ে নেয়, তবে সিস্টেমটি অন্যথার চেয়ে দীর্ঘ সময়ের জন্য ডিভাইসটিকে আনলক রাখে।

আপনার অ্যাপের যদি উচ্চ স্তরের নিরাপত্তার প্রয়োজন হয়—যেমন সম্ভাব্য সংবেদনশীল বা ব্যক্তিগত ডেটা প্রদর্শন করার সময়—প্রথমে কব্জি সনাক্তকরণ সক্ষম করা আছে কিনা তা পরীক্ষা করুন:

val wristDetectionEnabled =
        isWristDetectionAutoLockingEnabled(applicationContext)

এই পদ্ধতির রিটার্ন মান false হলে, ব্যবহারকারী-নির্দিষ্ট সামগ্রী প্রদর্শন করার আগে ব্যবহারকারীকে আপনার অ্যাপে একটি অ্যাকাউন্টে সাইন ইন করতে অনুরোধ করুন।

প্রস্তাবিত প্রমাণীকরণ পদ্ধতি

ব্যবহারকারীর প্রমাণীকরণ শংসাপত্রগুলি পেতে স্বতন্ত্র Wear OS অ্যাপগুলিকে সক্ষম করতে নিম্নলিখিত প্রমাণীকরণ পদ্ধতিগুলি ব্যবহার করুন৷

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

ফোন সহচর অ্যাপ পরিধানযোগ্য ডেটা লেয়ার ব্যবহার করে Wear OS অ্যাপে প্রমাণীকরণ ডেটা নিরাপদে স্থানান্তর করতে পারে। বার্তা বা ডেটা আইটেম হিসাবে শংসাপত্র স্থানান্তর.

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

গুরুত্বপূর্ণ: আপনার Wear অ্যাপটিকে অবশ্যই অন্য একটি প্রমাণীকরণ পদ্ধতি অফার করতে হবে, কারণ এই বিকল্পটি শুধুমাত্র Android-পেয়ার করা ঘড়িতে কাজ করে যখন সংশ্লিষ্ট মোবাইল অ্যাপ ইনস্টল করা থাকে। যেসব ব্যবহারকারীদের কাছে সংশ্লিষ্ট মোবাইল অ্যাপ নেই বা যাদের Wear OS ডিভাইস একটি iOS ডিভাইসের সাথে পেয়ার করা আছে তাদের জন্য একটি বিকল্প প্রমাণীকরণ পদ্ধতি প্রদান করুন।

মোবাইল অ্যাপ থেকে ডেটা লেয়ার ব্যবহার করে টোকেন পাস করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

val token = "..." // Auth token to transmit to the wearable device.
val dataClient: DataClient = Wearable.getDataClient(context)
val putDataReq: PutDataRequest = PutDataMapRequest.create("/auth").run {
    dataMap.putString("token", token)
    asPutDataRequest()
}
val putDataTask: Task<DataItem> = dataClient.putDataItem(putDataReq)

নিম্নলিখিত উদাহরণে দেখানো হিসাবে ঘড়ি অ্যাপে ডেটা পরিবর্তন ইভেন্টগুলির জন্য শুনুন:

val dataClient: DataClient = Wearable.getDataClient(context)
dataClient.addListener{ dataEvents ->
    dataEvents.forEach { event ->
        if (event.type == DataEvent.TYPE_CHANGED) {
            val dataItemPath = event.dataItem.uri.path ?: ""
            if (dataItemPath.startsWith("/auth")) {
                val token = DataMapItem.fromDataItem(event.dataItem).dataMap.getString("token")
                // Display interstitial screen to notify the user they are being signed in.
                // Then, store the token and use it in network requests.
            }
        }
    }
}

পরিধানযোগ্য ডেটা লেয়ার ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, Wear OS-এ ডেটা পাঠান এবং সিঙ্ক করুন দেখুন।

OAuth 2.0 ব্যবহার করুন

Wear OS দুটি OAuth 2.0-ভিত্তিক ফ্লোকে সমর্থন করে, যা অনুসরণ করা বিভাগগুলিতে বর্ণনা করা হয়েছে:

• RFC 7636 -এ সংজ্ঞায়িত কোড এক্সচেঞ্জ (PKCE) এর জন্য প্রুফ কী সহ অনুমোদন কোড অনুদান
• ডিভাইস অনুমোদন অনুদান, যেমন RFC 8628 এ সংজ্ঞায়িত করা হয়েছে

দ্রষ্টব্য: ঘড়িটি অ্যাম্বিয়েন্ট মোডে চলে গেলে আপনার অ্যাপ বন্ধ না হয়ে যায় তা নিশ্চিত করতে সহায়তা করার জন্য AmbientModeSupport.attach অ্যাক্টিভিটি প্রমাণীকরণে ব্যবহার করে সবসময় চালু করুন। অ্যাম্বিয়েন্ট মোডে সেরা অনুশীলন সম্পর্কে আরও তথ্যের জন্য, Wear-এ আপনার অ্যাপকে দৃশ্যমান রাখুন দেখুন।

কোড এক্সচেঞ্জের জন্য প্রমাণ কী (PKCE)

PKCE কার্যকরভাবে ব্যবহার করতে, RemoteAuthClient ব্যবহার করুন।

আপনার Wear OS অ্যাপ থেকে OAuth প্রদানকারীর কাছে একটি প্রমাণীকরণের অনুরোধ করতে, একটি OAuthRequest অবজেক্ট তৈরি করুন। এই অবজেক্টটি একটি টোকেন এবং একটি CodeChallenge অবজেক্ট পাওয়ার জন্য আপনার OAuth এন্ডপয়েন্টের একটি URL নিয়ে গঠিত। নিম্নলিখিত কোড একটি প্রমাণীকরণ অনুরোধ তৈরি করার একটি উদাহরণ দেখায়:

val request = OAuthRequest.Builder(this.applicationContext)
    .setAuthProviderUrl(Uri.parse("https://...."))
    .setClientId(clientId)
    .setCodeChallenge(codeChallenge)
    .build()

আপনি অনুমোদনের অনুরোধটি তৈরি করার পরে, sendAuthorizationRequest() পদ্ধতি ব্যবহার করে সঙ্গী অ্যাপে পাঠান:

val client = RemoteAuthClient.create(this)
client.sendAuthorizationRequest(request,
    { command -> command?.run() },
    object : RemoteAuthClient.Callback() {
        override fun onAuthorizationResponse(
            request: OAuthRequest,
            response: OAuthResponse
        ) {
            // Extract the token from the response, store it and use it in network requests.
        }

        override fun onAuthorizationError(errorCode: Int) {
            // Handle error
        }
    }
)

এই অনুরোধটি সহচর অ্যাপে একটি কল ট্রিগার করে, যা ব্যবহারকারীর মোবাইল ফোনে একটি ওয়েব ব্রাউজারে একটি অনুমোদন UI উপস্থাপন করে। OAuth 2.0 প্রদানকারী ব্যবহারকারীকে প্রমাণীকরণ করে এবং অনুরোধকৃত অনুমতির জন্য ব্যবহারকারীর সম্মতি গ্রহণ করে। প্রতিক্রিয়া স্বয়ংক্রিয়ভাবে তৈরি পুনঃনির্দেশ URL এ পাঠানো হয়.

একটি সফল বা ব্যর্থ অনুমোদনের পরে, OAuth 2.0 সার্ভার অনুরোধে নির্দিষ্ট URL-এ পুনঃনির্দেশ করে৷ ব্যবহারকারী যদি অ্যাক্সেস অনুরোধ অনুমোদন করে, তাহলে প্রতিক্রিয়াটিতে একটি অনুমোদন কোড থাকে। ব্যবহারকারী অনুরোধটি অনুমোদন না করলে, প্রতিক্রিয়াটিতে একটি ত্রুটি বার্তা রয়েছে।

প্রতিক্রিয়াটি একটি ক্যোয়ারী স্ট্রিং আকারে এবং নিম্নলিখিত উদাহরণগুলির মতো দেখায়:

  https://wear.googleapis.com/3p_auth/com.your.package.name?code=xyz
  https://wear.googleapis-cn.com/3p_auth/com.your.package.name?code=xyz

এটি একটি পৃষ্ঠা লোড করে যা ব্যবহারকারীকে সহচর অ্যাপে নির্দেশ করে৷ সহচর অ্যাপটি প্রতিক্রিয়া URL যাচাই করে এবং onAuthorizationResponse API ব্যবহার করে তৃতীয় পক্ষের ঘড়ি অ্যাপে প্রতিক্রিয়া রিলে করে।

ঘড়ি অ্যাপ তারপর একটি অ্যাক্সেস টোকেনের জন্য অনুমোদন কোড বিনিময় করতে পারে।

দ্রষ্টব্য: একবার OAuthRequest তৈরি হয়ে গেলে, আপনি redirectUrl অ্যাক্সেস করে আপনার পুনঃনির্দেশ URL খুঁজে পেতে পারেন।

ডিভাইস অনুমোদন অনুদান

ডিভাইস অনুমোদন অনুদান ব্যবহার করার সময়, ব্যবহারকারী অন্য ডিভাইসে যাচাইকরণ URI খোলে। তারপর অনুমোদন সার্ভার তাদের অনুরোধ অনুমোদন বা অস্বীকার করতে বলে।

এই প্রক্রিয়াটিকে আরও সহজ করতে, ব্যবহারকারীর পেয়ার করা মোবাইল ডিভাইসে একটি ওয়েব পৃষ্ঠা খুলতে একটি RemoteActivityHelper ব্যবহার করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

// Request access from the authorization server and receive Device Authorization Response.
val verificationUri = "..." // Extracted from the Device Authorization Response.
RemoteActivityHelper.startRemoteActivity(
    this,
    Intent(Intent.ACTION_VIEW)
        .addCategory(Intent.CATEGORY_BROWSABLE)
        .setData(Uri.parse(verificationUri)),
    null
)
// Poll the authorization server to find out if the user completed the user authorization
// step on their mobile device.

আপনার যদি একটি iOS অ্যাপ থাকে, তাহলে টোকেন অনুমোদন করার জন্য ব্রাউজারের উপর নির্ভর না করে আপনার অ্যাপে এই অভিপ্রায়টি আটকাতে সর্বজনীন লিঙ্কগুলি ব্যবহার করুন৷

অন্যান্য প্রমাণীকরণ পদ্ধতি

Wear OS অতিরিক্ত সাইন-ইন পদ্ধতি সমর্থন করে, যা নিম্নলিখিত বিভাগে বর্ণিত হয়েছে।

Google সাইন-ইন

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

পূর্বে বর্ণিত প্রস্তাবিত প্রমাণীকরণ পদ্ধতির পরে, Google সাইন-ইন হল পরবর্তী পছন্দের সমাধান কারণ এটি iOS এও ভাল কাজ করে। নিম্নলিখিত বিভাগটি বর্ণনা করে কিভাবে একটি মৌলিক Google সাইন-ইন ইন্টিগ্রেশন সম্পূর্ণ করতে হয়।

পূর্বশর্ত

আপনার Wear OS অ্যাপে Google সাইন-ইন সংহত করা শুরু করার আগে, আপনাকে অবশ্যই একটি Google API কনসোল প্রজেক্ট কনফিগার করতে হবে এবং আপনার Android Studio প্রোজেক্ট সেট আপ করতে হবে। আরও তথ্যের জন্য, আপনার Android অ্যাপে Google সাইন-ইন ইন্টিগ্রেট করা শুরু করুন দেখুন।

আপনি যদি ব্যাকএন্ড সার্ভারের সাথে যোগাযোগ করে এমন একটি অ্যাপ বা সাইটের সাথে Google সাইন-ইন ব্যবহার করেন, তাহলে দুটি অতিরিক্ত পূর্বশর্ত রয়েছে:

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

আপনার অ্যাপে Google সাইন-ইন সংহত করুন

আপনার Wear OS অ্যাপে Google সাইন-ইন সংহত করার জন্য নিম্নলিখিত ধাপগুলি পর্যালোচনা করুন এবং প্রয়োগ করুন, যা অনুসরণ করা বিভাগগুলিতে বিশদ বিবরণ রয়েছে:

1. Google সাইন-ইন কনফিগার করুন ।
2. একটি Google সাইন-ইন বোতাম যোগ করুন ।
3. সাইন-ইন বোতামটি আলতো চাপলে সাইন-ইন প্রবাহ শুরু করুন ।

Google সাইন-ইন কনফিগার করুন এবং GoogleApiClient অবজেক্ট তৈরি করুন

আপনার সাইন-ইন কার্যকলাপের onCreate() পদ্ধতিতে, আপনার অ্যাপের জন্য প্রয়োজনীয় ব্যবহারকারীর ডেটার অনুরোধ করতে Google সাইন-ইন কনফিগার করুন। তারপরে, Google সাইন-ইন API এবং আপনার নির্দিষ্ট করা বিকল্পগুলিতে অ্যাক্সেস সহ একটি GoogleApiClient অবজেক্ট তৈরি করুন৷ এই পদক্ষেপগুলি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

public class MyNewActivity extends AppCompatActivity {

    private static final int RC_SIGN_IN = 9001;

    private GoogleSignInClient mSignInClient;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        GoogleSignInOptions options =
                new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
                        .build();

        mSignInClient = GoogleSignIn.getClient(this, options);
    }
}

আপনার অ্যাপে একটি Google সাইন-ইন বোতাম যোগ করুন

একটি Google সাইন-ইন বোতাম যোগ করতে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

1. আপনার অ্যাপের লেআউটে SignInButton যোগ করুন:

 <com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

2. আপনার অ্যাপের onCreate() পদ্ধতিতে, ট্যাপ করার সময় ব্যবহারকারীকে সাইন ইন করতে আপনার বোতামের OnClickListener নিবন্ধন করুন:

কোটলিন

findViewById<View>(R.id.sign_in_button).setOnClickListener(this)

জাভা

findViewById(R.id.sign_in_button).setOnClickListener(this);

একটি সাইন-ইন অভিপ্রায় তৈরি করুন এবং সাইন-ইন প্রবাহ শুরু করুন৷

getSignInIntent() পদ্ধতিতে সাইন-ইন করার অভিপ্রায় তৈরি করে আপনার onCLick() পদ্ধতিতে সাইন-ইন বোতাম ট্যাপগুলি পরিচালনা করুন। তারপর startActivityForResult() পদ্ধতি দিয়ে অভিপ্রায় শুরু করুন।

Intent intent = mSignInClient.getSignInIntent();
startActivityForResult(intent, RC_SIGN_IN);

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

অবশেষে, কার্যকলাপের onActivityResult পদ্ধতিতে, getSignInResultFromIntent দিয়ে সাইন-ইন ফলাফল পুনরুদ্ধার করুন। আপনি সাইন-ইন ফলাফল পুনরুদ্ধার করার পরে, আপনি isSuccess পদ্ধতি ব্যবহার করে সাইন-ইন সফল হয়েছে কিনা তা পরীক্ষা করতে পারেন। সাইন-ইন সফল হলে, আপনি একটি GoogleSignInAccount অবজেক্ট পেতে getSignInAccount পদ্ধতিতে কল করতে পারেন যাতে সাইন-ইন করা ব্যবহারকারী সম্পর্কে তথ্য থাকে, যেমন ব্যবহারকারীর নাম। এই পদক্ষেপগুলি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    super.onActivityResult(requestCode, resultCode, data)

    // Result returned from launching the Intent from GoogleSignInApi.getSignInIntent(...).
    if (requestCode == RC_SIGN_IN) {
        Auth.GoogleSignInApi.getSignInResultFromIntent(data)?.apply {
            if (isSuccess) {
                // Get account information.
                fullName = signInAccount?.displayName
                mGivenName = signInAccount?.givenName
                mFamilyName = signInAccount?.familyName
                mEmail = signInAccount?.email
            }
        }
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Result returned from launching the Intent from GoogleSignInApi.getSignInIntent(...).
    if (requestCode == RC_SIGN_IN) {
        GoogleSignInResult signInResult = Auth.GoogleSignInApi.getSignInResultFromIntent(data);
        if (signInResult.isSuccess()) {
            GoogleSignInAccount acct = signInResult.getSignInAccount();

            // Get account information.
            fullName = acct.getDisplayName();
            givenName = acct.getGivenName();
            familyName = acct.getFamilyName();
            email = acct.getEmail();
        }
    }
}