C SSL Security Configurations for Developers

This chapter discusses information that is useful to developers extending the application or producing applications using the product as a platform. Agile supports SDK if you prefer to use Java code for the extensions. Alternatively, Agile supports Web Services extensions so that you can use your preferred development language and platform.

C.1 SDK Client Configuration

Oracle's Agile Software Development Kit (SDK) is a collection of Java application programming interfaces (APIs), sample applications, and documentation that enable you to build custom applications to access, or extend the functionality of the Agile Application Server. Using the SDK, you can create programs that extend the functionality of Agile PLM and can perform tasks against the PLM system.

For more information about SDK, in general, see the SDK Developer Guide - Developing PLM Extensions.

C.1.1 Configuring SSL for SDK

To configure SSL for SDK, do the following:

1. Get the certification key, for example mykeystore.jks, that is generated using the steps in Appendix B, and keep the mykeystore.jks file in a folder located on the system where you want to run SDK, such as C:\SDKSSL.

2. Follow these steps to run SDK sample code with an SSL environment:

   a. Download SDK sample files from OTN.

   b. Go to "..\SDK_AIS_Samples\sdk\samples\api\Login".

   c. Update URL, USERNAME and PASSWORD with SSL server information in Login.java.

   Set URL as https://hostname:port/Virtualpath

   d. Update the file run.bat:

   Set JAVA_HOME & SDK_HOME

   Update Java Command:

   java -classpath .;c:\SSL\SDK\AgileAPI.jar -Djavax.net.ssl.trustStore=C:\SDKSSL\mykeystore.jks -Djavax.net.ssl.trustStorePassword=Agile123 Login

   e. Execute run.bat.

C.2 Web Service Client Configuration

For more information about Agile web services, see Agile Web Services User Guide.

C.3 Web Service Extensions

The Agile PLM application includes web services as an extensibility point. The out-of-box Agile PLM web services can be leveraged to provide customized clients or integration modules. Agile PLM web services authenticate using basic authentication.

For optimal security protection, Oracle recommends configuring web services using SSL. For more information about how to configure SSL for web services, refer to Chapter 7, "Enabling Security for Web Services".

For more information about Agile web services, see Agile Web Services User Guide.