com.entrust.toolkit.credentials

Class UALUtil

java.lang.Object

com.entrust.toolkit.credentials.UALUtil

public final class UALUtil
extends java.lang.Object

Contains various utility APIs related to Entrust Unattended Login (UAL).

UAL requires native code contained in the UALJNI library; this library must be installed on the machine in order to use this class. UAL should only be used on machines that are physically secured.

Since:

7.1sp1

Method Summary

Modifier and Type	Method and Description
static void	bind(SecureStringBuffer password, java.io.OutputStream ual) Binds the given password to the machine by generating an Entrust Unattended Login (UAL) file.
static void	bindJTK8Format(SecureStringBuffer password, java.io.OutputStream ual) Binds the given password using a UAL format that is compatible with Java Toolkit versions 8.x and previous.
static ExtractedUALData	extractPassword(java.io.InputStream ual) Extracts the password stored and protected in an Entrust Unattended Login (UAL) file.
static byte[]	getFingerprint(int i)
static int	getItemCount()
static int	getIterationCount(java.io.InputStream ual)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

bind

public static void bind(SecureStringBuffer password,
                        java.io.OutputStream ual)
                 throws UALException

Binds the given password to the machine by generating an Entrust Unattended Login (UAL) file.

Parameters:

password - the password to be bound to the machine

ual - the output stream from which UAL file will be written

Throws:

UALException - if the bind operation fails

java.lang.SecurityException - if the Entrust CSP has not been installed

bindJTK8Format

public static void bindJTK8Format(SecureStringBuffer password,
                                  java.io.OutputStream ual)
                           throws UALException

Binds the given password using a UAL format that is compatible with Java Toolkit versions 8.x and previous. This method is included for backwards compatibility and should only be used if the UAL generated by this toolkit will be used by an application that uses an 8.x or earlier version of the Java toolkit.

Throws:

UALException

extractPassword

public static ExtractedUALData extractPassword(java.io.InputStream ual)
                                        throws UALException

Extracts the password stored and protected in an Entrust Unattended Login (UAL) file.

Parameters:

ual - the input stream from which the UAL file can be read

Returns:

the information extracted from the UAL file (password and an indication of whether or not the UAL file requires an update)

Throws:

UALException - if the UAL file is invalid or corrupt

java.lang.SecurityException - if the Entrust CSP has not been installed

getFingerprint

public static byte[] getFingerprint(int i)

getItemCount

public static int getItemCount()

getIterationCount

public static int getIterationCount(java.io.InputStream ual)
                             throws UALException

Throws:

UALException