1 Reply Latest reply on Oct 16, 2013 4:45 PM by stu_j_u

    [08/15/2013] iOS7 and Primetime Player SDK 1.0/1.1 Incompatability

    Eric.H Adobe Employee

      [ Background ]

      Adobe Access DRM uses system-level API calls to "bind" DRM licenses to a unique device.  This prevents users from sharing licenses, as device attributes will be different between different devices.  However, beginning with iOS7, Apple has introduced a sandboxing model which prevents access to several lower-level system APIs.  This will cause a problem with iOS applications built form the Adobe PSDK (Primetime Player SDK) versions 1.0 and 1.1, as the APIs required to uniquely identify the device have been made non-usable for DRM purposes.

       

      All iOS7 devices using an iOS application built from the Adobe PSDK 1.0 or 1.1 will have the same "device attributes".  This is a major issue, as license binding to unique devices can no longer be guaranteed.

       

      [ Resolution ]

      Adobe has a resolution to this problem in the Adobe PSDK version 1.2, which has a release date of August 23, 2013 (well before the release of iOS7).  If you have any iOS applications built from the Adobe PSDK 1.0/1.1, please update your PSDK to version 1.2 and re-release your iOS application using the new PSDK.

       

      In addition, please update your license server to disallow issuance of licenses to any application built with the earlier version of the PSDK.

       

      To prevent license issuance to the affected iOS PSDK version if you are using the Adobe Access Reference License Server, please open the "flashaccess-refimpl.properties" configuration file and set the following restriction:

            HandlerConfiguration.DRMModuleRequirements.ExcludedVersions.1=release:4.0, OS:iOS

       

      Doing this will result in a DRMErrorEvent being thrown on the client when it attempts to contact the Adobe Access license server for a license.  The error code will be 3335, with a sub-error-code of 112.  On the client, to respond to this 3335 error, the application should prompt the user to upgrade the iOS app in order to play the video content.

       

      To prevent license issuance to the affected iOS PSDK version if you are using the Adobe Access License Server for Protected Streaming, please open the "flashaccess-tenant.xml" configuration file and update the "DRMModuleRestrictions" XML node accordingly.

       

      [ Ramifications ]

      1. 1. You will not be able to issue licenses to any of your applications built from the PSDK 1.0 or 1.1
      2. 2. You must update your app to handle the DRMErrorEvent code 3335 to prompt the user to update their app.