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.

Funciones
SVaultGenTokenResponse	GenSVaultToken (UInt32 Op, DinamoApi.SVAULT_GEN_TOKEN TokenInfo, UInt32 Reserved)
	Tokeniza un dato, generando un token blob y su respectivo token.

SVaultGenTokenResponse	GenSVaultToken (DinamoApi.SVAULT_GEN_TOKEN TokenInfo)
	Tokeniza un dato, generando un token blob y su respectivo token.

SVaultGenTokenResponse	GenSVaultDigitToken (byte CKS, byte MaskFlags, cadena MK, cadena Secret)
	Tokeniza los dígitos, generando un token blob y su respectivo token.

SVaultGenTokenResponse	GenSVaultStringToken (byte MaskFlags, cadena MK, cadena Secret)
	Tokeniza una cadena UTF-8, generando un token blob y su respectivo token.

cadena	GetSVaultTokenBlobData (UInt32 Op, cadena MK, cadena Mask, byte[] TokenBlob)
	Recupera el secreto o token de datos tokenizados utilizando un blob de token. Esta API también permite recuperar el secreto o token enmascarado.

cadena	GetSVaultSecret (cadena MK, cadena Mask, byte[] TokenBlob)
	Recupera el secreto de datos tokenizados utilizando un token blob. Esta API también permite recuperar el secreto enmascarado.

cadena	GetSVaultToken (cadena MK, cadena Mask, byte[] TokenBlob)
	Recupera el token de los datos tokenizados utilizando un blob de token. Esta API también permite recuperar el token enmascarado.

Funciones

◆ GenSVaultToken() [1/2]

SVaultGenTokenResponse GenSVaultToken	(	UInt32	Op,
		DinamoApi.SVAULT_GEN_TOKEN	TokenInfo,
		UInt32	Reserved )

inline

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: Token blob y token.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ GenSVaultToken() [2/2]

SVaultGenTokenResponse GenSVaultToken ( DinamoApi.SVAULT_GEN_TOKEN TokenInfo )

inline

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

Parámetros

TokenInfo Detalles de la operación de tokenización.

Devolución: Token blob y token.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ GenSVaultDigitToken()

SVaultGenTokenResponse GenSVaultDigitToken	(	byte	CKS,
		byte	MaskFlags,
		string	MK,
		string	Secret )

inline

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
DinamoApi.D_SVAULT_CKS_NULL	No genera una suma de comprobación. Sólo genera el token.
DinamoApi.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.
DinamoApi.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.
DinamoApi.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.
DinamoApi.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.
DinamoApi.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.
DinamoApi.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 sólo con números. Debe tener una longitud mínima de puntos de codificación DinamoApi . D_SVAULT_MIN_TL y máxima de unidades de codificación DinamoApi.D_SVAULT_MAX_TL.

Devolución: Token blob y token.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: tokenisation.cs.

◆ GenSVaultStringToken()

SVaultGenTokenResponse GenSVaultStringToken	(	byte	MaskFlags,
		string	MK,
		string	Secret )

inline

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.
DinamoApi.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.
DinamoApi.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 sólo con números. Debe tener una longitud mínima de puntos de codificación DinamoApi . D_SVAULT_MIN_TL y máxima de unidades de codificación DinamoApi.D_SVAULT_MAX_TL.

Devolución: Token blob y token.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: tokenisation.cs.

◆ GetSVaultTokenBlobData()

string GetSVaultTokenBlobData	(	UInt32	Op,
		string	MK,
		string	Mask,
		byte[]	TokenBlob )

inline

Recupera el secreto o token de datos tokenizados utilizando un blob de token. Esta API también permite recuperar el secreto o token enmascarado.

Parámetros

Op

Tipo de operación. Puede ser una de las opciones siguientes.

Valor	Significado
DinamoApi.D_SVAULT_GET_OP_SECRET	Recupera el secreto.
DinamoApi.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áximo de DinamoApi.D_SVAULT_MAX_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 DinamoApi.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el token blob.

Devolución: Devolución según lo definido en op.

Excepciones

DinamoException Lanza una excepción en caso de error.

Notas

Ejemplos de uso de una máscara. En este ejemplo utilizaremos un secreto con el valor "123456789". Utilizando la máscara "***" obtendremos el siguiente resultado.

"***456789"

Aplicando la máscara "9999" obtendremos el siguiente resultado.

"999956789"

Aplicando la máscara "***\0\0***" obtendremos el siguiente resultado.

"***456***"

◆ GetSVaultSecret()

string GetSVaultSecret	(	string	MK,
		string	Mask,
		byte[]	TokenBlob )

inline

Recupera el secreto de 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áximo de DinamoApi.D_SVAULT_MAX_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 DinamoApi.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el token blob.

Devolución: secreto

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: tokenisation.cs.

◆ GetSVaultToken()

string GetSVaultToken	(	string	MK,
		string	Mask,
		byte[]	TokenBlob )

inline

Recupera el token de los datos tokenizados utilizando un blob de token. 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áximo de DinamoApi.D_SVAULT_MAX_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 DinamoApi.D_SVAULT_TOKEN_BLOB_LEN, generado por la API GenSVaultToken(), que contiene el token blob.

Devolución: ficha

Excepciones

DinamoException Lanza una excepción en caso de error.