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 BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 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 BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 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. 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.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 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. 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.

SAP DEVELOPER NETWORK | sdn.sap.com BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 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 BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 5
 Tutorial on Installing Credentials and Configuring ADS

12. To stop the application, first choose Stop Application.

13. 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 BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 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 BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

© 2008 SAP AG 7