Carlos GuerreroAdobe technologies for the enterprise2010-10-28T07:17:55Zhttp://blogs.adobe.com/cguerrero/feed/atom/WordPressCarlos Guerrerohttp://blogs.adobe.com/cguerrero/?p=212010-10-28T07:17:55Z2010-10-27T09:10:03ZContinue reading →]]>There is a great post on the LiveCycle Product Blog here that explains how to set up a reverse proxy to filter the URLs of our LiveCycle server that we want to expose. In the case we want our server to be accessed over SSL, there are some additional steps we will need to follow. Here, I am going to cover this additional piece of configuration required for your Apache reverse proxy to handle HTTPS traffic.

1. Download and install the Apache server from http://httpd.apache.org. I used Apache 2.2 with OpenSSL when I was writing this. Also, this post is based on JBoss 4.2.1 (Turnkey) running on Windows.

2. Edit the Tomcat configuration file $JBOSS_HOME\server\lc_turnkey\deploy\jboss-web.deployer/server.xml of your JBoss server, adding the proxyName and proxyPort parameters with the name and port of the LiveCycle server. It should look something like this:

3. Use the openssl command to generate a certificate and key that our Apache server will need to handle SSL connections. Open a command prompt, go to Apache2.2\bin and run the openssl command with values matching your environment:

As explained in the post I referenced at the beginning, this configuration won’t filter any URL, and it will just redirect every request (/) to the SSL port of the JBoss server. If we want to be more restrictive and only allow specific URLs, we will need to configure that. For example, here we only allow access to the Rights Management UI:

5Carlos Guerrerohttp://blogs.adobe.com/cguerrero/?p=82010-08-19T14:44:17Z2010-08-19T14:44:17ZContinue reading →]]>I decided to start with a post about the LC Workbench ES Component Development Tool, which makes the generation of a custom component an easier task. You can download the prerelease of the tool from Adobe Labs (http://labs.adobe.com/technologies/lcwcdtool). The Development Tool is essentially a plug-in for Eclipse that provides a new type of project with a component.xml file, pre-generated service classes and an Ant script to finally generate the custom component JAR.

The thing that I really like about the tool is that it allows you to configure your custom component without the need of manually editing the component.xml file.

Before installing the Development Tool you need to make sure you have the following Eclipse frameworks installed:

Now, once installed, you will follow the following steps to create your custom component:

Create your new Component Project. You will see that under the “New Project” wizard of Eclipse, there is now a new category called “Adobe LiveCycle” with a “Component Project” within it.

On the first screen you will be prompted to enter the name of the new project, the package name where your service classes will be, and the unique ID of the component.

This dialog also allows you to specify the services your custom component will provide.

… by defining its operations:

and configuration parameters:

This “New Project” wizard will generate your project with the component.xml file already configured, and your service classes and Ant script generated. The project tree should look something like this:

If you need to add additional configuration to the component.xml file, you can edit it with the component editor provided by the Development Tool. Just open the component.xml in Eclipse and you won’t get the plain XML file content, but the following edit dialog that should make the edition of the file much easier.

The next step would be to implement the business logic of your service classes already pre-generated for you

Once you finish coding your Java classes, you can run the provided Ant build.xml to finally generate the JAR file, and voila!… your custom component is ready to be imported in LC Workbench to get it installed on your LC server.