Frequently Asked Questions

Java

• 全部展开 全部折叠
• "Error 0x140200f9: File already added" when encrypting a Java application URL copied to clipboard
  This error message usually occurs, if the AxProtector components were packed into the JAR archive when building the application or the JAR archive.
  
  Even if, for example, you use Wupi functions and have therefore referenced AxProtector, you must not pack the classes into the JAR archive.
  
  During encryption AxProtector automatically adds the required classes to the specified JAR archive or creates a separate WibuXpm4JRutnime.jar archive containing the required classes when using the AxProtector option '-jos'.
• [Int] Encrypting Spring applications URL copied to clipboard
  On encrypting Spring applications Wibu-Systems recommends to customize the following AxProtector options:
  
  Creating of valid Java class files
  To ensure that Spring on start is properly interpreting your classes and annotations, it is important that AxProtector creates valid Java class files.
  This can be achieved by setting the commandline options -ci and -jff:c. In the AxProtector GUI navigate to the page Advanced Options and check the box controls IxProtector and create valid Java class files.
  
  Alternative User Message Handler
  If licensing errors occur by default dialogues display the user of the software has to interact with. Since this does not fit for server applications, an alternative User Message Handler exists implementing a different error handling, which does not require user interaction and a graphical user interface.
  For using it you must set the command line option -u:"com.wibu.xpm.MessageHandler".
  In the AxProtector GUI navigate to the page Error messages, check the Box control User message class, and specify the class name com.wibu.xpm.MessageHandler in the respective field.
  
  Using method encryption
  In some cases, Spring applications may experience problems if the entire class is encrypted. Therefore, it is recommended to use method encryption instead of class encryption.
  1. Export the encryption options as *.xml file.
  in the AxProtector GUI use menu item "File| Export".
  2. Replace in *.xml file:
  <Jar MethodProtectionLicenseList="None" ClassProtectionLicenseList="0" EntryPoint="false" >
  by
  <Jar MethodProtectionLicenseList="0" ClassProtectionLicenseList="None" EntryPoint="true" >
  3. Direct calling of file AxProtector.jar for encryption and transfer of the 
  *.xml Datei.
  e.g..: java -jar AxProtector.jar @protectionSettings.xml
• Date after encryption with AxProtector Java "1 Jan 1970". URL copied to clipboard
  The date is set to this value after the encryption to guarantee that several encryptions of the same application are binary identical - otherwise the modification date would be different.
  
  Alternative Vorgehensweise:
  For AxProtector version 10.30a and higher specify:
  -jb:60364
• Error "JVMTI detected" when using TomEE URL copied to clipboard
  The cause could be that you are using the Java archive file openejb-javaagent.jar, which is located in the libs directory of TomEE.
  This Java archive file in turn loads the instrument.dll library of the Java API. The library installs a JVMTI hook, which is correctly detected by the protected software and leads to this error.
  
  There are the following possible solutions for this:
  - First, you should check if you actually need the Java archive file openejb-javaagent.jar. If not, you may be able to do without it and remove it from the libs directory.
  - Alternatively, you can also disable the security option "-cag1" (JVMTI detection) during encryption.
• Reason for "Error: JVMTI SetEventCallback" URL copied to clipboard
  The message "Error: JVMTI SetEventCallBack cannot be used." is displayed because several wibuxpm4j files are loaded into the same process space.
  These files try several times to modify the JVM for AxProtector, i.e. to activate a hacking countermeasure. However, these files do not recognize that this has already taken place due to the loading of the library from different paths and therefore run into their own trap.
• Using 'Index.list' in a Java application to be encrypted URL copied to clipboard
  With AxProtector Java 10.20, the encryption of a Java application that contains an 'Index.list' will abort with an error.
  
  For example, if you were using AxProtector 10.10 and a JAR archive with an 'Index.list', in some cases the manifest was discarded due to a bug in Java. Therefore AxProtector 10.20 will abort the encryption here.
  
  With the AxProtector release >=10.30 the applications can be encrypted again without errors, even if the Index.list is currently not officially supported.
• WibuAxpJava64: fatal error WB1001 URL copied to clipboard
  The error 1001 means "FileNotFound".
  It occurred since your WkFirm.wbc file has not been found.
  
  The WkFirm.wbc file is required for programming licenses and encrypting applications.
  You should have received the file from our sales department when you purchased your Firm Code.
  
  If you have already successfully encrypted on another system, check if you can find this file there and copy it to the new system.
  This file should usually be located in the following directory:
  C:\Program Files (x86)\WibuKey\DevKit\Bin or C:\Program Files\WibuKey\DevKit\Bin respectively.