gov.va.med.vistalink.security.m

Class KernelSecurityHandshake

Object

KernelSecurityHandshake

public abstract class KernelSecurityHandshake
extends Object

Manages logon-related security handshake with M/VistA. Used for client/server logins.

Constructor Summary

Constructors

Constructor and Description
KernelSecurityHandshake()

Method Summary

Modifier and Type	Method and Description
static SecurityDataLogonResponse	doAVLogon(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory, String token)
static SecurityDataLogonResponse	doAVLogon(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory, String accessCode, String verifyCode, boolean requestCvc)
static SecurityDataChangeVcResponse	doChangeVerifyCode(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory, String vcOld, String vcNew, String vcNewCheck)
static SecurityDataUserDemographicsResponse	doGetUserDemographics(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory)
static SecurityDataLogoutResponse	doLogout(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory)
static SecurityDataSelectDivisionResponse	doSelectDivision(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory, String divisionIenToSelect)
static SecurityResponse	doSetupAndGetIntroText(VistaLinkConnection myConnection, SecurityResponseFactory securityResponseFactory)

Methods inherited from class Object

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

Constructor Detail

KernelSecurityHandshake

public KernelSecurityHandshake()

Method Detail

doSetupAndGetIntroText

public static SecurityResponse doSetupAndGetIntroText(VistaLinkConnection myConnection,
                                                      SecurityResponseFactory securityResponseFactory)
                                               throws ParserConfigurationException,
                                                      VistaLinkFaultException,
                                                      FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

Returns:

SecurityDataSetupAndIntroTextResponse

Throws:

ParserConfigurationException

VistaLinkFaultException

FoundationsException

doAVLogon

public static SecurityDataLogonResponse doAVLogon(VistaLinkConnection myConnection,
                                                  SecurityResponseFactory securityResponseFactory,
                                                  String accessCode,
                                                  String verifyCode,
                                                  boolean requestCvc)
                                           throws ParserConfigurationException,
                                                  VistaKernelHashCountLimitExceededException,
                                                  FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

accessCode - access code to login with

verifyCode - verify code to login with

requestCvc - boolean -- true to request changing verify code, false to not do that

Returns:

SecurityDataLogonResponse

Throws:

ParserConfigurationException

VistaKernelHashCountLimitExceededException

FoundationsException

doAVLogon

public static SecurityDataLogonResponse doAVLogon(VistaLinkConnection myConnection,
                                                  SecurityResponseFactory securityResponseFactory,
                                                  String token)
                                           throws ParserConfigurationException,
                                                  VistaKernelHashCountLimitExceededException,
                                                  FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

token - Kernel CCOW token to login with

Returns:

SecurityDataLogonResponse

Throws:

ParserConfigurationException

VistaKernelHashCountLimitExceededException

FoundationsException

doSelectDivision

public static SecurityDataSelectDivisionResponse doSelectDivision(VistaLinkConnection myConnection,
                                                                  SecurityResponseFactory securityResponseFactory,
                                                                  String divisionIenToSelect)
                                                           throws ParserConfigurationException,
                                                                  VistaLinkFaultException,
                                                                  FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

divisionIenToSelect - IEN string of the division to select

Returns:

SecurityDataSelectDivisionResponse

Throws:

ParserConfigurationException

VistaLinkFaultException

FoundationsException

doChangeVerifyCode

public static SecurityDataChangeVcResponse doChangeVerifyCode(VistaLinkConnection myConnection,
                                                              SecurityResponseFactory securityResponseFactory,
                                                              String vcOld,
                                                              String vcNew,
                                                              String vcNewCheck)
                                                       throws ParserConfigurationException,
                                                              VistaLinkFaultException,
                                                              FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

vcOld - old verify code

vcNew - new verify code

vcNewCheck - "check" presumably duplicate string for new verify code

Returns:

SecurityDataChangeVcResponse

Throws:

ParserConfigurationException

VistaLinkFaultException

FoundationsException

doGetUserDemographics

public static SecurityDataUserDemographicsResponse doGetUserDemographics(VistaLinkConnection myConnection,
                                                                         SecurityResponseFactory securityResponseFactory)
                                                                  throws ParserConfigurationException,
                                                                         VistaLinkFaultException,
                                                                         FoundationsException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

Returns:

SecurityDataUserDemographicsResponse

Throws:

ParserConfigurationException

VistaLinkFaultException

FoundationsException

doLogout

public static SecurityDataLogoutResponse doLogout(VistaLinkConnection myConnection,
                                                  SecurityResponseFactory securityResponseFactory)
                                           throws ParserConfigurationException,
                                                  VistaLinkFaultException,
                                                  FoundationsException,
                                                  ResourceException,
                                                  IOException

Parameters:

myConnection - The VistaLinkConnection connection to use

securityResponseFactory - An already instantiated SecurityResponseFactory

Throws:

ParserConfigurationException

VistaLinkFaultException

FoundationsException

ResourceException

IOException