Get the Android SDK
First, you should add the Safous WAAP Android SDK to your project. Visit WAAP Admin Portal to get the latest version of our SDK.
Adding the SDK to Your Project
After obtaining the SDK, insert it into your project's app/libs directory (<project>/app/libs) in your Android project.
Embedding the SDK in the Gradle Module
Now, open your build.gradle file (<project>/build.gradle) in Android Studio. Then, in the root-level Gradle file, include the SDK files that you have obtained as dependencies. The syntax is provided below:
implementation files('libs/SafousWaap.aar')
Pre-requisition
Before you configure the Android SDK, make sure you already have the certificate for authentication to accessing the environment. Below is the steps for set the certificate on your project
- Download the certificate with .p12 format. If you have not generate the Trusted Certificate, you can create it in Safous portal dashboard. More info for how to generate the certificate provided here.
- Put the certificate on your project. Specifically in raw folder in resources directory (<project>/app/src/main/res/raw).
Setup Environment
For this section, we will call function setupEnv in the SDK. Before that, you have to setup the path for certificate in your Activity class. First you have to import File I/O java class. More details for any classes you should import below :
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
Declare a String for initiate the name of certificate.
String certName = "<certificate_name>.p12";
Now start using the Android SDK. First import the ApiProtection java class from SDK and put it on your Activity class.
import com.safous.waap.ApiProtection;
Then you need to initialized new variable in your Activity class. This variable instance to ApiProtection java class. So it can inherit all the values in SDK to be used in your Activity class.
public static ApiProtection protection;
Next you put the ApiProtection variables and declare it on your Activity class.
protection = new ApiProtection(getApplicationContext());*note: getApplicationContext are needed to be Context extension in your Activity Class
Before calling the setup Environment function in SDK, make sure you have all the values that needed for parameters in setup Environment function. All of these values are mandatory to filled. So make you had all of these values.
| Configuration Name | Description |
| xAppId | Unique identity for client registered by Safous WAAP, example : mobile apps, web apps, etc |
| UrlReg | Access URL for registration device to Safous WAAP |
| UrlAuth | Access URL for authentication device to Safous WAAP |
| UrlVerify | Access URL for client verification to Safous WAAP |
| certPath | Certificate path or location |
| certPass | Certificate Passphrase |
If you already have all the values for parameters above, finally you can create a Setup Environment function. Use the variables with ApiProtection instance for get the SetupEnv method.
protection.setupEnv(
<xAppId>,
<UrlReg>,
<UrlAuth>,
<UrlVerify>,
<certPath>.certName,
<certPass>;
As summary, your code to setup the environment of SDK should be like this.
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import com.safous.waap.ApiProtection;
public class YourActivity extends AppCompatActivity {
...
public static ApiProtection protection;
public string certName = "<certificate_name>.p12";
...
public void yourFunction() {
...
...
protection = new ApiProtection(getApplicationContext());
protection.setupEnv(
<xAppId>,
<UrlReg>,
<UrlAuth>,
<UrlVerify>,
<certPath>.certName,
<certPass>;
}
...
}
After done all the setup environment, Next you can use Registration and Transaction modules on this Android SDK. As a note, you still can calling the functions in Registration and Transaction modules from the Android SDK, however it will not work before you setup the environment first.