इस पेज पर, यह पक्का करने के अलग-अलग तरीके बताए गए हैं कि आपके Android डिवाइस पर इंस्टॉल किया गया APK, दावेदार मॉडल में किए गए दावे के मुताबिक है. इसके लिए, आपके डिवाइस से उस APK को निकाला जाता है जिसकी जांच करनी है. इसके बाद, उसके कोड की इंटेग्रिटी की जांच की जाती है. साथ ही, निकाले गए आर्टफ़ैक्ट पर लॉग शामिल करने का सबूत दिया जाता है.
पुष्टि की प्रक्रिया
पारदर्शिता लॉग को हैश वाले मर्कल ट्री के साथ लागू किया जाता है. लीफ नोड में डेटा होता है और पैरंट नोड में उसके चाइल्ड नोड का हैश होता है.
मर्कल ट्री पर दो तरह की गणनाएं की जाती हैं, ताकि यह पुष्टि की जा सके कि पारदर्शिता लॉग में मौजूद डेटा के साथ छेड़छाड़ नहीं की गई है. ये गणनाएं हैं: डेटा शामिल होने का सबूत और डेटा में एकरूपता का सबूत. पहले तरीके से यह साबित होता है कि लॉग में किसी खास APK वर्शन से जुड़ी एंट्री शामिल है. लॉग एंट्री में एक हैश शामिल होता है. यह JSON वेब टोकन (JWT) के तौर पर, कोड सिग्नेचर टोकन का SHA256 डाइजेस्ट होता है. इसे संबंधित APK से हासिल किया जा सकता है. इससे यह साबित होता है कि ट्री में नई एंट्री जोड़ने पर, नया चेकपॉइंट (क्रिप्टोग्राफ़िक तरीके से) ट्री के पिछले वर्शन के मुताबिक होता है.
कवर किए गए APK की पुष्टि करने के लिए, इंक्लूज़न प्रूफ़ टेस्ट करें. यह टेस्ट, पुष्टि किए गए चेकपॉइंट के आधार पर किया जाता है. ध्यान दें कि हम इस लॉग को सार्वजनिक विटनेस नेटवर्क के साथ इंटिग्रेट करने की योजना बना रहे हैं. इसके लिए, स्टैंडर्ड विटनेस प्रोटोकॉल का इस्तेमाल किया जाएगा. इससे एक विटनेस चेकपॉइंट मिलेगा, जो लॉग की एक जैसी क्वालिटी की गारंटी देता है.
अगर आपको यह पक्का करना है कि आपके डिवाइस पर मौजूद APK, दावेदार मॉडल में किए गए दावे के मुताबिक है, तो यहां दी गई जानकारी पढ़ें.
शामिल किए जाने का सबूत
Android उपयोगकर्ता यह देख सकता है कि उसके डिवाइस पर मौजूद, कवर किया गया APK लॉग में है या नहीं. इसके लिए, उसे पहले APK और उससे जुड़ा मेटाडेटा निकालना होगा. इसके बाद, फिर से कैलकुलेट किए गए रूट हैश की तुलना, पब्लिश किए गए चेकपॉइंट में मौजूद रूट हैश से करनी होगी. अगर दोनों डिवाइसों पर दी गई जानकारी मेल खाती है, तो Android उपयोगकर्ता को थ्रेट मॉडल में बताई गई कुछ सुरक्षा सुविधाएं मिल सकती हैं.
लॉग में APK शामिल होने की पुष्टि करने का तरीका
जैसा कि पहले बताया गया है, फ़िलहाल जिन APK को कवर किया गया है उनकी सूची खास जानकारी वाले पेज पर देखी जा सकती है.
पुष्टि के आवेदन से जुड़ी शर्तें
यह पुष्टि करने से पहले कि आर्टफ़ैक्ट (फ़र्मवेयर या APK) दावे के मुताबिक है, पक्का करें कि इंटरनेट से कनेक्ट किए गए कंप्यूटर पर ये टूल उपलब्ध हों. पुष्टि करने के टारगेट के आधार पर, हो सकता है कि आपको इन सभी दस्तावेज़ों की ज़रूरत न पड़े.
Golang
पुष्टि करने वाला टूल Go में लिखा गया है. इसे बनाने के लिए, Go की साइट से Go 1.24 या इसके बाद का वर्शन इंस्टॉल करें.
Android डीबग ब्रिज (एडीबी)
ADB एक ऐसा टूल है जो Android डिवाइस के साथ कम्यूनिकेट करता है, ताकि इमेज की जांच की जा सके या APKs को एक्सट्रैक्ट किया जा सके. यह टूल, Android SDK Platform Tools की वेबसाइट पर उपलब्ध है.
इनक्लूज़न प्रूफ़ की पुष्टि करने वाला टूल
इनक्लूज़न प्रूफ़ वेरिफ़ायर, Go मॉड्यूल है. यह पारदर्शिता लॉग से क्वेरी करता है और आउटपुट देता है कि लॉग में कोई आर्टफ़ैक्ट शामिल है या नहीं.
इसे android-binary-transparency GitHub रिपॉज़िटरी में पब्लिश किया जाता है. यह रिपॉज़िटरी,
https://github.com/android/android-binary-transparency/tree/main पर मौजूद है
AOSP avb डेटाबेस को क्लोन करने के लिए:
computer:~$ git clone https://android.googlesource.com/platform/external/avb
android-binary-transparency GitHub रिपॉज़िटरी का क्लोन बनाने के लिए:
computer:~$ git clone https://github.com/android/android-binary-transparency
AAPT2
AAPT2 (Android ऐसेट पैकेजिंग टूल), एक बिल्ड टूल है. इसका इस्तेमाल, Android ऐप्लिकेशन के संसाधनों को कंपाइल और पैकेज करने के लिए किया जाता है. यह Android SDK बिल्ड टूल के 26.0.2 और इसके बाद के वर्शन में, एक अलग टूल के तौर पर मिल सकता है.
bundletool
bundletool एक ऐसा टूल है जिसका इस्तेमाल Android ऐप्लिकेशन बंडल (एएबी) बनाने के लिए किया जाता है. इसका इस्तेमाल, APK कोड के सिग्नेचर की पुष्टि करने के लिए भी किया जा सकता है.
इसे GitHub से डाउनलोड किया जा सकता है.
wget या curl
wget और curl ऐसे टूल हैं जिनका इस्तेमाल, इंटरनेट से फ़ाइलें वापस पाने या डाउनलोड करने के लिए किया जा सकता है. पक्का करें कि इनमें से कोई एक टूल इंस्टॉल हो, क्योंकि पुष्टि करने वाली स्क्रिप्ट इन पर निर्भर हो सकती हैं.
Avbtool
avbtool का इस्तेमाल, फ़ैक्ट्री इमेज के वीबीमेटा डाइजेस्ट की गिनती करने और बाइनरी की पुष्टि करने के लिए किया जाता है.
avb रिपॉज़िटरी को क्लोन करने के बाद (जैसा कि इंक्लूज़न प्रूफ़ की पुष्टि करने वाले सेक्शन में दिखाया गया है), avbtool.py को क्लोन की गई avb डायरेक्ट्री में ढूंढा जा सकता है.
आपको इस डायरेक्ट्री को अपने $PATH एनवायरमेंट वैरिएबल में जोड़ना चाहिए.
computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL
Fbpacktool
fbpacktool
एक Python स्क्रिप्ट है. इसका इस्तेमाल, Pixel के bootloader.img में मौजूद अलग-अलग कॉम्पोनेंट को अनपैक करने के लिए किया जाता है.
अगर APKs की पुष्टि की जा रही है, तो आपको इसकी ज़रूरत नहीं है.
यह टूल अहम है, क्योंकि इससे avbtool.py को पुष्टि के लिए ज़रूरी इमेज ढूंढने में मदद मिलती है.
fbpacktool के लिए, Python 3.6 या इसके बाद का वर्शन और PyYAML पैकेज ज़रूरी है (उदाहरण के लिए, python3 -m pip install pyyaml).
इस टूल का इस्तेमाल करने के लिए, आपको ये छह Python स्क्रिप्ट डाउनलोड करनी होंगी. इन्हें उस डायरेक्ट्री में डाउनलोड करें जहां आपका avbtool.py मौजूद है. इसके बाद, fbpacktool.py को एक्ज़ीक्यूटेबल बनाएं. साथ ही, सुविधा के लिए fbpacktool नाम का एक सिमलिंक बनाएं, जो fbpacktool.py पर ले जाए.
अगर आपके पास wget है, तो:
computer:dir_to_avbtool$ wget https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpacktool.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpack.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/packedstruct.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlparser.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlserializer.py \
https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/yamlparser.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool
अगर आपके पास curl है, तो:
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpacktool.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/fbpack.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/packedstruct.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlparser.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/xmlserializer.py
computer:dir_to_avbtool$ curl -LO https://developers.google.com/android/binary_transparency/tools/pixel/fbpacktool/yamlparser.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool
OpenSSL
openssl, पुष्टि करने के वर्कफ़्लो में टर्मिनल का इस्तेमाल करके, अलग-अलग क्रिप्टोग्राफ़िक कार्रवाइयां करने में मदद करता है. पक्का करें कि यह आपके सिस्टम पर इंस्टॉल हो. अपने टर्मिनल पर यह कमांड चलाकर देखें और पक्का करें कि नतीजे में कुछ न कुछ ज़रूर दिखे:
computer:~$ which openssl
/usr/bin/openssl
पुष्टि करने के लिए पेलोड बनाना
हमारे दावों के मुताबिक, आपने अपने डिवाइस से जो APK निकाला है उसकी पुष्टि करने के लिए, आपको APK से मिली जानकारी से लॉग पेलोड बनाना होगा.
शुरू करने से पहले, पक्का करें कि आपके डिवाइस पर adb का इस्तेमाल किया जा सकता हो. इसके लिए, अपने डिवाइस पर एडीबी डीबगिंग चालू करें.
इसके बाद, अपने डिवाइस पर APK फ़ाइल ढूंढें. इस गाइड के लिए, हम Android System Key Verifier APK (com.google.android.contactkeys) का इस्तेमाल करेंगे.
computer:~$ adb shell pm list packages -f | grep contactkeys
package:/data/app/~~i5WYSO4PuAAv798-eHdM7A==/com.google.android.contactkeys-PQCKjnn7xDqjeVhcUDibBA==/base.apk=com.google.android.contactkeys
अगर आपके डिवाइस पर Android System Key Verifier APK इंस्टॉल है, तो ऊपर दिया गया कमांड, आपके डिवाइस पर इसके इंस्टॉल होने की जगह का पाथ दिखाएगा. ऐसा न करने पर, आपको कोई आउटपुट नहीं दिखेगा.
इसके बाद, इस निर्देश का इस्तेमाल करके, अपने Android डिवाइस से उस कंप्यूटर पर APK डाउनलोड करें जिस पर काम किया जा रहा है. ध्यान दें कि आपके डिवाइस पर, APK की असल जगह और फ़ाइल नाम अलग-अलग हो सकता है:
computer:~$ mkdir -p /tmp/testdir && cd /tmp/testdir
computer:/tmp/testdir$ adb pull /data/app/~~i5WYSO4PuAAv798-eHdM7A==/com.google.android.contactkeys-PQCKjnn7xDqjeVhcUDibBA==/base.apk ./contactkeys_candidate.apk
आपने जो APK अभी-अभी डाउनलोड किया है उसके पैकेज का नाम पाने और उसकी पुष्टि करने के लिए, आपको पहले APK को अनज़िप करना होगा. ऐसा इसलिए, क्योंकि APK एक खास तरह की ZIP फ़ाइल होती है.
computer:/tmp/testdir$ mkdir extracted && unzip contactkeys_candidate.apk -d extracted/
इस चरण में, APK बनाने वाली सभी फ़ाइलों को अनपैक किया जाता है. पैकेज का नाम और वर्शन, APK के मेनिफ़ेस्ट में मिल सकता है. आम तौर पर, यह AndroidManifest.xml नाम की फ़ाइल में होता है.
हालांकि, मिली मेनिफ़ेस्ट फ़ाइल बाइनरी फ़ॉर्म में होती है. इसे कोई व्यक्ति आसानी से नहीं पढ़ सकता.
बाइनरी एक्सएमएल को किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले फ़ॉर्मैट में बदलने के लिए, हम पहले से इंस्टॉल किए गए aapt2 टूल का इस्तेमाल करते हैं. इसे ज़रूरी शर्तें सेक्शन में इंस्टॉल करना ज़रूरी है.
computer:/tmp/testdir$ aapt2 dump badging ./contactkeys_candidate.apk
package: name='com.google.android.contactkeys' versionCode='7805' versionName='1.219.791156583' platformBuildVersionName='Baklava' platformBuildVersionCode='36' compileSdkVersion='36' compileSdkVersionCodename='Baklava'
ऊपर दिए गए आउटपुट से, अब हमें पक्का पता चल गया है कि इस APK के पैकेज का नाम com.google.android.contactkeys है और वर्शन नंबर (versionCode) 1413 है.
अब हम APK में पारदर्शिता के कोड का सिग्नेचर खोजेंगे. यह code_transparency_signed.jwt नाम की फ़ाइल होनी चाहिए, जो APK से निकाली गई अन्य फ़ाइलों के बीच META-INF फ़ोल्डर में मौजूद हो.
computer:/tmp/testdir$ sha256sum extracted/META-INF/code_transparency_signed.jwt
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11 code_transparency_signed.jwt
इस हैश स्ट्रिंग की मदद से, अब हमारे पास लॉग पेलोड को जोड़ने के लिए ज़रूरी हर जानकारी मौजूद है. यह जानकारी, लॉग कॉन्टेंट सेक्शन में बताए गए फ़ॉर्मैट के मुताबिक है. इस उदाहरण में, लॉग पेलोड कुछ ऐसा दिखेगा:
1779a2aee029112c2c9bfc9390b9678f3e5f4595b39705e8528dd522e8042f11
SHA256(Signed Code Transparency JWT)
com.google.android.contactkeys
1143
पैकेज वर्शन के बाद, नई लाइन वाले वर्ण पर भी ध्यान दें.
कॉन्टेंट को किसी फ़ाइल में सेव किया जा सकता है, जैसे कि payload.txt. यह बाद में, शामिल किए जाने के सबूत की जांच करते समय काम आएगा.
APK कोड के हस्ताक्षर की प्रामाणिकता की पुष्टि करना
अब हमें APK में एम्बेड किए गए कोड सिग्नेचर टोकन की प्रामाणिकता की पुष्टि करनी चाहिए. इसके लिए, हम bundletool और कुंजी के जोड़े के सार्वजनिक पासकोड का इस्तेमाल करते हैं. इस पासकोड का इस्तेमाल, पहली बार साइन इन करने के लिए किया गया था. इन्हें संबंधित APK के हर सेक्शन में पब्लिश किया जाता है. मान लें कि आपने सार्वजनिक पासकोड का सर्टिफ़िकेट (उदाहरण के लिए, Android System Key Verifier के लिए) signing_cert_pubkey.pem नाम की फ़ाइल में सेव किया है. कोड के हस्ताक्षर की पुष्टि करने के लिए, यहां दी गई गाइड देखें.
सबसे पहले, आपको ZIP फ़ॉर्मैट वाला आर्काइव बनाना होगा और उसमें कैंडिडेट APK जोड़ना होगा.
computer:/tmp/testdir$ zip -u test.zip contactkeys_candidate.apk
zip warning: test.zip not found or empty
adding: contactkeys_candidate.apk (deflated 58%)
computer:/tmp/testdir$ file test.zip
test.zip: Zip archive data, at least v2.0 to extract, compression method=deflate
अब हम bundletool के check-transparency कमांड का इस्तेमाल करके, यह पुष्टि कर सकते हैं कि कैंडिडेट APK में एम्बेड किया गया कोड सिग्नेचर, पब्लिश किए गए कोड सिग्नेचर से मेल खाता है या नहीं.
computer:/tmp/testdir$ java -jar BUNDLETOOL_INSTALL_PATH/bundletool-all-version.jar check-transparency \
--mode=apk \
--apk-zip=test.zip \
--transparency-key-certificate=signing_cert_pubkey.pem
APK signature is valid. SHA-256 fingerprint of the apk signing key certificate (must be compared with the developer's public key manually): D9 E1 73 5B 2A 39 51 27 3A 87 35 B7 66 9E F1 9E F5 3A F1 C1 27 5C BA 31 39 3C 18 40 8B 03 79 D0
Code transparency signature verified for the provided code transparency key certificate.
Code transparency verified: code related file contents match the code transparency file.
आपको यह पक्का करना चाहिए कि ऊपर दिए गए निर्देश के आउटपुट में यह बताया गया हो कि पारदर्शिता के कोड के हस्ताक्षर और पारदर्शिता के कोड, दोनों की पुष्टि हो गई है.
अगर ऐसा नहीं है, उदाहरण के लिए, अगर आपको Code transparency verification failed because the provided public key
certificate does not match the transparency file जैसा आउटपुट दिख रहा है, तो इसका मतलब है कि जिस APK की बात की जा रही है उसके कोड की सुरक्षा से समझौता किया गया है. इसलिए, आपको APK पर भरोसा नहीं करना चाहिए.
यह दोबारा जांच लें कि आपने सही सार्वजनिक पासकोड सर्टिफ़िकेट के हिसाब से उनकी पुष्टि की है.
अगर ऐसा नहीं है, तो इसका मतलब है कि जिस APK की पुष्टि की जा रही है उसके लिए कोड सिग्नेचर की पुष्टि हो गई है.
पैकेज शामिल किए जाने की पुष्टि करना (शामिल किए जाने का सबूत)
पहले बनाए गए पेलोड का इस्तेमाल करके, अब यह जांच की जा सकती है कि जिस पैकेज की बात की जा रही है उसे पारदर्शिता लॉग में शामिल किया गया है या नहीं.
Android ओपन सोर्स प्रोजेक्ट में, avb डेटा स्टोर करने की जगह में, शामिल होने का सबूत देने वाला टूल पब्लिश किया गया है. इसे चलाने के लिए:
computer:external/avb/tools/transparency/verify$ PAYLOAD_PATH=PATH_TO_PAYLOAD_DIR/payload.txt
computer:external/avb/tools/transparency/verify$ go build cmd/verifier/verifier.go
computer:external/avb/tools/transparency/verify$ ./verifier --payload_path=${PAYLOAD_PATH} --log_type=google_1p_code
पुष्टि करने वाला टूल, चेकपॉइंट और लॉग के कॉन्टेंट (टाइल डायरेक्ट्री में मौजूद) का इस्तेमाल करके यह जांच करता है कि आपके APK का पेलोड, पारदर्शिता लॉग में मौजूद है या नहीं. इससे यह पुष्टि होती है कि इसे Google ने ही पब्लिश किया है.
निर्देश का आउटपुट, stdout में लिखा जाता है:
OK. inclusion check success!अगर लॉग में पैकेज का कोड शामिल है,- अगर ऐसा नहीं है, तो
FAILURE.