Merge pull request #137 from wultra/develop

Prepare release 0.21.0

.travis.yml

@@ -1,6 +1,9 @@
 language: java
 jdk:
   - oraclejdk8
+branches:
+  only:
+  - master
 env:
   global:
   - secure: "T5N2JPg3RXeohHv11G4Yi5WR2wXI+d85VLkF9nt1293FvqblxVrN26CipeKPuRYi5Xo71wNbqsLdmy83cE8Mm0n6eTxTRbzsc/CjK7xoAMId+MAEznozEaiZPzRECF63LNP+tWobGLsMT7gJMFJL/94ib8p+I5E1kqFtMAQo/a0uh82vvcgS1r9jtXq/DXxsUKGQPJwGeQH8dIegUPVuXcXvIfwEFI9WNYYBLhwAlW5r+FYQqgTDOiP2jttVhRMDU37SiWbh0YaR2Bc0Iw1muy2Du30VROWgkV98HRDU8B8TBxdcBL9QkCvkzD3EmPiD/JeccG0DwtBXpEirtk8v2EwlKAVwuTDVxwdwAdYxREl2w4fx+8XCb0ps6GWEcWgbKEL/XRNP4uXziAMor5udUMpuS8r9kPqoy/sIhpVaM9df+Wd1KEnzv88Bd04IwZasOeuA8wdOPOLpickf/+s29Ez3oUKggZMo6kQvfhiBjXqkfQ10N7bog7ZjQXouSVBDj9t34ksJMNaIJ01mfBXddBh7pq7kp/Uct1MJU9/LfaOXQ8FILu6Qxqr50Gyr9CwSm0fAFJL60EDNdYhq8jF6yPGlaoild1SQKx+veFUzu6bbk49WrVvwxv4leiXH9jhf6kIVtpCZ8RoBDBH5EdMUmPPz7t09EKPs7U75BVkD420="
@@ -11,9 +14,9 @@ before_install:
 addons:
   coverity_scan:
     project:
-      name: lime-company/powerauth-restful-integration
+      name: wultra/powerauth-restful-integration
       description: Build submitted via Travis CI
-    notification_email: petr@lime-company.eu
+    notification_email: petr@wultra.com
     build_command_prepend: mvn clean
     build_command: mvn -DskipTests=true compile
     branch_pattern: master

README.md

@@ -4,10 +4,10 @@ In order to easily secure your RESTful APIs with PowerAuth, you can use our easy
 
 **Integration Tutorials**
 
