Skip to main content

iOS SDK

Follow the version release notes on this page for an overview of what is new in all of our supported SDK versions for iOS.

SDK 3.21​

News for release: SDK 3.21

  • Minimum iOS version updated to 15.0.
  • Added new risk parameters SSID, BSSID, Gravity, Magnetometer, IsProxyEnabled, IsVpnEnabled, timeZone, Locale.
    Set SSID/BSSID permissions

    If you enable the SSID and/or BSSID risk parameters, then you must add the necessary entitlement to your application's target in Xcode.

    To learn how to do this, see Wi-Fi information (SSID and BSSID) in our Risk parameters feature documentation.

  • For Recovery, renamed enum entry RecoveryMethod.backup to RecoveryMethod.backupRecoveryCode.
    Breaking change

    This is a breaking change. Replace any occurrences of RecoveryMethod.backup with RecoveryMethod.backupRecoveryCode in your code.

  • Unified the error returned when an authentication method is deactivated locally due to invalidation. Previously clientErrorAuthMethodUnavailable was returned. Now clientErrorAuthMethodNotAllowed is used, to align with Android behaviour.
  • Added error code clientErrorClientDataInvalid, which indicates that the provided client data in the start authentication operation is invalid for one of the following reasons:
    • It exceeds the maximum size of 1024 bytes (UTF-8 encoded).
    • It contains one or more 4-byte UTF-8 characters (this includes most emojis, such as 👍).
  • Removed SDK error code serverErrorAuthenticationRequired.

SDK 3.20​

News for release: SDK 3.20

  • Added new RecoveryMethod for face scan RecoveryMethod.backupServerSideFace(faceScanData: FaceScanData).
  • Added optional field serverSideFaceInit: ServerSideFaceInitResult? into startRecoveryResult.
  • Added new EncapConfig property locationEnabled.
    Want to learn more?

    To learn more, see our Location feature documentation.

  • Removed EncapAPI (Objective-C version).
    Important

    If you are still using this API, then you must start using EncapSwiftAPI instead.

  • Removed error codes serverErrorAlreadyAuthenticated and serverErrorExpiredSession.

SDK 3.19​

News for release: SDK 3.19

  • Updated minimum iOS version to 14.0.
  • Added new AuthMethod for face scan AuthMethod.serverSideFace(faceScanData: FaceScanData?).
    What does this mean?

    This new authentication method has the current primary use case of activating a registration in situations where the end-user has forgotten their PIN and has no valid biometrics.

  • Added new EncapController methods startAddOrUpdate(startAddOrUpdateParameter: StartAddOrUpdateParameter):
    • For use with Server-side face only, use start calls with StartAddOrUpdateParameter(selectedAuthMethod: .serverSideFace(faceScanData: FaceScanData())).
    • For use with clientData, use start calls with StartAddOrUpdateParameter(clientData: String).
  • Removed EncapPushDelegate.
  • Removed support for weak hashing algorithms, such as MD4, MD5 and SHA-1.
  • Removed support for methods:
    • initWithDelegate
    • didFinishLaunchingWithOptions
    • didReceiveRemoteNotification
  • Deprecated startAddOrUpdate(clientData: String).
  • Removed support for authentication method AuthMethod.touchID. Use AuthMethod.strongTouchID instead.

SDK 3.18​

News for release: SDK 3.18

  • Documentation improvements:
    • Restructured to improve usability.
    • Multiple sections have been rewritten.
    • Added new examples which are easier to copy and paste.
  • Removed error code serverErrorAppAttestValidationFailed. If validation of App Attest fails, then serverErrorIncorrectResponse is returned.

SDK 3.17​

News for release: SDK 3.17

  • EncapAPI and EncapSwiftAPI are no longer built with bitcode.
  • Removed Intermediate Push feature.
  • Removed deprecated availableAuthMethods.

SDK 3.16​

News for release: SDK 3.16

  • Minimum iOS version updated to 12.0.
  • Added new feature Client debug data. You can learn more in our feature documentation.
  • Added support for Time Sensitive Notifications, You can learn more in our feature documentation.
  • Added new feature to support Apple App extensions. You can learn more in our feature documentation.
  • Deprecated availableAuthMethods. Use authMethodsForActivation and authMethodsForAuthentication instead.
  • Deprecated EncapDeviceTouchIDAuthParameter and EncapAuthMethodDeviceTouchID. Use EncapAuthMethodDeviceStrongTouchID instead.

SDK 3.15​

News for release: SDK 3.15

  • Added support for arm64-simulator architecture.
  • Added new feature for App attestation. You can learn more in our feature documentation.
  • Simplified push handling with handleNotification(). You can learn more in our Push feature documentation.

SDK 3.14​

News for release: SDK 3.14

  • Minimum iOS version updated to 11.0.
  • Added new feature for Geofencing. You can learn more in our feature documentation.
  • All builds contain bitcode.
  • encap-ios-api-obfuscated version is no longer available.
  • Removed Signing feature.

SDK 3.13​

News for release: SDK 3.13

  • Minimum iOS version updated to 10.0.
  • Added APNS_NOTIFICATION_SOUND_ENABLED to Application configuration. If enabled, then the default sound is added to APS payload.
  • EncapToken is used for tokenised operations.
  • Added support for recovering the registration by using iCloud or computer-based backup.
On this page