Descripción detallada

Gestión de sesiones de cliente con HSM.

Consulte la documentación técnica del HSM.

Funciones
void	openSession (String strAddr, String strUsrId, String strPwd) throws TacException
	Establece una conexión cifrada con el HSM.

void	openSession (String strAddr, String strUsrId, String strPwd, boolean bLoadBalance) throws TacException
	Establece una conexión cifrada con el HSM.

void	openSession (String strAddr, String strUsrId, String strPwd, String strOtp, boolean bLoadBalance) throws TacException
	Establece una conexión cifrada con el HSM mediante OTP.

void	openSession (String strAddr, String strUsrId, String strPwd, String strOtp) throws TacException
	Establece una conexión cifrada con el HSM mediante OTP.

void	openSession (String strAddr, String strUsrId, String strPwd, int nPort, int nFlags) throws TacException
	Establece una conexión cifrada con el HSM utilizando los ajustes de equilibrio de carga.

void	openSession (String strAddr, String strUsrId, String strPwd, String strOtp, int nPort, int nFlags) throws TacException
	Establece una conexión cifrada con el HSM utilizando las configuraciones de equilibrio de carga y OTP.

void	setOpenSession (byte[] sesión)
	Define un gestor de sesión previamente abierto que se utilizará en esta instancia.

void	openSession (String strAddr, TacAccessToken stAToken, int nPort, int nFlags) throws TacException
	Establece una conexión cifrada con el HSM mediante AToken.

void	openSession (String strAddr, byte[] jbaAToken, int nPort, int nFlags) throws TacException
	Establece una conexión cifrada con el HSM mediante AToken.

void	openSession (String strAddr, TacAccessToken stAToken, int nPort, boolean bLoadBalance, boolean bSessionCache, boolean bEncrypted) throws TacException
	Establece una conexión con el HSM mediante AToken.

void	openSession (String strAddr, byte[] jbaAToken, int nPort, boolean bLoadBalance, boolean bSessionCache, boolean bEncrypted) throws TacException
	Establece una conexión con el HSM mediante AToken.

void	openSession (String strAddr, String strUsrId, String strPwd, int nPort, boolean bLoadBalance, boolean bSessionCache, boolean bEncrypted) throws TacException
	Establece una conexión cifrada con el HSM.

void	openSession (String strAddr, String strUsrId, String strPwd, String strOtp, int nPort, boolean bLoadBalance, boolean bSessionCache, boolean bEncrypted) throws TacException
	Establece una conexión cifrada con el HSM mediante OTP.

void	closeSession (int nFlags) throws TacException
	Finaliza la conexión con el HSM.

void	closeSession (boolean bPhysicallyClose) throws TacException
	Finaliza la conexión con el HSM.

void	closeSession () lanza una TacException
	Finaliza la sesión devolviendo la conexión abierta al pool de gestión.

largo	getCID () throws TacException
	Recupera el CID (ID de correlación) de la sesión actual.

Funciones

◆ openSession() [1/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd ) throws TacException

Establece una conexión cifrada con el HSM.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario del HSM.

Excepciones

TacException Se lanza cuando se produce un error de acceso o validación de usuario.

◆ openSession() [2/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		boolean	bLoadBalance ) throws TacException

Establece una conexión cifrada con el HSM.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario del HSM.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga

Excepciones

TacException Se lanza cuando se produce un error de acceso o validación de usuario.

◆ openSession() [3/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		String	strOtp,
		boolean	bLoadBalance ) throws TacException

Establece una conexión cifrada con el HSM mediante OTP.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario del HSM.
strOtp	OTP de usuario HSM.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga

Excepciones

TacException Se lanza cuando se produce un error de acceso o validación de usuario.

◆ openSession() [4/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		String	strOtp ) throws TacException

Establece una conexión cifrada con el HSM mediante OTP.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario del HSM.
strOtp	OTP de usuario HSM.

Excepciones

TacException Se lanza cuando se produce un error de acceso o validación de usuario.

