Generate digest

Generate digest ( param ; algoritmo {; *} ) : Text

Parâmetro	Tipo		Descrição
param	Blob, Text	→	Blob o texto para o qual obter uma chave digest
algoritmo	Integer	→	Algoritimo utilizado para retornar a chave: 0 = MD5 Digest, 1 = SHA1 Digest
*	Operador	→	Encode digest in Base64URL
resultado	Text	←	Valor da chave digest

Descrição

O comando Generate digest retorna a chave digest (ou chave de resumo) de um BLOB ou texto depois da aplicação de um algoritmo de criptografia.

Passe um Text ou então um campo ou variável BLOB no parâmetro param. A função Generate digest retorna a chave digest como uma string.

No parâmetro algoritimo, passe um valor designando qual função hash vai usar. Use uma das constantes abaixo, encontradas no tema Tipo Digest :

Constante	Tipo	Valor	Comentário
_o_4D REST digest	Inteiro longo	2	*** Constante obsoleta ***
MD5 digest	Inteiro longo	0	Utilizar o algoritmo MD5
SHA1 digest	Inteiro longo	1	Utilizar o algoritmo SHA-1
SHA256 digest	Inteiro longo	3	(Familia SHA-2) SHA-256 é uma série de 256 bits devolvidos como uma string de 64 caracteres hexadecimais.
SHA512 digest	Inteiro longo	4	(Família SHA-2) SHA-512 é uma série de 512 bits devolvidos como uma string de 128 caracteres hexadecimais.

Nota: Não é recomendado usar algoritmos MD5 e SHA para manejar senhas. Se precisar checar senhas, é recomendado usar os comandos Generate password hash e Verify password hash .

Por padrão, se o parâmetro * for omitido, o digest retornado é codificado em hexadecimal. Passe o parâmetro * se quiser que seja codificado em Base64URL.

O valor retornado para o mesmo objeto é o mesmo em todas as plataformas (MacOS/Windows). O cálculo é realizado baseado na representação em UTF-8 do texto passado no parâmetro.

Nota: se usar o comando com um texto/BLOB vazio, não retorna void, e sim um valor de string (por exemplo "d41d8cd98f00b204e9800998ecf8427e" para MD5).

Exemplo 1

Este exemplo compara duas imagens utilizando o algoritmo MD5:

 var $vPict1;$vPict2 : Picture
 var $FirstBlob;$SecondBlob : Blob
 READ PICTURE FILE("c:\\myPhotos\\photo1.png")
 If(OK=1)
    READ PICTURE FILE("c:\\myPhotos\\photo2.png")
    If(OK=1)
       PICTURE TO BLOB($vPict1;$FirstBlob;".png")
       PICTURE TO BLOB($vPict2;$SecondBlob;".png")
 
       $MD5_1:=Generate digest($FirstBlob;MD5 digest)
       $MD5_2:=Generate digest($SecondBlob;MD5 digest)
 
       If($MD5_1#$MD5_2)
          ALERT("Essas duas imagens são diferentes.")
       Else
          ALERT("Essas duas imagens são iguais.")
       End if
    End if
 End if

Exemplo 2

Esses exemplos ilustram como recuperar a chave digest de um texto:

 $key1:=Generate digest("The quick brown fox jumps over the lazy dog.";MD5 digest)
  // $key1 is "e4d909c290d0fb1ca068ffaddf22cbd0"
 $key2:=Generate digest("The quick brown fox jumps over the lazy dog.";SHA1 digest)
  // $key2 is "408d94384216f890ff7a0c3528e8bed1e0b01621"

Ver também

BASE64 DECODE
BASE64 ENCODE
Generate password hash
Protocolo de segurança
WEB Validate digest

Propriedades

Número do comando	1147
Thread-seguro	✓