Flex integration

Use this page to specify which Flex integration features to enable, and which IP addresses can perform Data Service operations. If you enable Adobe LiveCycle Data Services support, but do not specify any IP addresses, only processes on the local computer can connect to the LiveCycle Data Services server in ColdFusion.

 

Option

Description

Default

Enable Flash Remoting support

Specifies whether to enable Flash clients to connect to this ColdFusion server and invoke methods in ColdFusion components (CFCs).

Enabled

Enable Remote Adobe LiveCycle Data Management access

Specifies whether to enable a LiveCycle Data Services ES server to connect to this ColdFusion server and invoke methods in CFCs to fill, sync, get, or count records in a result set used in a Flex application.

Disabled

Server Identity

Specifies the ColdFusion server on which you want to enable LiveCycle Data Management ES support.

 

Enable RMI over SSL for Data Management

Encrypt communication between ColdFusion and Flex by enabling Secure Sockets Layer (SSL).

Disabled

Select IP Addresses Where LiveCycle Data Services ES Is Running

Specifies which LiveCycle Data Services ES servers can connect to the LiveCycle Data Services ES support in ColdFusion. If you do not specify a list of allowed IP addresses, only processes on the local computer can connect to the LiveCycle Data Services ES support in ColdFusion.

None

View or Remove selected IP addresses where LiveCycle Data Services ES are running  

Lists the IP addresses where LiveCycle Data Services ES are running. Click Remove Selected to remove any IP address from the list.

 

 

Add an IP address

  1. On the Flex Integration  page, enter an IP address for the connection to the LiveCycle Data Services support in ColdFusion.

  2. Click Add.

Remove an IP address

  1. Select an IP address from the list.

  2. Click Remove Selected. The address no longer appears in the list.

 

To use SSL, you must create a keystore file. The keystore is a self-signed certificate. (You do not need a certificate signed by a Certificate Authority, although if you do use one, you do not need to configure Flex as indicated in the following steps.) The information in the keystore is encrypted and can be accessed only with the password that you specify. To create the keystore, you use the Java keytool utility, which is included in your Java Runtime Environment (JRE).

 

Enable SSL, you do the following

  1. Create the keystore.

  2. Configure Flex.

  3. Enable SSL in the ColdFusion Administrator.

 

Create the keystore

  1. Generate the SSL server (ColdFusion) keystore file by using the keytool utility, with a command similar to the following:

keytool -genkey -v -alias FlexAssembler -dname "cn=FlexAssembler" -keystore cf.keystore -keypass mypassword -storepass mypassword

The following table describes the parameters of the keytool utility that you use:

 

Parameter

Description

-alias

The name of the keystore entry. You can use any name for this, as long as you are consistent when referring to it.

-dname

The Distinguished Name, which contains the Common Name (cn) of the server.

-keystore

The location of the keystore file.

-keypass

The password for your private key.

-storepass

The password for the keystore. The encrypted storepass is stored in ColdFuison configuration files.

-rfc

Generates the certificate in the printable encoding format.

-file

The name of the keystore file.

-v

Generates detailed certificate information.

 

Next, you place the certificate you created in the file that the JVM uses to decide what certificates to trust. The file in which you put the certificate, (usually named cacerts), is located in the JRE, under the lib/security folder.

 

Configure Flex

  1. Export the keystore to a certificate by using the keytool utility, with a command similar to the following:
    keytool -export -v -alias FlexAssembler -keystore cf.keystore -rfc -file cf.cer

  2. Import the certificate into the JRE cacerts file for your server by using the keytool utility, with a command similar to the following:
    keytool -import -v -alias FlexAssembler -file cf.cer -keystore C:\fds2\UninstallerData\jre\lib\security\cacerts

 

The previous example specifies the location of the keystore for LiveCycle Data Services ES with integrated JRun, installed using the default settings. If you are using a different server, specify the location of the cacerts file for the JRE that you are using. For example, if you are using JBoss, you specify the keystore location as $JAVA_HOME/jre/lib/security/cacerts.

 

Enable SSL in the ColdFusion Administrator

  1. In the ColdFusion Administrator, select Data & Services > Flex Integration, and specify the keystore file in the Full Path to Keystore text box.

  2. Specify the keystore password in the Keystore password text box.

  3. Select the Enable RMI over SSL for Data Management option, and then click Submit Changes.

If you specify an invalid keystore file or password, ColdFusion does not enable SSL, and disables LiveCycle Data Management Support.