Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Composition Setup
import.css=/download/attachments/6062824/tecnologia.css

Pagetitle
HSMPrivSign
HSMPrivSign

...

Bloco de código
HSMPrivSign( < cKey >, < cContent >, < nType >, < cPass >, [ @cErrStr ], [ lClient ] ) --> cRet

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cKey

caractere

Indica o caminho no dispositivo HSM para a chave privada.

X

 


cContent

caractere

Indica o valor que será assinado.

X

 


nType

numérico

Indica o tipo do algoritmo digest que será utilizado.

X

 


cPass

caractere

Indica a senha do slot onde está armazenado a chave privada apontada por cKey.

X

 


cErrStr

caractere

Indica a variável para retornar as mensagens de erro.

 


X

lClient

lógico

Indica se o dispositivo HSM está na máquina do SmartClient.

 

 



Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna o valor do parâmetro cContent, assinado de acordo com o tipo nType e a chave privada informada cKey.

Observações

  • Essa função utiliza a chave privada para realizar a assinatura. Para isso, é necessário informar no parâmetro cKey o caminho (path) no HSM da chave privada no parâmetro cKey, e, em seguida, , passar em cContent o conteúdo cContent que se deseja assinar e finalmente um , e passar em nType um numérico que informa o tipo de algoritmo que será utilizado para realizar a assinatura nType.
  • O caminho no dispositivo HSM indicado em cKey pode ser verificado através do retorno da função HSMObjList, checando se o índice 2 é .T., que indica que o objeto é uma chave privada.
  • O formato aceito no caminho do parâmetro cKey é "slot_<num>-id_<idhex>" ou "slot_<nem><num>-label_<label>", onde <num> é o número do slot, igual ao índice 1 do valor retornado pela função HSMSlotList, <idhex> é o id do objeto em hexadecimal, sendo cada 2 caracteres a representação hexadecimal de um caractere da tabela ASCII, e <label> é igual ao índice 1 do valor retornado pela função HSMObjList.
  • Tipo de algoritmo válido para o parâmetro nTiponType:

    Valor

    Algoritmo

    1

    MD5

    2

    RIPEMD160

    3

    SHA1

    4

    SHA224

    5

    SHA256

    6

    SHA384

    7

    SHA512

  • O parâmetro lClient está disponível a partir da build 7.00.131227A com data de geração superior a 11/03/2016.
  • O valor padrão de lClient é .F..

Exemplos

...


Bloco de código
languagecpp
themeEclipse
titleExemplo 1
linenumberstrue
collapsefalse
user function VerificaAssinaturaHSMverify()
 
  Local cMsg := ""
  Local cPrivSign := ""
  Local cKeycPath := ""
  Local cPwd := ""
  Local cError := ""
  Local lPrivVery := .F.
  
  // Slot do HSM contendo a chave privada que será utilizada para assinatura digital
  cKeycPath := "slot_3-label_NOME:12345678901 Private Key"
  
  // Senha para acesso da chave privada no HSM
  cPwd := "MINHA SENHA"
  
  // InicializacaoInicializa doo HSM
  xRet :=if HSMInitialize()

  if xRet <= 0
    conout( "HSM nao inicializado" )
    return
  endif
  
  // Assinatura digital utilizando o HSM
  cMsg := "Essa mensagem sera assinada digitalmente utilizando a chave privada contida no HSM"
  cPrivSign := HSMPrivSign(cKey cPath, cMsg, 1, cPwd, @cError )
  
  // exibe o conteúdo da variável de erro
  varinfo( "1 - cError", cError )
  
  //exibe o conteúdo da mensagem assinada
  varinfo( "cPrivSign", cPrivSign )

  // Verificacao da assinatura digital utilizando o certificado contido no HSM
  
  // Define o caminho do certificado que será utilizado para validar a mensagem assinada
  cKeycPath := "slot_3-label_NOME:12345678901 Certificate"
  
  cPrivVery// Verifica a mensagem a autenticidade entre a mensagem assinada e a mensagem original
  lPrivVery := HSMPrivVery(cKey cPath, cMsg, 1, @cError, cPrivSign )
  
  // exibe o conteúdo da variável de erro
  varinfo( "cError", cError )
  varinfo("cPrivVery", cPrivVery)

  if cPrivVerylPrivVery
    conout( "Assinatura verificada com sucesso!" )
  else
    conout( "Erro ao verificar assinatura!" )
  endif
 
return

Abrangência

...