Skip to main content

Master Controller SDK - iOS Swift - v15.16

Release Notes for
KOBIL GmbH
Master Controller SDK - iOS
These notes are for internal and external usage

Requirements for current version​

Operating system (Standard Support): v18.7, v26.x
Operating system (Purchased Extended Support):v17.7, v18.7, v26.x
SSMS: v3.7.x, v3.9.x
KOBIL Shift charts: 0.208.0+
KOBIL IDP: core 5.2.1+, core 4.29.0+
Development environment: Xcode v26.1. The developer is advised to follow Apple's requirements for App Store submission.

  • Note: The SDK does not support App-Thinning. To prevent error messages it is necessary to change the Build-Setting flag 'Enable Bitcode' to 'No'. This blocks the reduction of the binary codes, not the reduction of the GUI resources.

Test notes​

Tested updates from MC SDK (KOBIL Digitanium, KOBIL Digitanium+): 15.10, 15.11, 15.12, 15.13, 15.14, 15.15
Tested updates from MC SDK (KOBIL Shift): 15.10, 15.11, 15.12, 15.13, 15.14, 15.15
NOTE: Update from mAST MS8b SDK to MC SDK is no longer tested from MC SDK 15.13 release onwards.
NOTE: KOBIL explicitly tests the MC SDK only against HTTP2.

Documentation​

See https://developer.kobil.com/docs/mcsdk-docs/introduction/kobil_app_security

Notes for SSL​

  • The AST protocol used in communication between clients and SSMS uses ciphers defined by OpenSSL 3.5 with "HIGH:!SSLv2:!SSLv3:!TLSv1:!aNULL:!eNULL:!3DES:@STRENGTH" (Contains ciphers for TLS v1.3 protocol, but tests have only been done with TLS v1.2): TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-CCM:DHE-RSA-AES256-CCM:ECDHE-ECDSA-ARIA256-GCM-SHA384:ECDHE-ARIA256-GCM-SHA384:DHE-DSS-ARIA256-GCM-SHA384:DHE-RSA-ARIA256-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:ECDHE-ECDSA-CAMELLIA256-SHA384:ECDHE-RSA-CAMELLIA256-SHA384:DHE-RSA-CAMELLIA256-SHA256:DHE-DSS-CAMELLIA256-SHA256:AES256-GCM-SHA384:AES256-CCM:ARIA256-GCM-SHA384:AES256-SHA256:CAMELLIA256-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-CCM:DHE-RSA-AES128-CCM:ECDHE-ECDSA-ARIA128-GCM-SHA256:ECDHE-ARIA128-GCM-SHA256:DHE-DSS-ARIA128-GCM-SHA256:DHE-RSA-ARIA128-GCM-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:ECDHE-ECDSA-CAMELLIA128-SHA256:ECDHE-RSA-CAMELLIA128-SHA256:DHE-RSA-CAMELLIA128-SHA256:DHE-DSS-CAMELLIA128-SHA256:AES128-GCM-SHA256:AES128-CCM:ARIA128-GCM-SHA256:AES128-SHA256:CAMELLIA128-SHA256
  • Compared to previous releases (up to and including 15.15), this disallows the suites involving AES in "CCM-8" mode, i.e. in CCM mode with shorter (8 byte) integrity check values.

Known issues​

  • Digitanium Offline Function OTP: If MC triggers a RestartEvent internally i.e app will get a RestartResultEvent over the event bus (this can happen for example if there is some RuntimeErrorEvent), then the offline functions won't be supported and to mitigate the issue the app just needs to trigger a RestartEvent with the correct mc_config and offline functions will be available again.