WibuKey Java adaption.
This document describes the WkJavaApi classes which can be used to access the
WibuKey with JAVA via a Java native interface (JNI). The WkJavaApi class is
platform independant and uses a DLL / shared library which is available for
Windows, Linux and Mac OS X.
If you encounter any problem or need additional information please contact
WIBU-SYSTEMS via e-mail at support@wibu.com
Platforms
Currently the following platforms are supported and tested by WIBU-SYSTEMS:
-
Windows 9x/ME/NT/2000/XP and Windows x64
-
Linux (Kernel 2.4 or higher)
-
MacOS X (10.3.9 or higher)
If your platform isn't listed here, please take a look at www.wibu.com or send
a request to support@wibu.com.
Installation / Files
To build or run a protected JAVA application you have to install the WibuKey
drivers for the specific platform. The latest runtime kit installer containing
these drivers can be found at the
WIBU-SYSTEMS download page.
The installers for Windows, Mac OS X and Linux contain also the wibuKJni
dynamic library which is installed into the system library path. The exact
location can be found in the README.txt file in the platform specific folder of
this package. The JNI libs are also part of this package. The WkJavaApi.jar
archive always hast to be copied on your computer and added to the CLASSPATH
variable. You may also add the WkJava classes to your jar file.
The following files are part of the WibuKey Java adaption:
-
<Platform specific folder> (Linux / Mac OS X / Windows):
This folder contains the dynamic/shared library for the specific
platform(wibuKJni.dll for Windows, libwibuKJni.so for Linux and
libwibuKJni.libjni for MacOS X) and a short README file.
-
Sample:
Samples showing the WkJavaApi implementation.
-
WkJavaApi.jar:
Java archive containing the WibuKey java interface class
-
JavaDoc: A folder containing this documentation
Implementation
General
To protect your JAVA application import the 'com.wibu' package, which contains
the WkJavaApi class. The interface is very similar to the classic C interface,
so there's no specific documentation yet.
Please refer to the WibuKey API help which is available in HTML format.
Samples
Also take a look at the samples showing the usage of most API
commands. Following samples are provided by WIBU-SYSTEMS:
-
IRED: A sample implementation provided by HUMATIC (www.humatic.de)
showing the implementation of 'Interlace Random Encryption/Decryption' which can also be
found in the WkDmCS sample for C/C++.
-
WkNetwork/WkSimpleNetwork: Using WkJavaApi to check licenses via a WibuKey
network server.
WkSimpleLocal: Using WkJavaApi to check a local WIBU-BOX.
WkProperties: A sample for encrypting a configuration file using the WIBU-BOX
in a class derived from java.util.Properties.
-
KEY4J: Folder containing samples for Java byte code (class
files) encryption: HelloWorld and Stylepad.
Version Information
The WibuKey Java Adaption package version can be checked the following ways:
WkJavaApi.jar
This archive contains a manifest file (MANIFEST.MF), which contains the current
version information.
wibuKJni
You can query the version number using WkbQueryInfo2(WkJavaApi.HWKB_LOCAL, WkJavaApi.WKB_QI_JNI|WkJavaApi.WKB_QI_VERVALUE, wkbver, 0);
The Java Native Interface library also contains special version functions. You can retrieve the version
information by using the WibuKJniGetVersionString() method of the WkJavaApi class.
@see WkJavaApi
@see WkExtended