Tutorial on Installing Credentials and Configuring ADS

Applies to:
This article applies to SAP Netweaver, WAS (Web Application Server), WebDynpro Java.

Summary
Developers who wish to use Adobe Interactive Forms in their WebDynpro Applications need to install credentials and configure ADS(Adobe Document Services). This tutorial will take you step by step through the process.

Author(s): Amol Gupta Company: Wipro Technologies Created on: 8th February 2008

Author Bio

I am Amol Gupta. I have been working with Wipro Technologies on WebDynpro programming, Enterprise Portal Content Management, Java API for accessing MDM, MDM Console, MDM Data Manager, Interactive forms for WebDynpro Java . I also know a bit of Java (SCJP) and ABAP programming.

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 1

Tutorial on Installing Credentials and Configuring ADS

Table of Contents
STEP 1 : Installing a credential for Adobe Document Services .........................................................................3 STEP 2 : Creating a User in SAP Netweaver AS Java for Basic Authentication ..............................................3 Use ..................................................................................................................................................................3 Creating the User ADSUser and Assigning the Security Role........................................................................3 Defining ADSUser as Technical User .............................................................................................................4 STEP 3 : Setting Up Basic Authentication in a Java Environment .....................................................................4 Use ..................................................................................................................................................................4 Prerequisites ...................................................................................................................................................4 Procedure........................................................................................................................................................4 STEP 4 : Configuring the Destination URL for the Adobe Document Services .................................................5 Use ..................................................................................................................................................................5 Prerequisites ...................................................................................................................................................5 Procedure........................................................................................................................................................5 Result ..............................................................................................................................................................6 Related Content..................................................................................................................................................6 Copyright.............................................................................................................................................................7

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 2

Tutorial on Installing Credentials and Configuring ADS

STEP 1 : Installing a credential for Adobe Document Services

In order to work with Adobe Document Services you need to install a valid credential. A preliminary credential is available at sdn.

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. 2. Log on to the Visual Administrator. 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.

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 3

Tutorial on Installing Credentials and Configuring ADS

7. On the Policy Configurations tab, in the Components area, select com.adobe/AdobeDocumentServices*AdobeDocumentServicesAssembly.jar. 8. On the Security Roles tab, select ADSCaller from the Security Roles list.

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. 3. 4. Display the user ADSUser. Choose Modify. 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. 2.

Log on to the Visual Administrator. 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. 7. Choose Save. The authentication data must be activated. For doing this navigate to Services Deploy.

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 4

Tutorial on Installing Credentials and Configuring ADS

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.

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.

STEP 4 : Configuring the Destination URL for the Adobe Document Services
Use If the Adobe document services are not provided on the J2EE Engine on which the Web Dynpro runtime environment is deployed, you must change the destination URL of the Adobe document services using the Visual Administrator. Prerequisites You have access to the J2EE Engine with administrator authorization. To better understand the below sections, read Creating a User for Basic Authentication in the document Adobe Document Services Configuration Guide. You can find this guide in the SAP Service Marketplace under Quick Link /instguidesNW04.

Procedure
...

1. Start the Visual Administrator by double-clicking on file go.bat in the file directory C:\usr\sap\<System ID>\<System Number>\j2ee\admin, in which the J2EE Engine is installed. For example, the background file can be stored in directory C:\usr\sap\J2E\JC00\j2ee\admin. 2. In the logon screen of the Visual Administrator, select a connection and choose Connect. 3. Enter the password for the connection. You are now connected with the Visual Administrator. 4. Navigate to directory Server Services Web Services Security Web Service Clients sap.com tc~wd~pdfobject com.sap.tc.webdynpro.adsproxy.AdsProxy*ConfigPort_Document. The name of the Web service for the Adobe document services is com.sap.tc.webdynpro.adsproxy.AdsProxy*ConfigPort_Document. 5. To change the default URL http://localhost:50000/AdobeDocumentServices/Config?style=document, select Custom in the dropdown listbox next to label URL for the destination URL. 6. Enter the host name and port number <Host Name>:<Port Number> in place of the character string localhost:50000. 7. Define the user name and password. To find out how to create the user name and password for the Adobe document services, see Creating a User for Basic Authentication in the document Adobe Document Services Configuration Guide. You can find this guide in the SAP Service Marketplace under Quick Link /InstguidesNW04. 8. Save your entries. You can do this by choosing Save, at the bottom of the left navigation frame. 9. To copy and refresh the changed data in the J2EE Engine, navigate to Services Deploy. 10. Choose Application. 11. Select sap.com/tc~wd~pdfobject.

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 5

Tutorial on Installing Credentials and Configuring ADS

12. 13.

To stop the application, first choose Stop Application. Then choose Start Application.

Result You defined the URL of the Adobe document services required to create interactive PDF forms

Related Content
Please include at least three references to SDN documents or web pages. Adobe Forms for WebDynpro Java Interactive Forms Overview Presentation How to guide SAP Interactive Forms by Adobe

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 6

Tutorial on Installing Credentials and Configuring ADS

Copyright
2008 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation. Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries. Oracle is a registered trademark of Oracle Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc. HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology. Java is a registered trademark of Sun Microsystems, Inc. JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. MaxDB is a trademark of MySQL AB, Sweden. SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. These materials are provided as is without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the use of these materials. SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages. Any software coding and/or code lines/strings (Code) included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent.

SAP DEVELOPER NETWORK | sdn.sap.com 2008 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 7