Árvore de páginas
Ir para o final dos metadados
Ir para o início dos metadados

SHA512 gera o hash (message digest) de uma mensagem de entrada, com base no algoritmo SHA-512 da família SHA-2, definido em FIPS PUB 180-4 e publicado em 2001 pelo NIST.

Sintaxe

SHA512( < cContent >, [ nRetType ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cContent

caractere

Indica a string de entrada que contém os dados para os quais será gerado o hash.

X


nRetType

numérico

Indica o tipo do formato de retorno do hash. Quando informado 1 (um) retorna uma string no formato RAW_DIGEST (sequência de 64 bytes ASCII); quando informado 2 (dois) ou qualquer outro valor inteiro diferente de 1 (um) retorna uma string no formato HEX_DIGEST (sequência hexadecimal de 128 bytes). Caso não informado, o valor padrão é 2 (dois).



Retorno

Nome

Tipo

Descrição

cDigest

caractere

Retorna o hash (message digest) do conteúdo de entrada informado, no formato especificado.

Observações

  • A geração de um hash (message digest) normalmente é utilizada para verificar se o conteúdo sofreu alguma alteração, por exemplo, após ser enviado através de um e-mail, Web Service ou algum outro tipo de transporte ou armazenamento.
  • Caso algum erro ocorra durante a geração do hash uma mensagem de erro será gerada no log no servidor e o hash de saída será vazio.

Exemplos

User Function tstSHA512()

  Local sInput   := "0123456789abcdefghijklmnopqrstuvxz"
  Local sHashHex := ""
  Local sHashRaw := ""

  sHashHex := SHA512( sInput )
  Varinfo( "Input     ",  sInput   )
  Varinfo( "SHA512 Hex",  sHashHex )

  sHashRaw := SHA512( sInput, 1 )
  Varinfo( "SHA512 Raw",  sHashRaw )

  // a saída em hexadecimal pode ser confirmada no Linux usando o comando
  // $ echo -n "0123456789abcdefghijklmnopqrstuvxz" | sha512sum
  // 8e2382016afd78df5920d164718e103b7a79dec39f557ef2090805a89476324543d7a1a30a1f66660f760289f2f0288b955fc66941befae3d5768db19901bb36  -

Return

Abrangência

AppServer 13.1.3.16 e 13.2.3.16

  • Sem rótulos