Android 9 (एपीआई लेवल 28) या इसके बाद के वर्शन पर काम करने वाले डिवाइसों पर, Android Protected Confirmation का इस्तेमाल किया जा सकता है. इससे, उपयोगकर्ताओं के किसी संवेदनशील लेन-देन (जैसे, पेमेंट करने) की पुष्टि करने में मदद मिलती है. इस वर्कफ़्लो का इस्तेमाल करने पर, आपका ऐप्लिकेशन उपयोगकर्ता को एक प्रॉम्प्ट दिखाता है. इसमें उपयोगकर्ता से एक छोटे स्टेटमेंट को स्वीकार करने के लिए कहा जाता है. इस स्टेटमेंट से, संवेदनशील लेन-देन को पूरा करने के उनके इंटेंट की पुष्टि होती है.
अगर उपयोगकर्ता स्टेटमेंट स्वीकार करता है, तो आपका ऐप्लिकेशन डायलॉग बॉक्स में दिखाए गए मैसेज पर हस्ताक्षर करने के लिए, Android Keystore में मौजूद किसी पासकोड का इस्तेमाल कर सकता है. हस्ताक्षर से यह पता चलता है कि उपयोगकर्ता ने स्टेटमेंट को पढ़ लिया है और उससे सहमत है.
चेतावनी: Android Protected Confirmation, उपयोगकर्ता को जानकारी का ऐसा चैनल उपलब्ध नहीं कराता है जो पूरी तरह से सुरक्षित हो. आपका ऐप्लिकेशन, Android प्लैटफ़ॉर्म के अलावा, गोपनीयता से जुड़ी कोई और गारंटी नहीं दे सकता. खास तौर पर, इस वर्कफ़्लो का इस्तेमाल ऐसी संवेदनशील जानकारी दिखाने के लिए न करें जिसे आम तौर पर उपयोगकर्ता के डिवाइस पर नहीं दिखाया जाता.
उपयोगकर्ता की पुष्टि करने के बाद, मैसेज की पूरी सुरक्षा की गारंटी मिल जाती है. हालांकि, हस्ताक्षर किए गए मैसेज की गोपनीयता बनाए रखने के लिए, आपके ऐप्लिकेशन को अब भी डेटा को ट्रांसफ़र के दौरान एन्क्रिप्ट (सुरक्षित) करने के तरीके का इस्तेमाल करना होगा.
अपने ऐप्लिकेशन में, उपयोगकर्ता की पुष्टि करने के लिए ज़्यादा भरोसेमंद तरीका इस्तेमाल करने की सुविधा देने के लिए, यह तरीका अपनाएं:
KeyGenParameterSpec.Builder
क्लास का इस्तेमाल करके, असिममेट्रिक साइनिंग पासकोड जनरेट करें. पासकोड बनाते समय,true
कोsetUserConfirmationRequired()
में पास करें. साथ ही,setAttestationChallenge()
को कॉल करें और उसमें, भरोसा करने वाली पार्टी की दी गई सही चैलेंज वैल्यू डालें.हाल ही में जनरेट की गई कुंजी और उसकी पुष्टि करने वाले सर्टिफ़िकेट को, भरोसा करने वाली सही पार्टी के साथ रजिस्टर करें.
अपने सर्वर पर लेन-देन की जानकारी भेजें और उसे ज़्यादा डेटा का बड़ा बाइनरी ऑब्जेक्ट (BLOB) जनरेट करने और उसे दिखाने के लिए कहें. अतिरिक्त डेटा में, पुष्टि किए जाने वाले डेटा या पार्स करने के सुझाव शामिल हो सकते हैं. जैसे, प्रॉम्प्ट स्ट्रिंग की स्थानीय भाषा.
ज़्यादा सुरक्षित तरीके से लागू करने के लिए, BLOB में क्रिप्टोग्राफ़िक वन्सिस्ट (nonce) होना चाहिए. इससे रीप्ले अटैक से सुरक्षा मिलती है और लेन-देन के बीच अंतर किया जा सकता है.
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 Protected Confirmation की मदद से, सुरक्षा के उस भरोसे का पूरा फ़ायदा पाने के लिए जिसे यह सुविधा ऑफ़र करती है, भरोसे पर काम करने वाली पार्टी को हस्ताक्षर वाला मैसेज मिलने पर ये चरण पूरे करने होंगे:
- मैसेज पर हस्ताक्षर की जांच करें. साथ ही, हस्ताक्षर करने वाली कुंजी के पुष्टि करने वाले सर्टिफ़िकेट की चेन की भी जांच करें.
- देखें कि पुष्टि करने वाले सर्टिफ़िकेट में
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 के बारे में ज़्यादा जानकारी के लिए, यहां दिए गए रिसॉर्स देखें.