Classe tPBKDF2

PBKDF2 (Password-Based Key Derivation Function 2) é um algoritmo de derivação de chave amplamente utilizado que é projetado para aumentar a segurança de senhas e chaves mestras.

Ele é amplamente adotado em cenários de segurança (RFC2898 https://datatracker.ietf.org/doc/html/rfc2898#section-5.2), incluindo o armazenamento seguro de senhas e a geração de chaves criptográficas.

Observações

Exemplo

User Function testpbkdf2()

  Local oTokenPBKDF2 := Nil

  //Criando classe do PBKDF2
  oTokenPBKDF2:= tPBKDF2():New()
  
  //Informação da release utilizada da openssl
  conout("release")
  oTokenPBKDF2:release()
  
  //Parâmetro obrigatório senha para iniciar a criptografia. 
  oTokenPBKDF2:setPassword("password")
  
  //Parâmetro obrigatório salt, podendo ser string ou base64
  oTokenPBKDF2:setSalt("salt")
  
  //Número de iteration, quantidade de rodadas de criptografia! RFC 2898 sugere no mínimo 1000. Quanto maior mais difícil será desfazer via força bruta.
  oTokenPBKDF2:setIteration(10000)
  
  //Tamanho do buffer da chave de saída em bytes.
  //8  bytes ou 64  bits
  //16 bytes ou 128 bits
  //32 bytes ou 256 bits
  //64 bytes ou 512 bits
  oTokenPBKDF2:setKeylength(16)
  
  //Função de digest usado na criptografia. Ex: SHA1, SHA256, SHA512
  oTokenPBKDF2:setDigest("SHA256")
  
  //Função obrigatório usada para chamar a criptografia
  oTokenPBKDF2:encrypt() 
  
  //Funções de retorno
  //Neste caso saída com 32 caracteres (hexdecimal) 2 caracteres por byte. 
  conout("getKeyHex      : " + cValToChar( oTokenPBKDF2:getKeyHex() ))
  conout("getKeyRaw      : " + cValToChar( oTokenPBKDF2:getKeyRaw() ))  
  conout("getKeyBase64   : " + cValToChar( oTokenPBKDF2:getKeyBase64() ))  
  conout("getKeyBase64Url: " + cValToChar( oTokenPBKDF2:getKeyUrl_Base64() ))  
  
  //Importante sempre destruir a classe para evitar aumento de memoria no Appserver.
  FreeObj(oTokenPBKDF2)

   
Return

Abrangência

20.3.2.3

Construtores

New

Cria um objeto tPBKDF2 para configuração, criação, assinatura e manipulação de assinaturas.

Sintaxe

tPBKDF2():New() 

Retorno

Exemplos

    Local oTokenPBKDF2 := tPBKDF2():New()
 

Métodos

A classe expõe os seguintes métodos:

setPassword()

Sintaxe

setPassword( < cAlgo > )

Parâmetros

Exemplos

     oTokenPBKDF2:setPassword("password") 

setSalt()

Sintaxe

setSalt( < cAlgo > )

Parâmetros

Exemplos

    oTokenPBKDF2:setSalt("salt") 

setIteration()

Sintaxe

setIteration( < citeration > )

Parâmetros

Exemplos

    oTokenPBKDF2:setIteration(10000) 

setKeylength()

Sintaxe

setKeylength( < ckeylength > )

Parâmetros

Exemplos

    oTokenPBKDF2:setKeylength(16)

setDigest()

Sintaxe

setDigest( < cdigest > )

Parâmetros

Exemplos

    oTokenPBKDF2:setDigest("SHA256")

encrypt()

Sintaxe

encrypt()

Parâmetros

Obrigatório a chamada desta função para criptografar os dados e também identificar erros.

Exemplos

    oTokenPBKDF2:encrypt() 

Funções de retorno.

getKeyHex() //Neste caso saída com 32 caracteres (hexadecimal) 2 caracteres por byte em maiúsculo. 

getKeyRaw() //Formato padrão de saída Hexadecimal em minúsculo. 

getKeyBase64() //Formato BASE64, RFC1521 

getKeyUrl_Base64() //Formato BASE64 Url Safe.

release

Obtém a versão da lib da openssl utilizada.

Sintaxe  oTokenPBKDF2:release()

release()

Exemplos

    conout("Versão da openssl: " + oTokenPBKDF2:release())

getLastError

Obtém o registro de erro da última operação executada sem sucesso.

Sintaxe  oTokenPBKDF2:getLastError()

getLastError()

Exemplos

    conout("Erro na geração da criptografia. Error: " + oTokenPBKDF2:getLastError())

Testes de iteration e tempo médio de execução.

Tempo médio:

9.999.999 iterations 11 segundos. 

99.999.999 iterations 1 minuto e 45 segundos. 

999.999.999 iterations 17 minuto e 29 segundos.