REST APIs

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

Prerequisites

1. Apache Tomcat 9.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. Download and extract CADP_for_JAVA_Webservices_vx.xx.x from the support portal.

4. Copy tmrestVaultless.war from CADP_for_JAVA_Webservices directory to the %CATALINA_HOME%/webapps directory.

5. 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.18.1.000.jar

     Note

     • 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.1.x.

6. 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.

7. 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