STEP 1: Installing a credential for Adobe Document Services
In order to work with Adobe Document Services you need to install a valid credential.
To install a credential perform following steps:
Extract the archive
Copy the file <filename>.pfx to the directory
<INST_DRIVE>:\usr\sap\J2E\SYS\global\AdobeDocumentServices\TrustManagerService\
trust\credentials
Register the password for credential as described below:
Log on to the Visual Administrator (<INST_DRIVE>:\usr\sap\J2E\JC00\j2ee\admin\go.bat)
On the Cluster tab, choose Server 0 -> Services -> Document Services Configuration
On the Runtime tab, select Credentials
Choose Browse to search for the name of the credential and then select
In the Alias field, enter the alias of the credential you installed, for example ReaderRights (Entries for the name of the credential are case-sensitive)
In Password field, enter the password you received together with the credential you installed (filename.txt in the archive). Confirm the password again and then click Add
Restart the following services for the changes to take effect: PDF Manipulation Module, Document Services Trust Manager. To perform this, right-click on the repective service choose Stop and after the service has stopped, Start it again
Restart also the application com.adobe/AdobeDocumentServices located at
Server 0 -> Services -> Deploy (radio button Application)
STEP 2: Creating a User in SAP Netweaver AS Java for Basic Authentication
Use
In some cases the user ADSUser was not created during installation. This user is required for the secure communication between the Web Dynpro application and the Java system where the Adobe document services are installed.
Creating the User ADSUser and Assigning the Security Role
1. Log on to the Visual Administrator.
2. On the Cluster tab, choose Server <x> → Services → Security Provider.
3. On the User Management tab, choose Create Group to create a group called ADSCallers, if the group does not exist. In the dialog that follows, enter the name and choose OK.
4. Choose Create User. The Create New User dialog box is displayed.
5. In the User name, Password, and Confirm password boxes, enter ADSUser for the user name and type a password.
6. Choose the Tree tab in the right panel. In the User Tree, select ADSCallers, and then choose OK.
7. On the Policy Configuration tab, in the Components area, select
com.adobe/AdobeDocumentServices*AdobeDocumentServicesAssembly.jar.
8. On the Security Roles tab, select ADSCaller from the Security Roles list
Note: The ADSCaller security role was created when your system was installed. You should not assign this security role to users other than the system user that you will use for accessing Adobe document services.
9. In the Mappings area, choose Add, which is assigned to Users. A dialog Choose Users or Groups is displayed.
10. Choose the Tree tab.
11. In the User Tree, under the ADSCallers group, select the ADSUser you just created and choose OK. This assigns the new user to the ADSCaller security role
Defining ADSUser as Technical User
To prevent, that the password for the ADSUser expires, do following:
1. Log on to the User Management of your AS Java:
http://<AS Java server> :< http port> → User Management
2. Display the user ADSUser.
3. Choose Modify.
4. In the Security policy field, change the setting from Default to Technical User
5. Save.
STEP 3: Setting Up Basic Authentication in a Java Environment
Use
This procedure applies for the scenario of interactive forms. Set up Basic Authentication to access the Java version of the PDF object. This procedure describes you the configuration steps and applies when the Adobe document services and the Web Dynpro runtime are installed on the same J2EE Engine. Then under Destination the URL is set to Default.
Prerequisites
The user ADSUser was created and configured during installation of Adobe document service.
Procedure
To set up Basic Authentication in a Java environment:
1. Log on to the Visual Administrator.
2. On the Cluster tab, choose Server <x> → Services → Web Services Security.
3. Choose Web Service Clients → sap.com > tc~wd~pdfobject → com.sap.tc.webdynpro.adsproxy.AdsProxy*ConfigPort_Document.
4. From the Authentication list, select BASIC.
5. In the User and Password boxes, enter as Username ADSUser and a Password.
6. Choose Save.
7. The authentication data must be activated. For doing this navigate to Services → Deploy
8. Choose the button Application.
9. Choose sap.com/tc~wd~pdfobject in the tree.
10. Choose Stop Application.
11. For restarting the application choose Start Application.
Note: If the Adobe document services and the Web Dynpro runtime environment are not installed on the same J2EE Engine, you have to configure a Custom URL.
