Latar Belakang
SDK client Wireless Security Guard, yang dipasangkan dengan layanan gambar Wireless Security Guard, merupakan salah satu kemampuan dependensi dasar mPaaS dan banyak digunakan di berbagai Produk mPaaS. Untuk meningkatkan kompatibilitas Produk mPaaS dalam berbagai skenario serta memenuhi persyaratan kepatuhan (compliance) yang lebih ketat, mPaaS memperkenalkan Blue Shield sebagai alternatif pengganti Wireless Security Guard guna mendukung skenario di mana kemampuan tersebut mungkin tidak mencukupi.
Status Saat Ini
mPaaS telah menyelesaikan adaptasi dan pengujian yang diperlukan untuk mendukung peralihan dari Wireless Security Guard ke Blue Shield pada versi baseline Android 10.2.3.23 dan yang lebih baru. Jika Anda menggunakan baseline 10.1.68 atau versi sebelumnya, lakukan upgrade ke versi 10.2.3 terbaru.
Upgrade baseline
Upgrade versi baseline ke 10.2.3.23 atau yang lebih baru.
Baseline saat ini: baseline utama 10.1.68
Lihat Panduan Upgrade mPaaS 10.2.3 untuk melakukan upgrade ke baseline 10.2.3 terbaru dan menerapkan adaptasi yang diperlukan.
Baseline saat ini adalah baseline kustom
Jika Anda menggunakan baseline kustom, bergabunglah ke grup DingTalk dengan nomor 145930007362. Alternatifnya, ajukan tiket untuk berkonsultasi dengan staf layanan purnajual dan dukungan teknis kami mengenai kemungkinan beralih ke baseline 10.2.3.
Upgrade rantai alat dan beralih ke Blue Shield
Instal Android Studio Flamingo | 2022.2.1 atau yang lebih baru serta plugin mPaaS 3.0.230609 atau yang lebih baru.
Hapus komponen Wireless Security Guard
Pada file build.gradle dari modul app, hapus library dependensi securityguard-build menggunakan gradle exclude.
configurations.all {
exclude group: 'com.alipay.android.phone.thirdparty', module:
'securityguard-build'
}Tambahkan komponen Blue Shield
Tambahkan dependensi SDK komponen Blue Shield.
implementation 'com.mpaas.android:blueshield'// dependensi SDK Blue ShieldTambahkan dependensi SDK komponen logging.
implementation 'com.mpaas.android:logging'// dependensi SDK komponen loggingUpgrade dependensi plugin easyconfig.
classpath 'com.android.boost.easyconfig:easyconfig:2.8.0'Buat gambar Blue Shield (Opsional)
Periksa apakah absBase64Code dalam file config memiliki nilai. Jika ya, lewati langkah ini. Jika tidak, ikuti petunjuk di bawah ini untuk membuat gambar Blue Shield.
Jika Anda menggunakan lingkungan public cloud dan nilai absBase64Code dalam file .config yang diunduh dari Konsol mPaaS kosong, pastikan Anda telah mengunggah APK yang telah ditandatangani dengan benar sebelum mengunduh file tersebut. Kemudian, unduh kembali file tersebut. Untuk informasi selengkapnya, lihat Isi informasi konfigurasi dan unggah APK yang telah ditandatangani.
Ikuti langkah-langkah yang ditunjukkan pada gambar di bawah ini dan masukkan informasi yang diperlukan untuk membuat gambar Blue Shield:


Penjelasan item input utama pada gambar:
Release Apk : Paket release APK yang dikemas oleh Proyek mPaaS; pastikan paket tersebut telah ditandatangani.
MD5: Setelah paket release APK diunggah, nilai ini akan diisi secara otomatis, yaitu
kunci md5 publikdari paket APK.mPaaS config File: Klik Download Configuration di Konsol mPaaS untuk mengunduh file .config dan impor file tersebut.
appSecret: Lihat di Konsol mPaaS, seperti yang ditunjukkan pada gambar berikut.

Item lain seperti appId, packageName, dan outPath akan secara otomatis dikenali dan diisi setelah informasi di atas dimasukkan.
Akhirnya, tambahkan gambar yang dihasilkan ke folder assets proyek Anda.
Periksa apakah gambar Blue Shield berhasil dikonfigurasi
Seret paket APK ke Android Studio untuk memeriksa keberadaan file abs_1222.jpg di direktori assets APK. Jika file tersebut ada, konfigurasi gambar Blue Shield telah berhasil.

Konfigurasikan peralihan ke Blue Shield
Tambahkan meta-data ke file AndroidManifest.xml.
<!--Deskripsi nilai: antGroup menentukan Blue Shield-->
<meta-data
android:name="mpaas_security_mode"
android:value="antGroup"/>Opsi mpaas_security_mode digunakan untuk tool penandatanganan RPC.
Daftar library yang mendukung pembaruan Blue Shield
Mobile Gateway Service
Mobile Scheduling Center
Mobile Sync Service
Multimedia
Mini Program
Location Service
Unified Storage
Beberapa komponen dependen internal
Ant Dynamic Card
Cakupan validasi pengujian
Setelah beralih ke Blue Shield, gunakan daftar perubahan di atas untuk melakukan pengujian regresi pada Aplikasi.