Descrição detalhada

Operações de tokenização e anonimização de dados.

Consulte a documentação técnica do HSM sobre detalhes de funcionamento, especificações utilizadas, licenças e nome comercial do módulo.

Operações de tokenização e anonimização de dados. Mais...

Funções
SVaultGenTokenResponse	GenSVaultToken (int op, SVaultGenTokenInfo tokenInfo, int reserved) throws TacException
	Faz a tokenização de um dado, gerando um token blob e seu respectivo token.

SVaultGenTokenResponse	GenSVaultToken (SVaultGenTokenInfo tokenInfo) throws TacException
	Faz a tokenização de um dado, gerando um token blob e seu respectivo token.

SVaultGenTokenResponse	GenSVaultDigitToken (byte CKS, byte maskFlags, String MK, String secret) throws TacException
	Faz a tokenização de dígitos, gerando um token blob e seu respectivo token.

SVaultGenTokenResponse	GenSVaultStringToken (byte maskFlags, String MK, String secret) throws TacException
	Faz a tokenização de uma string UTF-8, gerando um token blob e seu respectivo token.

String	GetSVaultTokenBlobData (int op, String MK, String mask, byte[] tokenBlob) throws TacException
	Recupera o secret ou token um dado tokenizado utilizando um token blob.

String	GetSVaultSecret (String MK, String mask, byte[] tokenBlob) throws TacException
	Recupera o secret um dado tokenizado utilizando um token blob.

String	GetSVaultToken (String MK, String mask, byte[] tokenBlob) throws TacException
	Recupera o token um dado tokenizado utilizando um token blob.

Funções

◆ GenSVaultToken() [1/2]

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

Faz a tokenização de um dado, gerando um token blob e seu respectivo token.

Parâmetros

op	Tipo da operação. Deverá ser 0.
tokenInfo	Detalhes da operação de tokenização
reserved	Reservado para uso futuro (deve ser 0).

Retorna

Exceções

TacException

◆ GenSVaultToken() [2/2]

SVaultGenTokenResponse GenSVaultToken ( SVaultGenTokenInfo tokenInfo ) throws TacException

Faz a tokenização de um dado, gerando um token blob e seu respectivo token.

Parâmetros

tokenInfo Detalhes da operação de tokenização

Retorna

Exceções

TacException

◆ GenSVaultDigitToken()

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

Faz a tokenização de dígitos, gerando um token blob e seu respectivo token.

Parâmetros

CKS

Define o tipo de checksum para a geração de tokens. Pode ser uma das opções da tabela abaixo

Valor	Operação
TacNDJavaLib.D_SVAULT_CKS_NULL	Não faz geração de checksum. Apenas gera o token.
TacNDJavaLib.D_SVAULT_CKS_CPF	Gera os 2 dígitos verificadores no padrão CPF (Cadastro de Pessoas Físicas) no token. O secret deverá conter apenas números e incluir os dígitos verificadores.
TacNDJavaLib.D_SVAULT_CKS_CNPJ	Gera os 2 dígitos verificadores no padrão CNPJ (Cadastro Nacional da Pessoa Jurídica) no token. O secret deverá conter apenas números e incluir os dígitos verificadores.
TacNDJavaLib.D_SVAULT_CKS_PAN	Gera um PAN (Primary Account Number) com o dígito verificador válido no token. O secret deverá ser completo e conter apenas números.
TacNDJavaLib.D_SVAULT_CKS_IEL	Gera os 2 dígitos verificadores no padrão do número do título de eleitor no token. O secret deverá conter apenas números e incluir os dígitos verificadores.

maskFlags

Opções de geração. Pode ser uma das opções da tabela abaixo

Valor	Operação
0	Não utiliza máscaras para geração do token ou recuperação do secret.
TacNDJavaLib.D_SVAULT_F_MASK_TOKEN	Utiliza máscaras para geração do token. A máscara poderá ser passada ao recuperar o token ou secret.
TacNDJavaLib.D_SVAULT_F_MASK_SECRET	Utiliza máscaras para geração do secret. A máscara poderá ser passada ao recuperar o token ou secret.

MK Nome da chave utilizada para a proteção do dados

secret O secret que deverá ser uma string apenas com números. Deverá ter tamanho mínimo de TacNDJavaLib.D_SVAULT_MIN_TL e máximo de TacNDJavaLib.D_SVAULT_MAX_TL

Retorna

Exceções

TacException

◆ GenSVaultStringToken()

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

Faz a tokenização de uma string UTF-8, gerando um token blob e seu respectivo token.

Parâmetros

