Android 9 (एपीआई लेवल 28) या इसके बाद के वर्शन पर काम करने वाले डिवाइसों पर, Android Protected Confirmation का इस्तेमाल किया जा सकता है. इससे, उपयोगकर्ताओं के किसी संवेदनशील लेन-देन (जैसे, पेमेंट करने) की पुष्टि करने में मदद मिलती है. इस वर्कफ़्लो का इस्तेमाल करने पर, आपका ऐप्लिकेशन लोगों को एक प्रॉम्प्ट दिखाता है. इसमें, उन्हें एक छोटे स्टेटमेंट के लिए अनुमति देने के लिए कहा जाता है. इस तरह, लोगों से संवेदनशील लेन-देन को पूरा करने के उनके इंटेंट की पुष्टि की जाती है.
अगर उपयोगकर्ता स्टेटमेंट स्वीकार करता है, तो आपका ऐप्लिकेशन डायलॉग बॉक्स में दिखाए गए मैसेज पर हस्ताक्षर करने के लिए, Android Keystore में मौजूद किसी पासकोड का इस्तेमाल कर सकता है. हस्ताक्षर बहुत ही पूरे भरोसे के साथ होता है कि उपयोगकर्ता ने स्टेटमेंट देख लिया है और वह उससे सहमत है.
चेतावनी: Android की ओर से पुष्टि किए जाने की सुविधा, उपयोगकर्ता को जानकारी का सुरक्षित चैनल उपलब्ध नहीं कराती है. आपका ऐप्लिकेशन, Android प्लैटफ़ॉर्म के अलावा, गोपनीयता से जुड़ी कोई और गारंटी नहीं दे सकता. खास तौर पर, इस वर्कफ़्लो का इस्तेमाल ऐसी संवेदनशील जानकारी दिखाने के लिए न करें जिसे आम तौर पर उपयोगकर्ता के डिवाइस पर नहीं दिखाया जाता.
उपयोगकर्ता की पुष्टि करने के बाद, मैसेज की पुष्टि हो जाती है. हालांकि, आपके ऐप्लिकेशन को हस्ताक्षर किए गए मैसेज की गोपनीयता बनाए रखने के लिए, अब भी डेटा को ट्रांसफ़र के दौरान एन्क्रिप्ट (सुरक्षित) करने के तरीके का इस्तेमाल करना होगा.
अपने ऐप्लिकेशन में, उपयोगकर्ता की पुष्टि करने के लिए ज़्यादा भरोसेमंद तरीका इस्तेमाल करने की सुविधा देने के लिए, यह तरीका अपनाएं:
KeyGenParameterSpec.Builder
क्लास का इस्तेमाल करके, असिममेट्रिक साइनिंग पासकोड जनरेट करें. पासकोड बनाते समय,true
कोsetUserConfirmationRequired()
में पास करें. साथ ही,setAttestationChallenge()
को कॉल करें और उसमें, भरोसा करने वाली पार्टी की दी गई सही चैलेंज वैल्यू डालें.जनरेट की गई नई कुंजी और उससे जुड़े सर्टिफ़िकेट की पुष्टि करने के सर्टिफ़िकेट को, इस भरोसेमंद पार्टी के साथ रजिस्टर करें.
अपने सर्वर को लेन-देन की जानकारी भेजें. साथ ही, इससे अतिरिक्त डेटा वाला बाइनरी लार्ज ऑब्जेक्ट (बीएलओबी) जनरेट करें और दिखाएं. अतिरिक्त डेटा में, पुष्टि किए जाने वाले डेटा या पार्स करने के सुझाव शामिल हो सकते हैं. जैसे, प्रॉम्प्ट स्ट्रिंग की स्थानीय भाषा.
ज़्यादा सुरक्षित तरीके से लागू करने के लिए, बीएलओबी में एक क्रिप्टोग्राफ़िक नॉन्स शामिल होना चाहिए, ताकि उसे फिर से चलाने वाले हमलों से बचाया जा सके और लेन-देन के बारे में साफ़ तौर पर जानकारी दी जा सके.
ConfirmationCallback
ऑब्जेक्ट सेट अप करें. इससे आपके ऐप्लिकेशन को यह पता चलता है कि उपयोगकर्ता ने पुष्टि करने वाले डायलॉग में दिखाए गए प्रॉम्प्ट को स्वीकार कर लिया है या नहीं:Kotlin
class MyConfirmationCallback : ConfirmationCallback() { override fun onConfirmed(dataThatWasConfirmed: ByteArray?) { super.onConfirmed(dataThatWasConfirmed) // Sign dataThatWasConfirmed using your generated signing key. // By completing this process, you generate a signed statement. } override fun onDismissed() { super.onDismissed() // Handle case where user declined the prompt in the // confirmation dialog. } override fun onCanceled() { super.onCanceled() // Handle case where your app closed the dialog before the user // responded to the prompt. } override fun onError(e: Exception?) { super.onError(e) // Handle the exception that the callback captured. } }
Java
public class MyConfirmationCallback extends ConfirmationCallback { @Override public void onConfirmed(@NonNull byte[] dataThatWasConfirmed) { super.onConfirmed(dataThatWasConfirmed); // Sign dataThatWasConfirmed using your generated signing key. // By completing this process, you generate a signed statement. } @Override public void onDismissed() { super.onDismissed(); // Handle case where user declined the prompt in the // confirmation dialog. } @Override public void onCanceled() { super.onCanceled(); // Handle case where your app closed the dialog before the user // responded to the prompt. } @Override public void onError(Throwable e) { super.onError(e); // Handle the exception that the callback captured. } }
अगर उपयोगकर्ता डायलॉग को स्वीकार करता है, तो
onConfirmed()
कॉलबैक को कॉल किया जाता है.dataThatWasConfirmed
BLOB एक CBOR डेटा स्ट्रक्चर है. इसमें, अन्य जानकारी के साथ-साथ, उपयोगकर्ता को दिखने वाला प्रॉम्प्ट टेक्स्ट औरConfirmationPrompt
बिल्डर में पास किया गया अतिरिक्त डेटा शामिल होता है.dataThatWasConfirmed
BLOB पर हस्ताक्षर करने के लिए, पहले से बनाई गई कुंजी का इस्तेमाल करें. इसके बाद, हस्ताक्षर और लेन-देन की जानकारी के साथ इस BLOB को, भरोसेमंद पक्ष को वापस भेजें.Android की ओर से पुष्टि किए जाने वाले इस तरह के सुरक्षा आश्वासन का पूरा इस्तेमाल करने के लिए, भरोसा करने वाले पक्ष को हस्ताक्षर किया गया मैसेज मिलने के बाद ये चरण पूरे करने होंगे:
- मैसेज पर हस्ताक्षर की जांच करें. साथ ही, हस्ताक्षर करने वाली कुंजी के पुष्टि करने वाले सर्टिफ़िकेट की चेन की जांच करें.
- देखें कि पुष्टि करने के सर्टिफ़िकेट में
TRUSTED_CONFIRMATION_REQUIRED
फ़्लैग सेट है या नहीं. इससे पता चलता है कि साइनिंग पासकोड के लिए, उपयोगकर्ता की भरोसेमंद पुष्टि कराना ज़रूरी है. अगर साइनिंग पासकोड एक आरएसए पासकोड है, तो देखें कि उसमेंPURPOSE_ENCRYPT
याPURPOSE_DECRYPT
प्रॉपर्टी तो नहीं है. extraData
को चुनकर पक्का करें कि पुष्टि करने वाला यह मैसेज, किसी नए अनुरोध से जुड़ा हो और उसकी प्रोसेस अभी तक पूरी न हुई हो. यह चरण, रिप्ले हमलों से बचाता है.- पुष्टि की गई कार्रवाई या अनुरोध के बारे में जानकारी के लिए,
promptText
को पार्स करें. याद रखें कि मैसेज का सिर्फ़promptText
हिस्सा ही ऐसा है जिसकी उपयोगकर्ता ने पुष्टि की है. भरोसा करने वाले पक्ष को यह कभी नहीं मानना चाहिए किextraData
में शामिल किया गया डेटा,promptText
से जुड़ा है.
डायलॉग बॉक्स दिखाने के लिए, नीचे दिए गए कोड स्निपेट में दिख रहे लॉजिक को जोड़ें:
Kotlin
// This data structure varies by app type. This is an example. data class ConfirmationPromptData(val sender: String, val receiver: String, val amount: String) val myExtraData: ByteArray = byteArrayOf() val myDialogData = ConfirmationPromptData("Ashlyn", "Jordan", "$500") val threadReceivingCallback = Executor { runnable -> runnable.run() } val callback = MyConfirmationCallback() val dialog = ConfirmationPrompt.Builder(context) .setPromptText("${myDialogData.sender}, send ${myDialogData.amount} to ${myDialogData.receiver}?") .setExtraData(myExtraData) .build() dialog.presentPrompt(threadReceivingCallback, callback)
Java
// This data structure varies by app type. This is an example. class ConfirmationPromptData { String sender, receiver, amount; ConfirmationPromptData(String sender, String receiver, String amount) { this.sender = sender; this.receiver = receiver; this.amount = amount; } }; final int MY_EXTRA_DATA_LENGTH = 100; byte[] myExtraData = new byte[MY_EXTRA_DATA_LENGTH]; ConfirmationPromptData myDialogData = new ConfirmationPromptData("Ashlyn", "Jordan", "$500"); Executor threadReceivingCallback = Runnable::run; MyConfirmationCallback callback = new MyConfirmationCallback(); ConfirmationPrompt dialog = (new ConfirmationPrompt.Builder(getApplicationContext())) .setPromptText("${myDialogData.sender}, send ${myDialogData.amount} to ${myDialogData.receiver}?") .setExtraData(myExtraData) .build(); dialog.presentPrompt(threadReceivingCallback, callback);
अन्य संसाधन
Android Protected Confirmation के बारे में ज़्यादा जानकारी के लिए, यहां दिए गए रिसॉर्स देखें.