What's new in the DSAPP SDK

This section provides an overview of changes introduced in the DSAPP SDK to facilitate the integration of the SDK and provide information on backward compatibility.

Version 4.31.0

.NET

The DSAPP Server SDK has been re-factored to modernize and improve the code resulting in a number of code changes. We recommend that you review your integrations to make sure these changes are reflected in your code.

General changes

  • Added the IDSAPPServer interface
  • Replaced the DSAPPServer class with the IDSAPPServer interface
  • Added the DSAPPServerProvider class used to create instance of IDSAPPServer
  • Renamed namespace from Vasco to OneSpan
  • Added C# XML comments

Changes in the DSAPPException class

  • Updated the GetErrorMessage() method to the Message property
  • Updated the GetErrorCode() method to the ErrorCode property

Changes in the EncryptActivationDataResponse class

  • Updated the getSessionKey() method to the SessionKey property
  • Updated the getXFad() method to the XFad property
  • Updated the getXErc() method to the XErc property
  • Updated the getEncryptedNonces() method to the EncryptedNonces property
  • Updated the getEncryptedServerPublicKey() method to the EncryptedServerPublicKey property
  • Updated the getServerInitialVector() method to the ServerInitialVector property
  • Updated the getServerNonce() method to the ServerNonce property

Changes in the EncryptDataResponse class

  • Updated the getServerInitialVector() method to the ServerInitialVector property
  • Updated the getEncryptedData() method to the EncryptedData property

Changes in the GenerateSessionKeyResponse class

  • Updated the getSessionKey() method to the SessionKey property
  • Updated the getEncryptedNonces() method to the EncryptedNonces property
  • Updated the getEncryptedServerPublicKey() method to the EncryptedServerPublicKey property
  • Updated the getServerInitialVector() method to the ServerInitialVector property
  • Updated the getServerNonce() method to the ServerNonce property

Changes in the SRPClientInfoResponse class

  • Updated the GetPasswordVerifier() method to the PasswordVerifier property
  • Updated the GetUserPassword() method to the UserPassword property
  • Updated the GetSalt() method to the Salt property

Changes in the SRPEncryptResponse class

  • Updated the GetEncryptedData() method to the EncryptedData property
  • Updated the GetMac() method to the Mac property
  • Updated the GetEncryptionCounter() method to the EncryptionCounter property

Changes in the SRPServerEphemeralKeyResponse class

  • Updated the GetServerEphemeralPublicKey() method to the ServerEphemeralPublicKey property
  • Updated the GetServerEphemeralPrivateKey() method to the ServerEphemeralPrivateKey property

Changes in the SRPSessionKeyResponse class

  • Updated the GetSessionKey() method to the SessionKey property
  • Updated the GetServerEvidenceMessage() method to the ServerEvidenceMessage property

For more information, see the DSAPP SDK Integration Guide.

Previous versions

Version 4.30.0

.NET

Migrated from .NET Framework to .NET 6.

The SDK has been migrated from .NET Framework to .NET 6 to leverage the upgraded features.

iOS

Bitcode support has been eliminated

Following the deprecation of Bitcode by Apple, we no longer support and have removed all Bitcode from the SDK framework.

Updated C++ API

The former C++ API is now advertised directly inside the umbrella header.

Version 4.29.1

Android

Target API increased to 33

To meet new requirements for apps published on the Google Play Store, the target version of the SDK has been increased to Android 13 with API level 33. This change is needed to avoid APK rejection caused by security issues found with older API versions.

4.29.0

Android

Target API increased to Android 12 (API 31)

To meet new requirements for apps published on the Google Play Store, the target version of the SDK has been increased to Android 12 with API 31. This change is needed to avoid APK rejection caused by security issues found with the older API versions.

Minimum supported version increased to Android 6 (API 23)

The minimum supported version has been increased to fully support new features and devices. Deprecated code has been replaced and simplified to be compatible with API 23 or higher.

iOS

Increased the minimum supported version to iOS 13

The minimum supported version has been increased to fully support all ARM64 devices and SwiftUI features. Deprecated code has been removed and replaced with code fully supporting iOS 13 or higher.

Fixed internal error conversion issues

Error codes converted between Objective-C and Swift need to have the NSCustomError setting implemented to display the correct value. Without this setting, the wrong codes could be displayed from the enum. The setting has been implemented in all the remaining error handling objects.

Version 4.28.1

Android

Delivering AAR file instead of JAR

AAR files are the current standard for Android libraries. For this reason, the JAR file has been replaced with an AAR file. for more information, see Android or refer to the sample included in the product package.

iOS

API updates – NSErrors API support for Objective-C added

The Objective-C API points no longer throw an NSException. All API points that previously would throw such an NSException now require an NSError pointer. If an error occurs, it will be attached to the pointer that is provided as a parameter. Refer to the Objective-C sample included in the product package for full code examples.

Change of framework name to MSSDSAPPClient

The framework name has been changed from DSAPP_Client to MSSDSAPPClient. To use the new Objective-C API, replace all previous DSAPP_Client imports with #import <MSSDSAPPClient/DSAPPClient.h>. The name of the main class is DSAPPClientObjC.