Code Integration

After installing the SDK and configuring OneSpan Authentication Server accordingly, you need to configure the website you want to integrate the SDK with.

These settings should be applied to the controller.properties file:

• For a web application, the file should be located in the WEB-INF/classes directory.
• For a console or GUI application, the file should be located in the root directory of the JAR file.
• A custom file location can also be specified when instantiating the class com.vasco.identikey.controller.ConfigurationBean.

soap.host.primary = https://localhost:8888
soap.host.backup = https://localhost:8888
# Component type definitions
component.type.authentication = Authentication Sample Client
component.type.signature = Signature Sample Client
# valid values are : 4 (Cleartext/separate) or 0 (Cleartext/combined)
password.format = 0

The value of component.type.authentication should match the client type used by the client component created for the integrated website.

Required dependencies

Once you have installed the SDK and configured OneSpan Authentication Server and the integrated website, add the following dependencies to the integrated website:

• The OASAuthSoapClient artifact provided in sdk_install_dir/java_platform/bin.
• The OASAuthSoapWrapper artifact provided in sdk_install_dir/java_platform/bin.
• The ImageGeneratorSDK artifact provided in the local Maven repository under sdk_install_dir/java_platform/bin/m2repository.
• The UtilitiesSDK artifact provided in the local Maven repository under sdk_install_dir/java_platform/bin/m2repository.
• Apache Commons Logging, version 1.2, available at https://mvnrepository.com/artifact/commons-logging/commons-logging/1.2.

java_platform denotes the respective Java platform, i.e. either Jakarta or Java.