StrongAuth currently makes the Relay Webservice module available as a web-archive (WAR) file. This must be deployed to the Glassfish application server on the appliance before the service can be consumed by applications. Download this file from the location provided to you by StrongAuth, and unzip its contents. The rest of this process assumes that you have the software downloaded, with all its contents available to you. If you do not have this ZIP file, please contact your StrongAuth representative or This email address is being protected from spambots. You need JavaScript enabled to view it..
The process to deploy the WAR file and configure the appliance is as follows; the process takes about 20-30 minutes and does require the Glassfish application server to be restarted for the service to become operational. As always, please test this module thoroughly on your DEVP appliance before deploying it in your PROD environment:
- Login to the Primary appliance as the Linux strongauth user, either on the console or through a secure shell (SSH) over the network;
- If logged in on the console of the appliance and if you are in GUI mode, open up a terminal;
- Go to that directory with the following command:
cd /usr/local/strongauth/strongkeylite/etc - Make a copy of the strongkeylite-configuration.properties file in case something goes wrong with the edits with: cp strongkeyliteconfiguration.properties strongkeylite-configuration.properties.old
- Using a text editor (example: vi), edit the strongkeylite-configuration.properties file and add the following properties to the end of the file: Replace the numeral 2 with the number of URLs you intend to authorize for the appliance to communicate with. In the example below, the property shows two (2) URLs being authorized; however, you may have less or more URLs you wish to communicate with:
strongkeylite.cfg.property.relay.authorizedurls.number=2 - Add the two URLs to the file in the following manner:
strongkeylite.cfg.property.relay.authorizedurls.1=https://test.authorize.net
strongkeylite.cfg.property.relay.authorizedurls.2=https://paltest.adyen.com
Replace the example URLs with actual URLs required to communicate with the gateways, as provided by your payment processor. While the example shows the property folded (because of the page-width), in practice, each property must be on one single line.
It is critical that the number of configured URLs must match the number of URLs authorized in the property defined in the earlier step. Additionally, each URL must have a unique sequence number to ensure they are identified uniquely within the system. - Save the file. Display the file using the cat strongkeylite-configuration.properties command to confirm that the edits were saved correctly.
- Navigate to the directory where the Relay module's software distribution is available; this is the directory where you saved and extracted the ZIP file after downloading it from StrongAuth's web-site.
- Copy the two XML Schema Definition (XSD) files from the release/xsd directory of the extracted content, to the /usr/local/strongauth/strongkeylite/etc directory.
- Navigate to the jar directory of the extracted content. You will find many Java Archive (jar) files in there. Copy them to the /usr/local/strongauth/lib directory as follows:
cp *.jar /usr/local/strongauth/lib - Navigate to the war directory of the extracted content. You will find a file named strongkeyliteRELAY.war in there.
- Type the following commands on the command-line, making sure you are in the same directory as the WAR file:
asadmin deploy strongkeyliteRELAY.war
If you are prompted for a credential and password, then type in admin for the username, and the password you set for the Glassfish admin user. (If you haven't set/changed the GF admin password, it is adminadmin; however,please change it early as possible).
$ atlas:~> asadmin deploy strongkeyliteRELAY.war
Command deploy executed successfully.
$ atlas:~> - Using a browser, type in the following URL; substitute demo4.strongkey.com:8181 for the FQDN and port number of your own appliance:
https://demo4.strongkey.com:8181/strongkeyliteWAR/EncryptionService?wsdl
If your configuration and deployment was successful, you should see the WSDL of the Relay webservice on the browser. This tells you that part of your installation process was successful. Continue with the process of verifying that service works, end-to-end, before repeating this process on the other appliances.