Esta classe tem como objetivo disponibilizar um mecanismo seguro de armazenamento de chaves secretas. Não é possível recuperar o conteúdo armazenado no cofre, porém é possível conferir se um valor informado está correto.

Somente o método ou função que originou o registro poderá alterar ou excluir um par de chave e valor, porém poderá ser conferida de qualquer fonte.

Importante!!!

Esta classe estará disponível na LIB de versão igual ou superior à 20210405.

Métodos:

Put

Sintaxe:

FwSecretVault():Put( cID, cValue )

Descrição:

Registra um par de chave e valor. Ao informar um valor que já exista na base, este será substituído pelo novo.

Parâmetro	Tipo	Descrição	Obrigatório
cID	Caracter	Identificador do registro que será armazenado	x
cValue	Caracter	Valor a ser armazenado. O limite de valor deste parâmetro é 175.	x

Retorno:

Se verdadeiro, indica que conseguiu guardar o registro

Importante!!!

O Id informado NÃO é exclusivo para o fonte/função utilizado. Se o mesmo Id for informado em um fonte/função diferente, poderá existir um conflito.

User Function teste1()

    Local cSenha:= 'minhasenha'
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
    Local lSucesso := .T.

    lSucesso := FwSecretVault():Put(cID, cSenha) // retorno .T.
 
return

User Function teste2()
    Local cID      	:= 'MeuID'
    Local cNovaSenha:= "novasenha"
    
    FwSecretVault():Put(cID) // retorno .F., pois já foi cadastrado
 
return

Check

Sintaxe:

FwSecretVault():Check( cID)

Descrição:

Método responsável por retornar o conteúdo armazenado. Somente o método ou função que originou o registro consegue recuperá-lo.

Parâmetro	Tipo	Descrição	Obrigatório
cID	Caracter	Identificador do registro que foi armazenado	x

Retorno:

Conteúdo armazenado. Retorna uma string vazia ("") caso não encontre o ID.

Delete

Sintaxe:

FwSecretVault():Delete( cID)

Descrição:

Método responsável por deletar um dado que foi armazenado. Somente o método ou função que originou o registro consegue deletá-lo.

Parâmetro	Tipo	Descrição	Obrigatório
cID	Caracter	Identificador do registro que será deletado	x

Retorno:

Se verdadeiro, indica que conseguiu remover o registro.

User Function TstSafeVault()

    Local cData   	 := 'Texto com acentuação'
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
    
    FwSecretVault():Put(cID, cData)
    cDataRet:= FwSecretVault():Check(cID)
    ConOut( 'Valor do retorno do Check = ' + cDataRet)
    FwSecretVault():Delete(cID)
    cDataRet:= FwSecretVault():Check(cID)
    ConOut( 'Valor do retorno do Check apos executar o Delete = ' + cDataRet)
 
return