net.nicholaswilliams.java.licensing.encryption

Interface PasswordProvider

public interface PasswordProvider

This specifies an interface for providing a password for decrypting a key or license. Every user of this library must implement this (one to three times). See the documentation for net.nicholaswilliams.java.licensing.encryption.RSAKeyPairGenerator, net.nicholaswilliams.java.licensing.licensor.LicenseCreator and LicenseManager for more information.

Since:

1.0.0

Version:

1.5.0

Author:

Nick Williams

Method Summary

Methods

Modifier and Type	Method and Description
char[]	getPassword() When integrating the license manager in your application, you must implement this interface.

Method Detail

getPassword

char[] getPassword()

When integrating the license manager in your application, you must implement this interface. It should return the password that you used when encrypting the key or license.

Also, do not implement this using any strings, i.e:

return "myInsecurePassword".toCharArray();

Strings persist in memory for a long time, and the string's contents cannot be overwritten. Using only a character array allows the license manager to overwrite the password when it is finished with it, thus keeping it in the memory pool for as short a time as possible.

Finally, the password must be between six and 32 characters (inclusively). We recommend it be at least 10 characters.

It is imperative that you obfuscate the bytecode for the implementation of this class. It is also imperative that the character array exist only for the life of this method (i.e., DO NOT store it as an instance or class field).

Returns:

the password in character array form.