Histórico da Página

...

Portuguese

Pagetitle

	PrivSignRSA
	PrivSignRSA

Assina um determinado conteúdo Hash Criptográfico usando chave privada.

Sintaxe

Bloco de código

language	cpp
collapse	false

PrivSignRSA( < cPathKey >, < cContentcHash >, < nTipo >, < cSenha >, [ @cErrStr ], [ nPad ] ) --> cRet

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cPathKey	caractere	Indica a string que contém o caminho para a chave privada (formato .PEM).	X
cContentcHash	caractere	Indica a string que será assinadacontém o Hash Criptográfico – em formato binário – que será assinado.	X
nTipo	numérico	Indica o tipo de algoritmo que será utilizado para realizar a assinatura da chaveHash Criptográfico informado informado no segundo parâmetro.	X
cSenha	caractere	Indica uma string que contém o valor da senha usada na geração da chave privada criptografadaInforma a senha da chave privada. Caso a chave privada não esteja protegida por senha, informe uma string vazia.	X
cErrStr	caractere	Indica a variável para retornar as mensagens de erro.informações adicionais em caso de falha ao realizar a assinatura.		X
nPad	numérico	Indica o tipo de schema de criptografia que será utilizado.

Retorno

Nome	Tipo	Descrição
cRet	caractere	Retorna o valor do parâmetro cContent cHash, assinado , de acordo com o tipo nTipo e a chave pela have privada informada cPathKey.

Observações

Essa função utiliza a chave privada para realizar a assinatura. Para isso, é necessário informar o caminho (path) da chave privada (formato .PEM), no parâmetro cPathKey e, em seguida, o conteúdo cContent Hash Criptoráfico cHash que se deseja assinar e finalmente um numérico que informa o o tipo de algoritmo que será utilizado para realizar a assinatura nTipo.Hash Criptográfico informado.
O Hash Criptográfico a ser assinado deve ser gerado sobre o conteúdo antes de chamar esta função.
O arquivo (no formato .PEM) O arquivo .PEM informado no parâmetro cPathKey deve ser ou conter uma chave privada, tais como:
Chave Privada
Certificado
CA (Certificate Authority)
Tipo de algoritmo válido para o parâmetro nTipo:
Valor
Algoritmo
1
MD5
2
SHA1
3
RIPEMD160
4
MD5_SHA1
5
SHA256WithRSA
6 SHA256
Tipo de schema válido para o parâmetro nPad:
Valor
Schema
1
PKCS1
2
SSL
3
NO
4
PKCS1_OAEP
5
X931
Caso não seja passado nenhum schema de criptografia (nPad), a rotina assume com padrão o schema 1 - PKCS1.
O valor Os valores 5 e 6 – no parâmetro nTipo – estão disponíveis em builds superiores a 121227P.
Caso seja informado no parâmetro cPathKey caminho de arquivos no client, será adicionado ao parâmetro cErrStr a mensagem "[PrivSignRSA] Only server path are allowed." e retornará Nil.
A etapa de geração do Hash Criptográfico é obrigatória para o uso desta função. A função AdvPL

Exemplos

Bloco de código

language	cpp
theme	Eclipse
title	Exemplo 1
linenumbers	true
collapse	false

User Function RSA_Sign()
  Local sStr := "01234567890123456789" 
  Local sOut cMD5 := ''
  Local sSign := ""
  // Conteudo a ser assinado
  varinfo( "sStr", sStr )
  // Hash MD5 gerado a partir desse conteudo 
  cMD5 := Md5( sStr )
  varinfo( "1cMD5", cMD5 sStr )
  // Assinatura gerada a partir do Hash MD5 usando a chave privada
  sOutsSign := PrivSignRSA( "private.pem", sStrcMD5, 1, "senhachaveprivada" )
  varinfo( "sOutsSign",  sOutsSign )
  // Verificando a assinatura usando a chave pública
  conout(If PrivVeryRSA( "public.pem", sStrcMD5, 1, sOut ) )
Return
 sSign )
    conout('Signature Check OK')
  Else
    conout('Signature Check FAILED')
  Endif
  Return

Veja também

EVPPrivSign

Abrangência

Advanced Protheus 7.10, Microsiga Protheus 8.11, Protheus 10, TOTVS Application Server 10, ByYou Application Server

Árvore de páginas

Versões comparadas

Versão antiga 5

Nova versão 6

Chave