Customizing the SDK wrapper layer

The SDK installation contains build and project files, which are required to build the ASP.NET wrappers and sample site. This allows changes to the wrappers to further customize the SOAP interface and sample site.

SDK wrapper customization requires the following:

• Visual Studio 2010 or later
• Microsoft .NET Framework 2.0 or later
• IIS must be installed.
• Web Services Enhancements (WDE) 3.0 for Microsoft.NET must be installed.

The main build and project files are located in sdk_install_dir\ASP.NET, specifically in the following subfolders:

• bin. Contains the generated sample site and compiled libraries provided by OneSpan.
• doc. Contains generated help files (CHM), with details of wrapper commands and their formats.
• src. The OneSpan Authentication Server sample site and wrapper source and solution files.

Source Samples

While customizing the wrapper layer, you may need to refer to source code samples.

OneSpan Authentication Server SDK provides useful source code samples in the src/IdentikeySampleSite/ folder (Java only). This folder contains further subfolders with names corresponding to specific wrapper commands, e.g. administration, authentication, or provisioning.

To publish the WSDL files and building the customized wrapper (for ASP.NET in Windows)

1. Open the IIS Manager.
2. Right click on the default Web Site, then select New > Virtual Directory.
3. Click Next, then enter schemas into the alias field.
4. Browse to the path of the SDK product install directory and select the WSDL directory, i.e. sdk_install_dir\wsdl. Click Next.
5. Check Read and Browse.
6. Click Finish.
7. Ensure the internet guest account (IUSR_computername) has access to the files in the sdk_install_dir\wsdl folder. This mounts the WSDL files on the location http://localhost/schemas.

   At this point, the WSDL files should be published as required. You can now start building the customized wrapper.

8. To begin, open the IdentikeySampleSite.sln/ file in Visual Studio 2010. This will open both the OneSpan Authentication Server sample website and the IdentikeyWrapper/ project files.
9. In the IdentikeyWrapper/, update the web references to ensure that they can see the WSDLs mounted at the http://localhost/schemas address.