com.entrust.toolkit.credentials

Class ExtractedUALData

java.lang.Object

com.entrust.toolkit.credentials.ExtractedUALData

public final class ExtractedUALData
extends java.lang.Object

A data structure that represents data extracted from a UAL file; an 'extracted UAL data' structure.

It contains the password that was extracted from the UAL file and an indicator for whether or not the UAL file requires updating.

Since:

7.1sp1

Method Summary

Modifier and Type	Method and Description
SecureStringBuffer	getPassword() Returns the password that was extracted from the UAL file.
boolean	isUpdateRequired() Indicates whether the UAL file requires an update (re-binding).

Methods inherited from class java.lang.Object

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

Method Detail

isUpdateRequired

public boolean isUpdateRequired()

Indicates whether the UAL file requires an update (re-binding).

This only applies to version 1 UAL files; version 0 UAL files never require updating.

Version 1 UAL files will require updating when one of the machine specific parameters used to protect the password has changed due to a hardware or software change in the underlying machine. Version 1 UAL files are designed to still be useable if a single machine specific parameter changes; however, if more than one machine specific parameters change, the file becomes unuseable. For this reason, when a single machine specific parameter changes, it is wise to update the UAL file to reflect this change so that it could sustain another future machine parameter change.

Returns:

true if the UAL files requires an update; false otherwise

getPassword

public SecureStringBuffer getPassword()

Returns the password that was extracted from the UAL file.

Returns:

the password