TechNote

LiveCycle Rights Management ES 8.2 exception when older clients request policy updates

Issue

LiveCycle Rights Management ES 8.2 raises an exception when an application using Rights Management ES C++ Client SDK 8.0 requests it to modify a policy that has an encryption method other than 128-bit encryption.

Reason

Rights Management ES 8.2 and later support 256-bit encryption, 128-bit encryption, and no encryption. Rights Management ES 8.0 and earlier support only 128-bit encryption. For all versions of Rights Management ES, policies specify the encryption method.

If Rights Management ES 8.2 receives a request from LiveCycle Rights Management ES C++ Client SDK 8.0 to modify a policy, it responds as follows:

If the policy specifies 128-bit encryption, the server attempts to fulfill the request.
If the policy specifies 256-bit encryption or no encryption, the server responds with an E_CLIENT_VERSION_MISMATCH exception, which has this definition: A constant indicating that the version of the client-side LiveCycle Rights Management ES C++ Client API components is incompatible with the version of the server-side LiveCycle Rights Management ES C++ Client API components (code 517).
This exception is raised regardless of the change requested. That is, even if the client is changing only the policy description, the exception is raised.

Solution

Here are some solutions to avoid triggering this exception:

Ensure that client applications using Rights Management ES C++ Client API 8.0 or earlier modify only policies that specify 128-bit encryption.
Update client applications to use Rights Management ES C++ Client API 8.2.