mPaaS 10.2.3 supports Wireless Security Guard&Blue Shield switch

This topic describes how to upgrade your baseline and switch from Wireless Security Guard to Blue Shield in mPaaS 10.2.3.

Background

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

Prerequisites

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.

Before you begin, make sure that:

• Your iOS baseline is version 10.2.3.25 or later. If you are on baseline 10.1.68 or an earlier version, upgrade first (see Upgrade the baseline).

• If you use a custom baseline, contact technical support to confirm whether you can switch to the 10.2.3 baseline. Join the DingTalk group (group number 145930007362) or submit a ticket.

Upgrade the baseline

Upgrade to baseline version 10.2.3.25 or later before switching to Blue Shield.

If the current baseline is 10.1.68

First upgrade to the latest 10.2.3 baseline and complete all necessary adaptations. See Adapt mPaaS 10.2.3 for Xcode14.

If the current baseline is a custom baseline

Join the DingTalk group (group number 145930007362) or submit a ticket to confirm with technical support whether you can switch to the 10.2.3 baseline.

Upgrade methods

Upgrade using CocoaPods

Install the latest SDK for version 10.2.3:

1. In your Podfile, set the mPaaS component version to 10.2.3.

2. Run pod mpaas update 10.2.3.

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

3. Run pod install.

Upgrade the toolchain and switch to Blue Shield

Install or upgrade the mPaaS CocoaPods plugin

Run the following command to install or upgrade the plugin:

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

To verify the installed version, run:

pod plugins installed

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

Remove the 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 the Wireless Security Guard image, delete the yw_1222.jpg file from your 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 meta.config and run pod install 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.

Libraries that require regression testing after switching to Blue Shield

The following libraries use Security Guard interfaces and require regression testing after you switch to Blue Shield:

• 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 switching to Blue Shield, run regression testing on your app based on the checklist of changes.