Módulo SVault

Descripción detallada

Operaciones de tokenización y anonimización de datos.

Véase Documentación técnica de HSM sobre detalles de funcionamiento, especificaciones utilizadas, licencias e nombre comercial del módulo.

Operaciones de tokenización y anonimización de datos. Más...

Funciones
SVaultGenTokenResponse	GenSVaultToken (int op, SVaultGenTokenInfo tokenInfo, int reserved) throws TacException
	Tokeniza un dato, generando un token blob y su respectivo token.
SVaultGenTokenResponse	GenSVaultToken(SVaultGenTokenInfo tokenInfo ) throws TacException
	Tokeniza un dato, generando un token blob y su respectivo token.
SVaultGenTokenResponse	GenSVaultDigitToken (byte CKS, byte maskFlags, String MK, String secret) lanza una TacException
	Tokeniza los dígitos, generando un token blob y su respectivo token.
SVaultGenTokenResponse	GenSVaultStringToken (byte maskFlags, String MK, String secret) throws TacException
	Tokeniza una cadena UTF-8, generando un token blob y su respectivo token.
Cadena	GetSVaultTokenBlobData (int op, String MK, String mask, byte[] tokenBlob) lanza una TacException
	Recupera el secreto o token de datos tokenizados utilizando un token blob.
Cadena	GetSVaultSecret (String MK, String mask, byte[] tokenBlob) throws TacException
	Recupera el secreto de los datos tokenizados utilizando un token blob.
Cadena	GetSVaultToken (String MK, String mask, byte[] tokenBlob) throws TacException
	Recupera el token de los datos tokenizados utilizando un token blob.

Funciones

GenSVaultToken() [1/2]

SVaultGenTokenResponse GenSVaultToken	(	int	op,
		SVaultGenTokenInfo	tokenInfo,
		int	reserved ) throws TacException

Tokeniza un dato, generando un token blob y su respectivo token.

Parámetros

op	Tipo de operación. Debe ser 0.
tokenInfo	Detalles de la operación de tokenización
reserved	Reservado para uso futuro (debe ser 0).

Devolución

Excepciones

TacException

GenSVaultToken() [2/2]

SVaultGenTokenResponse GenSVaultToken

(

SVaultGenTokenInfo

tokenInfo

)

throws TacException

Tokeniza un dato, generando un token blob y su respectivo token.

Parámetros

tokenInfo

Detalles de la operación de tokenización

Devolución

Excepciones

TacException

GenSVaultDigitToken()

SVaultGenTokenResponse GenSVaultDigitToken	(	byte	CKS,
		byte	maskFlags,
		String	MK,
		String	secret ) throws TacException

Tokeniza los dígitos, generando un token blob y su respectivo token.

Parámetros

CKS	Define el tipo de suma de comprobación para la generación de fichas. Puede ser una de las opciones de la siguiente tabla Valor Operación TacNDJavaLib.D_SVAULT_CKS_NULL No genera una suma de comprobación. Sólo genera el token. TacNDJavaLib.D_SVAULT_CKS_CPF Genera los 2 dígitos de control del estándar CPF (Cadastro de Pessoas Físicas) en el token. El secreto debe contener solo números e incluir los dígitos de control. TacNDJavaLib.D_SVAULT_CKS_CNPJ Genera los 2 dígitos de verificación en el estándar CNPJ (Cadastro Nacional da Pessoa Jurídica) en el token. El secreto debe contener solo números e incluir los dígitos de verificación. TacNDJavaLib.D_SVAULT_CKS_PAN Genera un PAN (Primary Account Number) con un dígito de control válido en el token. El secreto debe estar completo y contener solo números. TacNDJavaLib.D_SVAULT_CKS_IEL Genera los 2 dígitos de control en el patrón del número de registro del votante en la ficha. El secreto debe contener solo números e incluir los dígitos de control.
maskFlags	Opciones de generación. Puede ser una de las opciones de la siguiente tabla Valor Operación 0 No utiliza máscaras para la generación de testigos ni para la recuperación de secretos. TacNDJavaLib.D_SVAULT_F_MASK_TOKEN Utiliza máscaras para generar el token. La máscara se puede pasar al recuperar el token o el secreto. TacNDJavaLib.D_SVAULT_F_MASK_SECRET Utiliza máscaras para generar el secreto. La máscara se puede pasar al recuperar el token o el secreto.
MK	Nombre de la clave utilizada para la protección de datos
secret	El secreto debe ser una cadena con números solamente. Debe tener un tamaño mínimo de TacNDJavaLib . D_SVAULT_MIN_TL y un tamaño máximo de TacNDJavaLib.D_SVAULT_MAX_TL.

Devolución

Excepciones

TacException

GenSVaultStringToken()

SVaultGenTokenResponse GenSVaultStringToken	(	byte	maskFlags,
		String	MK,
		String	secret ) throws TacException

