Descripción detallada

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

Consulte la documentación técnica del HSM.

Funciones
int AAP_API	DSVaultGenToken (HSESSIONCTX hSession, DWORD dwOp, BYTE pbInData, BYTE pbTokenBlob, DWORD pdwTokenBlobLen, char szToken, DWORD dwReserved)

int AAP_API	DSVaultGetData (HSESSIONCTX hSession, DWORD dwOp, const char szMK, const char szMask, BYTE pbTokenBlob, DWORD dwTokenBlobLen, char szData, DWORD *pdwDataLen, DWORD dwReserved)

Funciones

◆ DSVaultGenToken()

int AAP_API DSVaultGenToken	(	HSESSIONCTX	hSession,
		DWORD	dwOp,
		BYTE *	pbInData,
		BYTE *	pbTokenBlob,
		DWORD *	pdwTokenBlobLen,
		char *	szToken,
		DWORD	dwReserved )

#include <dinamo.h>

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

Parámetros

[in]	hSession	Contexto adquirido a través de la función DOpenSession().
[in]	dwOp	Tipo de operación. Debe ser 0.
[in]	pbInData	Datos de entrada para la generación de tokens. Debe utilizarse la estructura SVAULT_GEN_TOKEN.
[out]	pbTokenBlob	Buffer que contendrá el token blob. Pasar un tamaño de búfer D_SVAULT_TOKEN_BLOB_LEN en la entrada. `pdwTokenBlobLen` contendrá el tamaño del búfer de salida. O token blob protege la secreto y sus metadatos. Este búfer debe guardarse y utilizarse al llamar a DSVaultGetData() para la posterior recuperación del secreto o ficha.
[in,out]	pdwTokenBlobLen	Tamaño de `pbTokenBlob`. La entrada contiene el tamaño total del búfer `pbTokenBlob` y la salida contendrá el tamaño de los datos copiados en `pbTokenBlob`.
[out]	szToken	Cadena de longitud D_SVAULT_MAX_TL + 1 que contendrá el testigo generado. Se puede pasar NULL para no recuperar el token generado. El token puede recuperarse de nuevo usando la API DSVaultGetData().
[in]	dwReserved	Reservado para uso futuro (debe ser 0).

Devolución: 0 (CERO) si la función tiene éxito.
Consulte la sección Códigos de retorno para conocer otros valores.

Ver también: DSVaultGetData().

Ejemplos: tokenisation.c.

◆ DSVaultGetData()

int AAP_API DSVaultGetData	(	HSESSIONCTX	hSession,
		DWORD	dwOp,
		const char *	szMK,
		const char *	szMask,
		BYTE *	pbTokenBlob,
		DWORD	dwTokenBlobLen,
		char *	szData,
		DWORD *	pdwDataLen,
		DWORD	dwReserved )

#include <dinamo.h>

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

[in] hSession Contexto adquirido a través de la función DOpenSession().

[in]

dwOp

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

Valor	Significado
D_SVAULT_GET_OP_SECRET	Recupera el secreto.
D_SVAULT_GET_OP_TOKEN	Recupera la ficha.

[in] szMK Nombre de la clave utilizada para la protección de datos.

[in] szMask Patrón de máscara que se aplicará al secreto o token, según el definido al generar el token blob en DSVaultGenToken(). Buffer con un tamaño mínimo de D_SVAULT_MIN_TL y máximo de D_SVAULT_MAX_TL que contiene la máscara. Puede ser NULL para no utilizar la máscara. 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 donde desee que se muestren los datos. Consulte los comentarios para ver ejemplos.

[in] pbTokenBlob Buffer de tamaño D_SVAULT_TOKEN_BLOB_LEN, generado por la API DSVaultGenToken(), que contiene el token blob.

[in] dwTokenBlobLen Búfer de tamaño máximo de D_SVAULT_TOKEN_BLOB_LEN, generado por la API DSVaultGenToken(), que contiene el token blob.

[out] szData Cadena que contendrá el ficha o el secreto como se especifica en dwOp. Puede utilizar un tamaño de D_SVAULT_MAX_TL + 1 para cubrir todos los datos actuales.

[in,out] pdwDataLen Tamaño de la cadena szData. Debe contener el tamaño de szData y el retorno de la API contendrá el tamaño total de los datos copiados.

[in] dwReserved Reservado para uso futuro (debe ser 0).

Devolución: 0 (CERO) si la función tiene éxito.
Consulte la sección Códigos de retorno para conocer otros valores.

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***"

Ver también: DSVaultGenToken().

Ejemplos: tokenisation.c.