Procedure to upgrade the Mobile Authenticator iOS SDK

Products

• CA Strong Authentication
• CA Advanced Authentication
• CA Advanced Authentication - Strong Authentication (AuthMinder / WebFort)

Issue/Introduction

Procedure to upgrade the iOS Mobile Authenticator SDK to the latest iOS version without loosing the account enrolled on the application side.

Environment

Symantec Strong Authentication 9.1.x

CA Mobile Authenticator iOS SDK

Cause

 

Resolution

Follow these steps to upgrade the iOS Mobile Authenticator SDK to the latest without loosing the account enrolled on the application side:

Download and Unzip the Latest SDK:

• Obtain the latest version of the ca-mobile-authenticator-iOS-sdk-x.x.x SDK from the provided SDK path.
• Unzip the downloaded ca-mobile-authenticator-iOS-sdk-x.x.x SDK file to extract its contents.

Open Your Xcode Project:

• Launch Xcode.
• Open the workspace or project file for your app.

Locate the Existing SDK Framework:

• In the Xcode project navigator, find the AAFoundation.xcframework in the framework folder.
• Right-click on AAFoundation.xcframework and select Show in Finder.
• This will open a Finder window showing the current path of AAFoundation.xcframework.

Backup and Replace the Framework:

• Back up the existing AAFoundation.xcframework (you can copy it to a different location).
• Replace the existing AAFoundation.xcframework with the newly unzipped version from the latest ca-mobile-authenticator-iOS-sdk-x.x.x SDK

Build and Sign Your App:

• In Xcode, ensure that your app builds successfully with the updated SDK.
• Sign the app using your provisioning profiles and certificates.

Upload to App Store/TestFlight:

• Once the build is successful and signed, proceed to upload the app to the App Store or TestFlight.

Notes:

Database Upgrade: The above steps only upgrade the SDK. The database will not be upgraded or changed unless the user deletes the app.
User information will remain intact as long as the app is not deleted.

This process ensures that your app uses the latest version of the SDK while maintaining existing user data and settings.