Sesión

Descripción detallada

Gestión de sesiones de cliente con el HSM.

Véase Documentación técnica de HSM.

Gestión de sesiones de cliente con HSM. Más...

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.
matriz estática de bytes	getHSMTLSCert (String strAddr, int nPort, int nOutFormat) throws TacException
	Recupera el certificado TLS del HSM sin iniciar una sesión autenticada.
void	openSessionCert (String strAddr, String strUsrId, String strPwd, byte[] baPrivKey, String strPrivKeyPwd, byte[] baPrivKeyCert, byte[] baHSMCert, int nPort, int nFlags) throws TacException
	Establece una conexión con el HSM autenticada mediante nombre de usuario, contraseña y certificado (autenticación mutua TLS).
void	openSessionHsmCert (String strAddr, String strUsrId, String strPwd, byte[] baHSMCert, int nPort, int nFlags) throws TacException
	Establece una conexión con el HSM autenticada mediante nombre de usuario, contraseña y verificación del certificado del HSM.
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.

getHSMTLSCert()

static byte[] getHSMTLSCert ( String strAddr, int nPort, int nOutFormat ) throws TacException

static

Recupera el certificado TLS del HSM sin iniciar una sesión autenticada.

Este método es estático y no requiere una sesión abierta. Normalmente se invoca antes de openSessionCert para obtener el certificado del servidor que se verificará durante la autenticación mutua TLS.

Parámetros

strAddr	Dirección IP o nombre del HSM.
nPort	Puerto TCP del HSM (normalmente TacNDJavaLib#DEFAULT_PORT).
nOutFormat	Formato del certificado de salida. TacNDJavaLib#CERT_OUT_DER — X.509 DER TacNDJavaLib#CERT_OUT_PEM — X.509 PEM

Devolución

Certificado del HSM en el formato especificado en nOutFormat.

Excepciones

TacException

Se produce cuando se produce un error al recuperar el certificado.

openSessionCert()

void openSessionCert	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		byte[]	baPrivKey,
		String	strPrivKeyPwd,
		byte[]	baPrivKeyCert,
		byte[]	baHSMCert,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión con el HSM autenticada mediante nombre de usuario, contraseña y certificado (autenticación mutua TLS).

El HSM autentica al cliente mediante su clave privada y su certificado a nivel de TLS, y el cliente verifica la identidad del HSM utilizando el certificado del servidor (baHSMCert). Ambas partes se autentican mutuamente.

Parámetros

strAddr	Dirección IP o nombre del HSM.
strUsrId	Identificación del usuario en el HSM.
strPwd	Contraseña de usuario.
baPrivKey	Clave privada del cliente en formato PEM.
strPrivKeyPwd	Contraseña de la clave privada especificada en baPrivKey. Si no hay contraseña, se debe pasar un valor nulo o una cadena vacía.
baPrivKeyCert	Certificado del cliente (par de la clave privada) en formato PEM o DER. Se utiliza para la autenticación TLS mutua a nivel de canal.
baHSMCert	Certificado HSM en formato PEM o DER. Obtenido con getHSMTLSCert().
nPort	Puerto TCP del HSM (normalmente TacNDJavaLib#DEFAULT_PORT).
nFlags	Combinación de indicadores de sesión, por ejemplo TacNDJavaLib#ENCRYPTED_CONN.

Excepciones

TacException

Se lanza cuando se produce un error al iniciar sesión.

openSessionHsmCert()

void openSessionHsmCert	(	String	strAddr,
		String	strUsrId,
		String	strPwd,
		byte[]	baHSMCert,
		int	nPort,
		int	nFlags ) throws TacException

Establece una conexión con el HSM autenticada mediante nombre de usuario, contraseña y verificación del certificado del HSM.

El certificado TLS del HSM se verifica con baHSMCert antes de continuar con la autenticación mediante nombre de usuario y contraseña. El cliente no presenta un certificado propio; utilice openSessionCert para la autenticación mutua TLS.

Parámetros

strAddr	Dirección IP o nombre del HSM.
strUsrId	Identificación del usuario en el HSM.
strPwd	Contraseña de usuario.
baHSMCert	Certificado del HSM en formato PEM o DER. Obtenido con getHSMTLSCert(String, int, int).
nPort	Puerto TCP del HSM (normalmente TacNDJavaLib#DEFAULT_PORT).
nFlags	Combinación de indicadores de sesión, por ejemplo TacNDJavaLib#ENCRYPTED_CONN.

Excepciones

TacException

Se lanza cuando se produce un error al iniciar sesión.

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