Compilation, Packaging and Deployment
Web Flow uses Maven for compilation and packaging. Java 11 should be used to compile Web Flow.
Web Flow can be deployed to any Java web container (such as Tomcat) using war artifacts produced during compilation.
Dependencies
In order to build Web Flow using Maven, following PowerAuth dependencies need to be satisfied:
- powerauth-server - dependency powerauth-rest-client-spring
- powerauth-push-server - dependency powerauth-push-client
- powerauth-restful-integration - dependency powerauth-restful-security-spring
- powerauth-crypto - dependency powerauth-java-crypto
- lime-java-core - dependency rest-model-base
These projects should be installed into local Maven repository using the “install” goal before building Web Flow. This step may not be necessary in case these packages are already published in the public repository in their required versions.
Other dependencies are resolved automatically by Maven by downloading packages from public Maven repositories.
Building Web Flow
Web Flow can be built using the parent pom.xml file of project powerauth-webflow. Use the “package” goal to generate the war artifacts. The war files will be built in target subfolders of project folders. In case the compilation fails, check for missing PowerAuth dependencies to be installed.
Deployment
Once you create a war package using steps above and set up database for Web Flow, you can deploy the war files to any Java web container, such as Tomcat or any Java EE server. You can remove the version from the war file for a nicer target URL in the container (e.g. rename powerauth-webflow-0.0.xx-SNAPSHOT.war to powerauth-webflow.war). After deployment, the client application frontend should be available at http[s]://host:port/powerauth-webflow-client.
The following war files need to be deployed for a fully functional demo of Web Flow:
- powerauth-webflow.war - the main Web Flow application
- powerauth-nextstep.war - the Next Step service
- powerauth-data-adapter.war - a Data Adapter for communication with client backends
- powerauth-webflow-client.war - demo client application
The whole installation process is described in the Web Flow Installation Manual.
Testing Web Flow
You can test the web flow demo application by navigating to: http://localhost:8080/powerauth-webflow-client
- Use the “Login” action to test the user authentication. The Data Adapter sample project uses “test” as password for any username.
- Use the “Payment (DEMO)” action to test payment authorization. You will need to enable POWERAUTH_TOKEN authentication method for the user who will authorize the payment (using Next Step REST API).
- Use the “Authorization” action to test operation authorization. In order to test this action you will need to create an operation and obtain its operationId (using Next Step REST API).