Your suggested change has been received. Thank you.

close

Suggest A Change

https://thales.na.market.dpondemand.io/docs/dpod/services/kmo….

Thales Logo

All

  • All
back

Tasks

Configuring CADP_for_JAVA.properties File

search

Configuring CADP_for_JAVA.properties File

This section contains detailed instructions on how to modify the CADP_for_JAVA.properties file. The properties file defines, among other things, IP address, port, and protocol of the Key Manager appliances to which the client connects. This section contains the following topics:

To configure the SSL on CipherTrust Manager for NAE, refer to Configuring SSL on CipherTrust Manager for NAE Interface for details.

Editing the Properties

The properties are case-sensitive. yes is not YES. tcp is not TCP. Follow the examples in the default properties file.

The values can be comment-out using #. Comments may be needed to save settings when troubleshooting. For example, to store commonly used NAE_IP addresses as shown below:

NAE_IP.1=10.0.0.2

#NAE_IP.1=10.0.0.3

#NAE_IP.1=10.0.0.4

When editing parameters that use time values, the following abbreviations can be used:

  • ms - milliseconds. e.g. 4500ms for 4.5 seconds.

  • s - seconds. e.g. 30s for 30 seconds.

  • m - minutes. e.g. 5m for 5 minutes.

  • h - hours. e.g. 10h for 10 hours.

  • d - days. e.g. 2d for 2 days.

If an abbreviation is not included, the default time unit (milliseconds) is used.

Changing Location of CADP_for_JAVA.properties File

By default, the provider searches for the CADP_for_JAVA.properties file in the same location as the CADP_for_JAVA.jar. If the properties file is used, System.setProperty() is called and the com.ingrian.security.nae.CADP_for_JAVA_Properties_Conf_Filename property is set to the new location.

For example,

System.setProperty("com.ingrian.security.nae.CADP_for_JAVA_Properties_Conf_Filename", "home/java/CADP_for_JAVA.properties");

Note

Filename must be included when setting the property.

Configuring Parameters Programmatically

The CADP_for_JAVA.properties file can be set programmatically at runtime. This can be done to override the values in the CADP_for_JAVA.properties file or avoid storing the properties file locally.

Values set programmatically override values in the properties file.

To configure the parameters programmatically:

  1. Include the appropriate calls to the System.setProperty() method for each system property that is required to be set in the application.

    System.setProperty("com.ingrian.security.nae.NAE_IP.1", "10.20.1.9");
System.setProperty("com.ingrian.security.nae.NAE_Port","9000"); 
System.setProperty("com.ingrian.security.nae.Protocol","tcp");

    Warning

    The calls to System.setProperty() must occur before any calls that require the CADP for Java providers. The provider cannot be instantiated properly if the system properties have not been set.

  2. Set the provider entry in the java.security file. This will store the new settings. This statement must occur after the System.setProperty() calls.

    java.security.Security.addProvider(new IngrianProvider());

The CADP for Java configuration parameters are classified into:

On this page