Editing the Server Configuration File for URMS

To manage Digital Rights Management in your READynamic environment, using the User Rights Management Solution (URMS) file encryption service provided by Sony DADC, you can edit the server_configuration_overrides.yml file.

Open the YML file in the Windows Notepad or the Mac Text Editor. This is a simple text file, so editing the file should be easy. But note that the parameters are already provided in the text. You won’t be adding any new parameters, only changing the options provided.

First you will see a line for “urms:” where your store ID code and your store secret appear.

    store_id: "1050"
    store_secret: "506a1ae29960aaa157cbbe259d948af5dd1a3b89"

Under the “offline downloads” heading the “offline_book_encryption” setting appears. This required setting turns on URMS encryption for the local READynamic environment. Three options are provided, “none,” “urms,” or “atb”:

offline_book_encryption: 'urms' # 'none' or 'atb' or 'urms'
none Encryption is turned off in your READynamic environment. When eBooks are uploaded into READynamic, they will not be encrypted. If you try to assign URMS encryption to an eBook, you will see an error message.
urms URMS encryption is enabled for eBooks. This doesn’t mean that URMS encryption is required; it simply means that the feature is turned on and available for use. If this value is set to “urms” the option to select URMS encryption will appear in the user interface for the READynamic user portal, and you will be able to add URMS encryption to an eBook using an API command statement.
atb ATB refers to a native security tool provided with the software known as READynamic Encryption. This utility encrypts eBook files, as with URMS, and it has the advantage of being provided free with the software.  But READynamic Encryption is not as comprehensive as URMS. URMS provides for secured user accounts and monitors and manages the distribution of eBook files. URMS can also track the ability of individual users to lend eBook titles and their ability to access eBooks through groups.

These two URMS server settings in the yml file define default settings for a READynamic environment where URMS is enabled.

  urms_configurable: false

  default_book_urms_status: true
urms_configurable True or False. Defines whether a user may apply URMS encryption to an individual eBook when uploading that eBook into READynamic.
default_book_urms_status True or False. This defines the default status of the server. If set to true, by default all eBooks that are uploaded in READynamic will be processed with URMS encryption. If set to false, by default none of them will. It is possible for a user to override this setting for an individual eBook or for a bulk upload if “urms_configurable” is set to true.

The settings work together like this:

urms_configurable true Every eBook added to READynamic is processed with URMS encryption by default. But a user will be able to manually turn off this feature for an eBook, so that it can be added to READynamic without URMS encryption.
default_book_urms_status true
urms_configurable true None of the eBooks added to READynamic are processed with URMS encryption. But a user will be able to change this setting and manually apply URMS encryption to an individual eBook.
default_book_urms_status false
urms_configurable false Every eBook added to READynamic is processed with URMS encryption by default. Users will not be able to change this setting for individual eBook files.
default_book_urms_status true
urms_configurable false None of the eBooks added to READynamic are processed with URMS encryption, and no user will be able to apply encryption manually to an individual eBook file.
default_book_urms_status false