-- [Introduction](https://github.com/lime-company/powerauth-restful-integration/wiki/Introduction)
-- [RESTful API (Spring)](https://github.com/lime-company/powerauth-restful-integration/wiki/RESTful-API-for-Spring)
-- [RESTful API (JAX-RS)](https://github.com/lime-company/powerauth-restful-integration/wiki/RESTful-API-for-JavaEE)
+- [Introduction](https://github.com/wultra/powerauth-restful-integration/wiki/Introduction)
+- [RESTful API (Spring)](https://github.com/wultra/powerauth-restful-integration/wiki/RESTful-API-for-Spring)
+- [RESTful API (JAX-RS)](https://github.com/wultra/powerauth-restful-integration/wiki/RESTful-API-for-JavaEE)
 
 **Deployment Tutorials**
 
-- [PowerAuth REST API](https://github.com/lime-company/powerauth-restful-integration/wiki/Deploying-PowerAuth-Standard-RESTful-API)
+- [PowerAuth REST API](https://github.com/wultra/powerauth-restful-integration/wiki/Deploying-PowerAuth-Standard-RESTful-API)

docs/Deploying-PowerAuth-Standard-RESTful-API.md

@@ -0,0 +1,52 @@
+# Deploying PowerAuth Standard RESTful API Bootstrap
+
+This chapter explains how to deploy PowerAuth Standard RESTful API.
+
+PowerAuth Standard RESTful API is a Java EE application (packaged as an executable WAR file) responsible for exposing the [RESTful API according to the specification](https://github.com/wultra/powerauth-crypto/blob/develop/docs/Standard-RESTful-API.md). It exposes services for end-user applications (PowerAuth Clients), such as the mobile banking app or mobile token app.
+
+You can use this application in case you need to use PowerAuth and cannot integrate it in your own API using our integration libraries.
+
+## Downloading PowerAuth Standard RESTful API
+
+You can download the latest `powerauth-restful-server.war` at the releases page:
+
+- https://github.com/wultra/powerauth-restful-integration/releases
+
+## Configuring PowerAuth Standard RESTful API
+
+The default implementation of a PowerAuth Standard RESTful API has only one compulsory configuration parameter `powerauth.service.url` that configures the SOAP endpoint location of a PowerAuth Server. The default value for this property points to `localhost`:
+
+```bash
+powerauth.service.url=http://localhost:8080/powerauth-java-server/soap
+```
+
+## Setting Up Credentials
+
+_(optional)_ In case PowerAuth Server uses a [restricted access flag in the server configuration](https://github.com/wultra/powerauth-server/blob/develop/docs/Deploying-PowerAuth-Server.md#enabling-powerauth-server-security), you need to configure credentials for the PowerAuth Standard RESTful API so that it can connect to the SOAP service:
+
+```sh
+powerauth.service.security.clientToken=
+powerauth.service.security.clientSecret=
+```
+
+The credentials are stored in the `pa_integration` table.
+
+_Note: For SOAP interface, PowerAuth Server uses WS-Security, `UsernameToken` validation (plain text password). The RESTful interface is secured using Basic HTTP Authentication (pre-emptive)._
+
+## Deploying PowerAuth Standard RESTful API
+
+You can deploy PowerAuth Standard RESTful API WAR into any Java EE container.
+
+The default configuration works best with Apache Tomcat server running on default port 8080. In this case, the deployed server is accessible on `http://localhost:8080/powerauth-restful-server/`.
+
+To deploy PowerAuth Standard RESTful API to Apache Tomcat, simply copy the WAR file in your `webapps` folder or deploy it using the "Tomcat Web Application Manager" application (usually deployed on default Tomcat address `http://localhost:8080/manager`).
+
+## Deploying PowerAuth Standard RESTful API Outside the Container
+
+You can also execute WAR file directly using the following command:
+
+```bash
+java -jar powerauth-restful-server.war
+```
+
+_Note: You can overwrite the port using `-Dserver.port=8090` parameter to avoid port conflicts._

docs/Home.md

@@ -0,0 +1,13 @@
+# PowerAuth RESTful Integration Libraries
+
+In order to easily secure your RESTful APIs with PowerAuth, you can use our easy to use integration libraries for Java technology. Integration libraries are responsible for connecting to PowerAuth Server and for publishing required endpoints toward mobile apps.
+
+**Integration Tutorials**
+
+- [Introduction](./Introduction.md)
+- [Build Secure RESTful API (Spring)](./RESTful-API-for-Spring.md)
+- [Build Secure RESTful API (JAX-RS)](./RESTful-API-for-JavaEE.md)
+
+**Deployment Tutorials**
+
+- [Deploy PowerAuth REST API Standalone Application](./Deploying-PowerAuth-Standard-RESTful-API.md)

docs/Introduction.md

@@ -0,0 +1,8 @@
+# Integration With RESTful API
+
+Mobile banking applications usually connect to a RESTful APIs with some end-points protected by authentication. In order to enable authentication with PowerAuth, you need to integrate PowerAuth Server with your RESTful API using ready to use high-level libraries.
+
+In order to integrate PowerAuth Server with your RESTful API, follow one of these tutorials:
+
+- [Integration with RESTful API (Spring)](./RESTful-API-for-Spring.md)
+- [Integration with RESTful API (JAX-RS)](./RESTful-API-for-JavaEE.md)