REST APIs

This section describes how to make vaultless tokenization REST APIs work with CXF jar and Apache Tomcat server.

Prerequisites

1. Apache Tomcat 8.0 or higher version and its compatible Java version (8 or higher) are installed.

2. The CATALINA_HOME path is set for Apache Tomcat.

3. Copy tmrestVaultless.war from SafeNetVaultlessTokenization/VaultlessTokenization/restfulservicevaultless directory to the %CATALINA_HOME%/webapps directory.

4. Ensure the following jar files are specified in the CLASSPATH.

   • SafeNetVaultlessTokenization-8.10.0.000.jar

   • commons-collections4-4.4.jar

   • commons-lang3-3.12.0.jar

   • gson-2.10.1.jar

   • log4j-api-2.19.0.jar

   • log4j-core-2.19.0.jar

   • CADP_for_JAVA-8.17.0.001.jar

     Note

     • To deploy tmrestVaultless.war on Apache Tomcat version 10.0.x, follow the steps mentioned below:

       1. Create a folder named webapps-javaee in the Apache Tomcat 10 directory.

       2. Place the tmrestVaultless.war file in the webapps-javaee folder.

       3. Run the startup batch file placed in the bin directory of Apache 10.

     • To deploy tmrestVaultless.war on Apache Tomcat version 10.1.x, follow the steps mentioned below:

       1. Download and extract Tomcat Migration Tool from here.

       2. Navigate to lib directory of the downloaded zip file.

       3. Execute the following command in the terminal:

          java -jar jakartaee-migration-*.jar <source> <destination>
          

          where source is the complete path of current tmrestVaultless.war file and the destination will be the complete path of migrated war file.

          For example,

          java -jar jakartaee-migration-*.jar tmrestVaultless.war migrated/tmrestVaultless.war
          

       4. Place the migrated tmrestVaultless.war file in the webapps folder of Tomcat.

       5. Run the startup batch file placed in the bin directory of Apache 10.

5. When using Java version 10 or 11, download the files javax.activation-1.2.0.jar and jaxb-api-2.2.3.jar and add them in the CLASSPATH.

6. Deploy vaultless tokenization on HTTPS Server.

   Note

   SVT REST APIs only work with HTTPS.

What's Next

• Deploy vaultless tokenization on HTTPS Server

• Create token for the plaintext

• Return plaintext for token