◆ openSession() [5/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión cifrada con el HSM utilizando los ajustes de equilibrio de carga.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario de HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
nFlags	Siempre igual a cero.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [6/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		String	strOtp,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión cifrada con el HSM utilizando las configuraciones de equilibrio de carga y OTP.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario de HSM.
strOtp	HSM Usuario Otp.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
nFlags	Siempre igual a cero.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ setOpenSession()

void setOpenSession ( byte[] session )

Define un gestor de sesión previamente abierto que se utilizará en esta instancia.

Parámetros

session Mango de sesión abierto anteriormente

◆ openSession() [7/12]

void openSession	(	String	strAddr,
		TacAccessToken	stAToken,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión cifrada con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
stAToken	Token de acceso al HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
nFlags	Siempre igual a cero.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [8/12]

void openSession	(	String	strAddr,
		byte[]	jbaAToken,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión cifrada con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM. Si se deja en blanco, el sistema utiliza el equilibrio de carga.
jbaAToken	Token de acceso al HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
nFlags	Siempre igual a cero.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [9/12]

void openSession	(	String	strAddr,
		TacAccessToken	stAToken,
		int	nPort,
		boolean	bLoadBalance,
		boolean	bSessionCache,
		boolean	bEncrypted ) throws TacException

Establece una conexión con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM.
stAToken	Token de acceso al HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga
bSessionCache	Si es true, utiliza el gestor de caché de sesión.
bEncrypted	Si es true, usa una conexión encriptada. Algunas operaciones, como generar claves o cambiar la contraseña de usuario, sólo pueden utilizarse en conexiones cifradas.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [10/12]

void openSession	(	String	strAddr,
		byte[]	jbaAToken,
		int	nPort,
		boolean	bLoadBalance,
		boolean	bSessionCache,
		boolean	bEncrypted ) throws TacException

Establece una conexión con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM.
jbaAToken	Token de acceso al HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga
bSessionCache	Si es true, utiliza el gestor de caché de sesión.
bEncrypted	Si es true, usa una conexión encriptada. Algunas operaciones, como generar claves o cambiar la contraseña de usuario, sólo pueden utilizarse en conexiones cifradas.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [11/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		int	nPort,
		boolean	bLoadBalance,
		boolean	bSessionCache,
		boolean	bEncrypted ) throws TacException

Establece una conexión cifrada con el HSM.

Parámetros

strAddr	Dirección IP del HSM.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario de HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga
bSessionCache	Si es true, utiliza el gestor de caché de sesión.
bEncrypted	Si es true, usa una conexión encriptada. Algunas operaciones, como generar claves o cambiar la contraseña de usuario, sólo pueden utilizarse en conexiones cifradas.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ openSession() [12/12]

void openSession	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		String	strOtp,
		int	nPort,
		boolean	bLoadBalance,
		boolean	bSessionCache,
		boolean	bEncrypted ) throws TacException

Establece una conexión cifrada con el HSM mediante OTP.

Parámetros

strAddr	Dirección IP del HSM.
strUsrId	Usuario de HSM.
strPwd	Contraseña de usuario de HSM.
strOtp	OTP de usuario HSM.
nPort	Puerto HSM. Nota: solo se puede utilizar 4433.
bLoadBalance	Si es verdadero, utiliza el equilibrio de carga
bSessionCache	Si es true, utiliza el gestor de caché de sesión.
bEncrypted	Si es true, usa una conexión encriptada. Algunas operaciones, como generar claves o cambiar la contraseña de usuario, sólo pueden utilizarse en conexiones cifradas.

Excepciones

TacException Se lanza cuando hay un error en el acceso o validación del Usuario.

◆ closeSession() [1/3]

void closeSession ( int nFlags ) throws TacException

Finaliza la conexión con el HSM.

Parámetros

nFlags Siempre igual a cero.

Excepciones

TacException Publicado en caso de que no se cierre la sesión.

◆ closeSession() [2/3]

void closeSession ( boolean bPhysicallyClose ) throws TacException

Finaliza la conexión con el HSM.

Parámetros

bPhysicallyClose Determina si la sesión se cerrará físicamente o sólo se liberará en la caché local.

Excepciones

TacException Publicado en caso de que no se cierre la sesión.

◆ closeSession() [3/3]

void closeSession ( ) throws TacException

Finaliza la sesión devolviendo la conexión abierta al pool de gestión.

Excepciones

TacException Publicado en caso de que no se cierre la sesión.

◆ getCID()

long getCID ( ) throws TacException

Recupera el CID (ID de correlación) de la sesión actual.

El CID permite relacionar la operación en el cliente HSM con los registros del HSM. El CID sólo está disponible cuando existe una sesión establecida con el HSM, de lo contrario el valor será 0 (cero). Este número suele representarse en hexadecimal.

Devolución: CID

Excepciones

TacException Lanza una excepción en caso de error