Alternative Deployment Method

1. Import the following packages. These packages are required to perform cryptographic operations:

       import com.centralmanagement.CipherTextData;
       import com.centralmanagement.CentralManagementProvider;
       import com.centralmanagement.RegisterClientParameters;
       import com.centralmanagement.policy.CryptoManager;
   

2. Define CADP for Java Application and generate the registration token on the CipherTrust Manager. Refer to Application Data Protection for details.

3. Register the CADP for Java client on the CipherTrust Manager by passing the following arguments as shown in the below code snippet.

   Argument	Description
   keyManagerHost	IP address or host name of the key manager.
   registrationToken	Token required to register CADP for Java client on CipherTrust Manager.

   Registration sample

           //Create a RegisterClientParameters object by passing the key manager's IP address and the registration token.
           RegisterClientParameters registerClientParams = new RegisterClientParameters.Builder(keyManagerHost,registrationToken.toCharArray()).build();
   
           //Create a CentralManagementProvider object by passing RegisterClientParameters object.     
           CentralManagementProvider centralManagementProvider = new CentralManagementProvider(registerClientParams);
   
           //Register the client
           centralManagementProvider.addProvider();
   

   Registration example

           RegisterClientParameters registerClientParams = new RegisterClientParameters.Builder("10.xx.xx.xx","b6lYLQfViOmbU4fxBl9gbS6UTJCPqjNh57GV9LQKYSOHdwmuPkYtOZ6ZYFFdQJSa".toCharArray()).build();
   
           CentralManagementProvider centralManagementProvider = new CentralManagementProvider(registerClientParams);
   
           centralManagementProvider.addProvider();
   

   After registration, the following logs are displayed.

   Sample log

       01-20-2025 15:33:31.980 [main] INFO  ingrian.internal.config.Config - invoke0: configureProperties: *****************************
       01-20-2025 15:33:31.983 [main] INFO  ingrian.internal.config.Config - invoke0: configureProperties: *Starting CADP-JCE Provider*
       01-20-2025 15:33:31.983 [main] INFO  ingrian.internal.config.Config - invoke0: configureProperties: *****************************
   

   The message Starting CADP-JCE Provider in the log indicates that the CADP for Java is up and running and ready to serve requests.

   Explore the client registration sample (CADPClientRegistrationSample.java) available on Github.

Next Topics

• Tasks

• Advance Topics

Import the following Ingrian packages. These packages are required to perform cryptographic operations.

    import com.ingrian.security.nae.*;
    import java.security.*;
    import javax.crypto.*;

Important Notes

• In case of Java 10, the java.se.ee module needs to be added as a JVM argument.

• For Java 11 and higher versions, download the following JAR files from a trusted source and add their paths in Tomcat's CLASSPATH:

  • jaxb-api-2.3.1.jar: Provides an API and tools that automate the mapping between XML documents and Java objects.

  • jaxb-impl-2.3.1.jar: Contains sources required for runtime processing.

  • jaxb-core-2.3.0.1.jar: Provides the core functionality for mapping Java objects to XML and vice-versa.

  • javax.activation-1.2.0.jar: Provides a standard way to handle data in different formats and sources within Java applications.

• For Java 8, the following jar files are OSGI compliant:

  • cryptodatautility.jar

  • CADP_for_JAVA-8.18.0.001.jar

    These jar files access some non-public APIs, user needs to enable the org.osgi.framework.bootdelegation=sun.,com.sun. property in the OSGI framework to provide access to these APIs.

• User can configure an external logger to capture logs instead of the default logging jar files log4j-core-x.x.x.jar and log4j-api-x.x.x.jar.

• To run multiple web applications using CADP for Java, place the CADP_for_JAVA jar file and dependent jar files in a desired directory and specify it as CLASSPATH for each web application. For example, when deploying multiple web applications using CADP for Java in Tomcat, place the jar files in Tomcat's lib directory.

Explore CADP for Java samples available on Github.

What's Next

• Tasks

• Advance