Mobile Platform as a Service:mPaaS 10.2.3 supports Wireless Security Guard&Blue Shield switch

Background

Wireless Security Guard client SDK and its corresponding image are fundamental dependencies widely used in mPaaS. To improve compatibility across various scenarios and meet stricter compliance requirements, mPaaS offers Blue Shield as an alternative. Blue Shield supports scenarios where Security Guard is not suitable.

Current status

mPaaS supports switching from Security Guard to Blue Shield in iOS baseline versions 10.2.3.25 and later. The necessary adaptations and tests are complete. If you use baseline 10.1.68 or an earlier version, you must upgrade to the latest 10.2.3 version.

Upgrade the baseline

Upgrade the baseline version to 10.2.3.25 or later.

The current baseline is the 10.1.68 main baseline.

First, you must upgrade to the latest 10.2.3 baseline and perform the necessary adaptations. For more information, see Adapt mPaaS 10.2.3 for Xcode14.

Current baseline is a custom baseline

If you use a custom baseline, you can join the DingTalk group by searching for group number 145930007362, or submit a ticket. Contact the technical support to determine if you can switch to the 10.2.3 baseline.

Upgrade methods

Upgrade using CocoaPods

Follow these steps to install the latest SDK for version 10.2.3:

1. First, ensure that the version number of the mPaaS components in your Podfile is 10.2.3.

2. Run the pod mpaas update 10.2.3 command.

   If the command returns an error, you can first update the plugin by running the pod mpaas update --all command, and then run the update command again.

3. Run the pod install command.

Upgrade the toolchain and switch to Blue Shield

Use the mPaaS CocoaPods Plugin

You can use the following command to install or upgrade the plugin:

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

You can use the following command to check the plugin version:

pod plugins installed

In the figure, 0.9.6 is the plugin version. For more information about using the plugin, see Integrate with an existing project using CocoaPods.

Remove Wireless Security Guard component

1. In the Podfile, add remove_pod "mPaaS_Security".

2. If the Podfile contains mPaaS_pod "mPaaS_Security", remove it.

3. To remove Wireless Security Guard image, first delete the yw_1222.jpg image from the project. Then, remove the `base64Code` and `v6Base64Code` fields from the mPaaS configuration file meta.config, if they exist.

Add the Blue Shield component

In the Podfile, add mPaaS_pod "mPaaS_BlueShield".

Generate the Blue Shield image

Add the absBase64Code parameter to the meta.config file and run the `pod install` command using the mPaaS CocoaPods Plugin. As shown in the figure, abs_1222 is the generated Blue Shield image.

Switch to Blue Shield in code

Add a category for MPSignatureInterface and override the securityComponentType method to return MPSecurityComponentTypeBS. In the category for MPSignatureInterface, import the #import <MPSignatureAdapter/MPSignatureAdapter.h> header file.

List of libraries that support Blue Shield updates

• Mobile Gateway Service

• Mobile Scheduling Center

• Mobile Sync Service

• Multimedia

• Mini Program

• Hotpatching

• Big Data Tunnel

• Some internal dependent components

Test and verification scope

After you switch to Blue Shield, you must perform regression testing on your app based on the checklist of changes.