Descripción detallada

Gestión de sesiones de cliente con 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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd ) lanza una 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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		booleano	bLoadBalance ) lanza una 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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		Cadena	strOtp,
		booleano	bLoadBalance ) lanza una 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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		Cadena	strOtp ) lanza una 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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		int	nPuerto,
		int	nFlags ) lanza una 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.
nPuerto	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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		Cadena	strOtp,
		int	nPuerto,
		int	nFlags ) lanza una 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.
nPuerto	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[] sesión )

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

Parámetros

sesión Mango de sesión abierto anteriormente

◆ openSession() [7/12]

void openSession	(	Cadena	strAddr,
		TacAccessToken	stAToken,
		int	nPuerto,
		int	nFlags ) lanza una 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.
nPuerto	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	(	Cadena	strAddr,
		byte[]	jbaAToken,
		int	nPuerto,
		int	nFlags ) lanza una 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.
nPuerto	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	(	Cadena	strAddr,
		TacAccessToken	stAToken,
		int	nPuerto,
		booleano	bLoadBalance,
		booleano	bSessionCache,
		booleano	bEncrypted ) lanza una TacException

Establece una conexión con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM.
stAToken	Token de acceso al HSM.
nPuerto	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.
bEncriptado	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	(	Cadena	strAddr,
		byte[]	jbaAToken,
		int	nPuerto,
		booleano	bLoadBalance,
		booleano	bSessionCache,
		booleano	bEncrypted ) lanza una TacException

Establece una conexión con el HSM mediante AToken.

Parámetros

strAddr	Dirección IP del HSM.
jbaAToken	Token de acceso al HSM.
nPuerto	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.
bEncriptado	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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		int	nPuerto,
		booleano	bLoadBalance,
		booleano	bSessionCache,
		booleano	bEncrypted ) lanza una 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.
nPuerto	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.
bEncriptado	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	(	Cadena	strAddr,
		Cadena	strUsrId,
		Cadena	strPwd,
		Cadena	strOtp,
		int	nPuerto,
		booleano	bLoadBalance,
		booleano	bSessionCache,
		booleano	bEncrypted ) lanza una 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.
nPuerto	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.
bEncriptado	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 cerrarSesión ( int nFlags ) lanza una 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 cerrarSesión ( booleano bCerrarFísicamente ) lanza una TacException

Finaliza la conexión con el HSM.

Parámetros

bCerrarFísicamente 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 cerrarSesión ( ) lanza una 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 ( ) lanza una 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