maskFlags

Opções de geração. Pode ser uma das opções da tabela abaixo

Valor	Operação
0	Não utiliza máscaras para geração do token ou recuperação do secret.
TacNDJavaLib.D_SVAULT_F_MASK_TOKEN	Utiliza máscaras para geração do token. A máscara poderá ser passada ao recuperar o token ou secret.
TacNDJavaLib.D_SVAULT_F_MASK_SECRET	Utiliza máscaras para geração do secret. A máscara poderá ser passada ao recuperar o token ou secret.

MK Nome da chave utilizada para a proteção do dados

secret O secret que deverá ser uma string UTF-8. Deverá ter tamanho mínimo de TacNDJavaLib.D_SVAULT_MIN_TL e máximo de TacNDJavaLib.D_SVAULT_MAX_TL.

Retorna

Exceções

TacException

◆ GetSVaultTokenBlobData()

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

Recupera o secret ou token um dado tokenizado utilizando um token blob.

Esta API também permite a recuperação do secret ou token mascarados.

Parâmetros

op

Tipo da operação. Poderá ser uma das opções abaixo.

Valor	Significado
TacNDJavaLib.D_SVAULT_GET_OP_SECRET	Recupera o secret.
TacNDJavaLib.D_SVAULT_GET_OP_TOKEN	Recupera o token.

MK Nome da chave utilizada para a proteção do dados.

mask Padrão de máscara que será aplicado ao secret ou token, de acordo com o definido na geração do token blob em GenSVaultToken(). Buffer com tamanho mínimo de TacNDJavaLib.D_SVAULT_MIN_TL e máximo de TacNDJavaLib.D_SVAULT_MIN_TL contendo a máscara. Pode ser string vazia "" para não utilizar mascaramento. A máscara é uma string UTF-8 que contém os caracteres que serão aplicados sobre os dados fazendo o mascaramento do mesmo. Passe '\0' nas posições onde queira que o dado seja apresentado. Veja as observações para exemplos.

tokenBlob Buffer de tamanho TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, gerado pela API GenSVaultToken(), contendo o token blob.

Retorna: Retorno de acordo com o definido em op

Exceções

TacException

Anotações

Exemplos com um secret de valor "123456789".

Com a máscara "***" teremos o seguinte resultado: "***456789".
Com a máscara "9999" teremos o seguinte resultado: "999956789".
Com a máscara "***\0\0\0***" teremos o seguinte resultado: "***456***".

◆ GetSVaultSecret()

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

Recupera o secret um dado tokenizado utilizando um token blob.

Esta API também permite a recuperação do secret mascarado.

Parâmetros

MK	Nome da chave utilizada para a proteção do dados.
mask	Padrão de máscara que será aplicado ao secret ou token, de acordo com o definido na geração do token blob em GenSVaultToken(). Buffer com tamanho mínimo de TacNDJavaLib.D_SVAULT_MIN_TL e máximo de TacNDJavaLib.D_SVAULT_MIN_TL contendo a máscara. Pode ser string vazia "" para não utilizar mascaramento. A máscara é uma string UTF-8 que contém os caracteres que serão aplicados sobre os dados fazendo o mascaramento do mesmo. Passe '\0' nas posições onde queira que o dado seja apresentado. Veja as observações de GetSVaultTokenBlobData() para exemplos.
tokenBlob	Buffer de tamanho TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, gerado pela API GenSVaultToken(), contendo o token blob.

Retorna: secret

Exceções

TacException

◆ GetSVaultToken()

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

Recupera o token um dado tokenizado utilizando um token blob.

Esta API também permite a recuperação do token mascarado.

Parâmetros

MK	Nome da chave utilizada para a proteção do dados.
mask	Padrão de máscara que será aplicado ao secret ou token, de acordo com o definido na geração do token blob em GenSVaultToken(). Buffer com tamanho mínimo de TacNDJavaLib.D_SVAULT_MIN_TL e máximo de TacNDJavaLib.D_SVAULT_MIN_TL contendo a máscara. Pode ser string vazia "" para não utilizar mascaramento. A máscara é uma string UTF-8 que contém os caracteres que serão aplicados sobre os dados fazendo o mascaramento do mesmo. Passe '\0' nas posições onde queira que o dado seja apresentado. Veja as observações de GetSVaultTokenBlobData() para exemplos.
tokenBlob	Buffer de tamanho TacNDJavaLib.D_SVAULT_TOKEN_BLOB_LEN, gerado pela API GenSVaultToken(), contendo o token blob.

Retorna: token

Exceções

TacException