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

Methods

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 ExtractedUALData	extractPassword(java.io.InputStream ual) Extracts the password stored and protected in an Entrust Unattended Login (UAL) file.

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

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