Tokeniza una cadena UTF-8, generando un token blob y su respectivo token.

Parámetros

maskFlags	Opciones de generación. Puede ser una de las opciones de la siguiente tabla Valor Operación 0 No utiliza máscaras para la generación de testigos ni para la recuperación de secretos. TacNDJavaLib.D_SVAULT_F_MASK_TOKEN Utiliza máscaras para generar el token. La máscara se puede pasar al recuperar el token o el secreto. TacNDJavaLib.D_SVAULT_F_MASK_SECRET Utiliza máscaras para generar el secreto. La máscara se puede pasar al recuperar el token o el secreto.
MK	Nombre de la clave utilizada para la protección de datos
secret	El secreto debe ser una cadena UTF-8. Debe tener un tamaño mínimo de TacNDJavaLib . D_SVAULT_MIN_TL y un tamaño máximo de TacNDJavaLib.D_SVAULT_MAX_TL.

Devolución

Excepciones

TacException

GetSVaultTokenBlobData()

String GetSVaultTokenBlobData	(	int	op,
		String	MK,
		String	mask,
		byte[]	tokenBlob ) throws TacException

Recupera el secreto o token de datos tokenizados utilizando un token blob.

Esta API también permite recuperar el secreto enmascarado o el token.

Parámetros

op	Tipo de operación. Puede ser una de las opciones siguientes. Valor Significado TacNDJavaLib.D_SVAULT_GET_OP_SECRET Recupera el secreto. TacNDJavaLib.D_SVAULT_GET_OP_TOKEN Recupera la ficha.
MK	Nombre de la clave utilizada para la protección de datos.
mask	Patrón de máscara que se aplicará al secreto o token, según el definido al generar el token blob en GenSVaultToken(). Buffer con un tamaño mínimo de TacNDJavaLib.D_SVAULT_MIN_TL y máximo de TacNDJavaLib.D_SVAULT_MIN_TL que contiene la máscara. Puede ser una cadena vacía "" para no utilizar el enmascaramiento. La máscara es una cadena UTF-8 que contiene los caracteres que se aplicarán a los datos para enmascararlos. Pase '\0' en las posiciones en las que desee que se muestren los datos. Consulte los comentarios para ver ejemplos.
tokenBlob	Buffer de tamaño TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el blob token.

Devolución

Retorno definido en op

Excepciones

TacException

Notas

Ejemplos con secreto de valor "123456789".

1. Con la máscara "***" obtenemos el siguiente resultado: "***456789".
2. Con la máscara "9999" obtendremos el siguiente resultado: "999956789".
3. Con la máscara "***\0\0***" obtendremos el siguiente resultado: "***456***".

GetSVaultSecret()

String GetSVaultSecret	(	String	MK,
		String	mask,
		byte[]	tokenBlob ) throws TacException

Recupera el secreto de los datos tokenizados utilizando un token blob.

Esta API también permite recuperar el secreto enmascarado.

Parámetros

MK	Nombre de la clave utilizada para la protección de datos.
mask	Patrón de máscara que se aplicará al secreto o token, según el definido al generar el token blob en GenSVaultToken(). Buffer con un tamaño mínimo de TacNDJavaLib.D_SVAULT_MIN_TL y máximo de TacNDJavaLib.D_SVAULT_MIN_TL que contiene la máscara. Puede ser una cadena vacía "" para no utilizar el enmascaramiento. La máscara es una cadena UTF-8 que contiene los caracteres que se aplicarán a los datos para enmascararlos. Pase '\0' en las posiciones en las que desee que se muestren los datos. Consulta las notas sobre GetSVaultTokenBlobData() para ver ejemplos.
tokenBlob	Buffer de tamaño TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el blob token.

Devolución

secreto

Excepciones

TacException

GetSVaultToken()

String GetSVaultToken	(	String	MK,
		String	mask,
		byte[]	tokenBlob ) throws TacException

Recupera el token de los datos tokenizados utilizando un token blob.

Esta API también permite recuperar el token enmascarado.

Parámetros

MK	Nombre de la clave utilizada para la protección de datos.
mask	Patrón de máscara que se aplicará al secreto o token, según el definido al generar el token blob en GenSVaultToken(). Buffer con un tamaño mínimo de TacNDJavaLib.D_SVAULT_MIN_TL y máximo de TacNDJavaLib.D_SVAULT_MIN_TL que contiene la máscara. Puede ser una cadena vacía "" para no utilizar el enmascaramiento. La máscara es una cadena UTF-8 que contiene los caracteres que se aplicarán a los datos para enmascararlos. Pase '\0' en las posiciones en las que desee que se muestren los datos. Consulta las notas sobre GetSVaultTokenBlobData() para ver ejemplos.
tokenBlob	Buffer de tamaño TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el blob token.

Devolución

ficha

Excepciones

TacException