gov.va.med.crypto.VistaKernelHash ICR (5171)

Name

Value

NUMBER

5171

IA #

5171

DATE CREATED

2008/04/11

CUSTODIAL PACKAGE

FOUNDATIONS

USAGE

Supported

TYPE

Other

DBIC APPROVAL STATUS

APPROVED

NAME

gov.va.med.crypto.VistaKernelHash

GENERAL DESCRIPTION

public class VistaKernelHash extends java.lang.Object:

Implements static methods to provide the encoding algorithms used by the RPC
Broker and Kernel to encode and decode data strings. Using these algorithms
makes it harder to sniff the contents of text sent over the network. This is
not, however, encryption-class encoding, nor does it protect against replay
attacks of un-decoded strings, and therefore use of this algorithm should not
be considered to imply or achieve any particular level of security.

For example:

String encodedString = VistaKernelHash.encrypt("some text to encode", true);

STATUS

Active

KEYWORDS

Foundations
FoundationsLib
VistaKernelHash

DURATION

Till Otherwise Agreed

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

decrypt()

public static java.lang.String
decrypt(java.lang.String encryptedText):

Decrypts a string using the same encoding algorithm as the RPC Broker uses.

VARIABLES	TYPE	VARIABLES DESCRIPTION
encryptedText	Input	java.lang.String: The text to decode. Must be characters between ASCII 32 and 128.
return	Output	returns java.lang.String: a decrypted (decoded) version of the input string.

encrypt()

public static java.lang.String
encrypt(java.lang.String normalText, boolean
preventEncryptionsContainingCDataSectionBoundaries) throws
VistaKernelHashCountLimitExceededException:

Encrypts a string using the same encoding algorithm as the RPC Broker uses.

VARIABLES	TYPE	VARIABLES DESCRIPTION
normalText	Input	java.lang.String normalText: the text to encode. Must be characters between ASCII 32 and 128.
preventEncryptionsCont	Input	boolean preventEncryptionsContainingCDataSectionBoundaries: if true, the returned encrypted strings are guaranteed not to contain either "]]>" or "<![CDATA[". Otherwise, it is possible a returned encryption may conta in those character sequences.
return	Output	returns java.lang.String: an encrypted (encoded) version of the input string.
throws	Output	throws gov.va.med.crypto.VistaKernelHashCountLimitExceededException: if requested that the method not return a result with CData section boundaries, and if the algorithm runs up to a count limit (presently 2000 tries) without generating a result without such boundaries, an exception is thrown.

DATE ACTIVATED

2008/07/11