Upgrade guide

About upgrading MobileID

Our MobileID product uses our Encap SCA product, and together they form Mobile Identity.

Our Encap SCA product consists of two components:

• A backend server, hosted and maintained by Signicat.
• A client SDK, that you as the customer integrate into your mobile application.

Backend server

Our MobileID product upgrades its Encap SCA server approximately three times a year. We follow the same release cycle as Encap SCA to ensure that the service is continuously improved and that your security requirements are fulfilled.

Client SDK

It is your responsibility to upgrade the client SDK. We will notify you when a new version of the client SDK is available for upgrade. These upgrades keep you up to date with security improvements and new features.

Want to learn more?

You can also find related information on the MobileID Release notes page.

When should I upgrade?

MobileID supports two-years backwards compatibility between the Encap SCA server and the client SDK.

As MobileID is a security product, we recommend that you aim to run on the latest version of the SDK, and at least upgrade the SDK twice a year so that you do not fall behind. If you do not upgrade in time, then your mobile authentication will stop working.

Upgrade plan

Current version

Our MobileID product currently uses release version 3.20 of the Encap SCA server, and supports Encap SCA client SDK versions 3.15 to 3.20.

The table below shows the preliminary upgrade plan for the MobileID service:

*Future upgrade dates are tentative.

Our recommendation

We recommend upgrading your apps to use the latest Encap SCA client version as soon as possible, even if backwards compatibility indicates that it is possible to keep using the current version.

How do I upgrade?

Accessing the SDKs

If your are adding the SDK to your application for the first time, then see the Getting started pages for Android and iOS.

You need login credentials to access the client SDKs from our Nexus repository. To gain access, contact us by creating a support ticket in the Signicat Dashboard.

Most client SDK upgrades require minimal code changes:

Upgrade Android client SDK

1. Determine if any additional changes are required when upgrading to your desired version. For an overview, see the Versions page in the SDK Android documentation.
2. Update the version number of the dependency in your app's build file.

Upgrade iOS client SDK

1. Determine if any additional changes are required when upgrading to your desired version. For an overview, see the Versions page in the SDK iOS documentation.
2. Navigate to our Nexus repository and enter your Nexus repository login credentials.
3. Download the .zip file corresponding to the desired version, then unzip it.
4. Replace the existing EncapSwiftAPI.xcframework file in your project's directory with the new one that you downloaded.

MobileID status updates

To get email notifications about planned maintenance windows and updates on any activity affecting the MobileID product, you can subscribe to the Signicat status page.

• To configure your subscription for MobileID, you need to select the MobileID component when you set up your subscription.
• If you consume MobileID through our eID hub (OIDC CIBA), then you must also select MobileID (CIBA) under the eID Connections component.