Google সিস্টেম সার্ভিস APK ট্রান্সপারেন্সি সম্পূর্ণ যাচাইকরণ

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

যাচাইকরণ পদ্ধতি

ট্রান্সপারেন্সি লগ হ্যাশ সহ Merkle ট্রি-এর মাধ্যমে প্রয়োগ করা হয়। লিফ নোডে ডেটা থাকে এবং পেরেন্ট নোডে তার চাইল্ডের হ্যাশ থাকে।

মূলত, ট্রান্সপারেন্সি লগের টেম্পার-এভিডেন্ট প্রপার্টি যাচাই করার জন্য Merkle ট্রিতে দুটি গণনা করা হয়: ইনক্লুশন প্রুফ এবং কনসিস্টেন্সি প্রুফ। প্রথমটি প্রমাণ করে যে লগে নির্দিষ্ট APK ভার্সনের সাথে সংশ্লিষ্ট এন্ট্রি আছে। লগ এন্ট্রিতে একটি হ্যাশ অন্তর্ভুক্ত থাকে, যা JSON ওয়েব টোকেন (JWT) হিসেবে কোড সিগনেচার টোকেনের SHA256 ডাইজেস্ট, যা সংশ্লিষ্ট APK থেকে পাওয়া যেতে পারে। পরেরটি প্রমাণ করে যে ট্রি-তে নতুন এন্ট্রি যোগ করা হলে, নতুন চেকপয়েন্টটি (ক্রিপ্টোগ্রাফিকভাবে) ট্রি-এর আগের ভার্সনের সাথে সামঞ্জস্যপূর্ণ।

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

আপনার ডিভাইসে থাকা APK, দাবিদার মডেলে করা দাবির সাথে সামঞ্জস্যপূর্ণ কিনা তা নিশ্চিত করতে চাইলে, নিচে দেওয়া লেখাটি পড়ুন।

ইনক্লুশন প্রুফ

Android ব্যবহারকারী তার ডিভাইসে কভার করা APK লগে আছে কিনা তা চেক করতে পারবেন। প্রথমে APK ও তার প্রাসঙ্গিক মেটাডেটা এক্সট্র্যাক্ট করে, তারপর সেটির পুনরায় গণনা করা রুট হ্যাশ প্রকাশিত চেকপয়েন্টে থাকা রুট হ্যাশের সাথে তুলনা করে এটি করা যায়। যদি সেগুলি মিলে যায়, তাহলে Android ব্যবহারকারী থ্রেট মডেলে বর্ণনা করা কিছু সুরক্ষা সম্পর্কে নিশ্চিত হতে পারেন।

লগে APK অন্তর্ভুক্তকরণ কীভাবে যাচাই করবেন

আগে যেমন বলা হয়েছে, বর্তমানে কভার করা APK-এর তালিকা ওভারভিউ পৃষ্ঠায় দেখতে পাবেন।

যাচাইকরণের পূর্বশর্ত

আর্টিফ্যাক্ট (ফার্মওয়্যার বা APK) দাবির সাথে সামঞ্জস্যপূর্ণ কিনা তা যাচাই করার আগে, নিশ্চিত করুন যে নেটওয়ার্ক-কানেক্টেড কম্পিউটারে নিম্নলিখিত টুলগুলি উপলভ্য আছে। যাচাইকরণের লক্ষ্যের উপর নির্ভর করে, আপনার সবকটি নাও লাগতে পারে।

Golang

যাচাইকরণ টুল Go-তে লেখা হয়েছে। এটি তৈরি করতে, Go সাইট থেকে Go 1.24 বা তার পরবর্তী ভার্সন ইনস্টল করুন।

Android ডিবাগ ব্রিজ (ADB)

ADB হল এমন একটি টুল যা Android ডিভাইসের সাথে যোগাযোগ করে ছবি পরীক্ষা করে বা APK এক্সট্র্যাক্ট করে, এটি Android SDK প্ল্যাটফর্ম টুল ওয়েবসাইটে উপলভ্য।

ইনক্লুশন প্রুফ যাচাইকারী

ইনক্লুশন প্রুফ ভেরিফায়ার হল একটি 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 Build Tools ভার্সন 26.0.2 এবং তার পরবর্তী ভার্সনে স্ট্যান্ডঅ্যালোন টুল হিসেবে পাওয়া যাবে।

bundletool

bundletool হল Android অ্যাপ বান্ডেল (AAB) তৈরি করার টুল। এছাড়াও, এটি APK কোড সিগনেচার যাচাই করতে ব্যবহার করা যেতে পারে। এটি GitHub থেকে ডাউনলোড করা যাবে।

wget বা curl

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

Avbtool

avbtool ফ্যাক্টরি ইমেজের VBMeta ডাইজেস্ট গণনা করতে এবং বাইনারি যাচাই করতে ব্যবহার করা হয়। avb রিপোজিটরি ক্লোন করার পরে (ইনক্লুশন প্রুফ যাচাইকারী বিভাগে যেমন দেখানো হয়েছে), ক্লোন করা avb ডিরেক্টরির মধ্যে avbtool.py পাওয়া যাবে। আপনার $PATH এনভায়রনমেন্ট ভেরিয়েবলে এই ডিরেক্টরি যোগ করা উচিত।

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool হল একটি Python স্ক্রিপ্ট যা Pixel-এর bootloader.img-এ স্বতন্ত্র কম্পোনেন্ট আনপ্যাক করতে ব্যবহৃত হয়। আপনি APK যাচাই করলে, এটি করার প্রয়োজন নেই। এই টুলটি গুরুত্বপূর্ণ কারণ এটি avbtool.py-কে যাচাইকরণের জন্য প্রয়োজনীয় ছবি খুঁজে পেতে দেয়।

fbpacktool-এর জন্য Python 3.6 বা তার পরবর্তী ভার্সন এবং PyYAML প্যাকেজ (যেমন, python3 -m pip install pyyaml) প্রয়োজন।

এই টুল ব্যবহার করতে, আপনাকে নিম্নলিখিত ছয়টি পাইথন স্ক্রিপ্ট আপনার avbtool.py যেখানে আছে সেই ডিরেক্টরিতে ডাউনলোড করতে হবে, fbpacktool.py এক্সিকিউটেবল করতে হবে, এবং সুবিধার জন্য fbpacktool.py-এ fbpacktool নামের একটি সিমলিঙ্ক তৈরি করতে হবে।

আপনার কাছে 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 ডিবাগিং চালু করে নিশ্চিত করুন যে আপনার ডিভাইসে 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 আসলে এক বিশেষ ধরনের জিপ ফাইল।

computer:/tmp/testdir$ mkdir extracted && unzip contactkeys_candidate.apk -d extracted/

এই ধাপে APK-তে থাকা সব ফাইল আনপ্যাক করা হয়। প্যাকেজের নাম ও ভার্সন APK-এর ম্যানিফেস্টে পাওয়া যাবে, যা সাধারণত AndroidManifest.xml নামের ফাইলে থাকে।

তবে, প্রাপ্ত ম্যানিফেস্ট ফাইলটি বাইনারি ফর্মে থাকে, যা মানুষের পক্ষে পড়া সম্ভব নয়। বাইনারি 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-এর মধ্যে কোডের স্বচ্ছতা সংক্রান্ত স্বাক্ষর খুঁজব। এটি APK থেকে এক্সট্র্যাক্ট করা অন্যান্য ফাইলের মধ্যে META-INF ফোল্ডারে থাকা code_transparency_signed.jwt নামের ফাইল হতে হবে।

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 আর্কাইভ তৈরি করতে হবে এবং 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 যদি তা না হয়।