5 February 2015
User level: All
Required Adobe products (retail)
Additional required other products (third-party/labs/open source)
By downloading software from the Adobe website you agree to the terms of our license agreement. Please read it before downloading.
Using a Direct Entitlement service, the apps built with the Adobe Digital Publishing Suite can support user login and grant access (entitlement) to certain folios based on the sign in credentials.
This article will outline the process of starting an entitlement service on your own server that can be used for production apps. Adobe DPS hosts an example entitlement service (same source code found in this article) for proof of concepts only, located at http://dpsapps.adobe.com/entitlement_admin
This PoC entitlement service limits the viewer requests within 24-hour period. For details, see How to Use the Entitlement Service. By the end of this article, you should be able to log into your own entitlement server with a DPS account credentials.
Some of the source codes have to be modified manually, in order for the Direct Entitlement System to communicate with the MySQL database and the Digital Publishing Suite.
$db_host – Enter the MySQL host name
$db_user – Enter the MySQL database username
$db_password – Enter the MySQL database password
$db_name – Enter the name of the MySQL database created previously (default is “entitlement_admin”).
The integrator ID is an ID that the customer provides and submits to an Adobe representative. At runtime, the DPS app sends the Integrator ID to the configuration server and the server searches and returns the direct entitlement service URL to the viewer.
The Service URL contains the following format:
A set of tests has been provided to test the setup of the entitlement service. Please navigate to the setup_check.html from the hosting server. Click on any one of the buttons on the left sidebar to perform the corresponding test. Each check will return an “ok” if successful or an error message if not successful.
The following is a full set of tests.
This will perform the entire test below.
Check if the necessary PHP modules, utilized by the direct entitlement source code, are installed.
Check if the user has updated the settings.php file. By default, the values are commented out, so the users will have to provide their real values.
Check if the direct entitlement database has been successfully created. Check if the direct entitlement database can be accessed with the provided credentials (in settings.php).
Check if the hosting server can access HTTP (unsecured) websites.
Check if the hosting server can access HTTPS (encrypted) websites.
Check if the fulfillment URL (hosted by Adobe) is available. This URL is used for obtaining the list of folios within the given account credentials.
This section will help you tailor the Direct Entitlement service to your own brand. All the images should be placed in the “images” folder within the Direct Entitlement server’s source code folder.
Now that you’ve finished setting up the Direct Entitlement server, you can start granting users and/or groups to your Direct Entitlement service! For more information about how to use the Direct Entitlement service, please see this article.
Comments are currently closed as we migrate to a new commenting system. In the interim, please provide any feedback using our feedback form. Thank you for your patience.