HSMPrivSign

Assina usando algoritmo digest um determinado conteúdo usando uma chave privada armazenada em dispositivo HSM.

Sintaxe

HSMPrivSign( < cKey >, < cContent >, < nType >, < cPass >, [ @cErrStr ], [ lClient ] ) --> cRet

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.

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.

Essa função utiliza a chave privada para realizar a assinatura. Para isso, é necessário informar o caminho (path) da chave privada no parâmetro cKey, e, em seguida, o conteúdo cContent que se deseja assinar e finalmente um numérico que informa o tipo de algoritmo que será utilizado para realizar a assinatura nType.
O formato aceito no caminho do parâmetro cKey é "slot_<num>-id_<idhex>" ou "slot_<nem>-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 nTipo:
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..

A partir da build 7.00.081215P.