Retorna o módulo público (public modulus) de uma chave privada no formato big-endian armazenada em um dispositivo HSM.
Sintaxe
HSMModulus( < cKey >, [ cPass ], [ lClient ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
|---|---|---|---|---|
cKey | caractere | Indica o caminho, no dispositivo HSM, para a chave privada. | X |
|
cPass | caractere | Indica a senha da chave, se existente. |
|
|
lClient | lógico | Indica se o dispositivo HSM está na máquina do SmartClient. |
|
|
Retorno
Nome | Tipo | Descrição |
|---|---|---|
cRet | caractere | Retorna o módulo público de uma chave no formato big-endian; retorna Nil caso ocorra um erro no processamento. |
Observações
- 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.
- 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
user function teste()
Local aSlots := {}
Local aObjs := {}
Local nSlots := 0
Local nObjs := 0
Local nI := 0
Local nJ := 0
Local cPath := ""
Local cPass := ""
cPass := "1234"
if HSMInitialize() <= 0
conout( "HSM not initialized" )
return
endif
aSlots := HSMSlotList()
nSlots := Len( aSlots )
for nI := 1 to nSlots
if aSlots[nI][4] == .T.
ASize( aObjs, 0 )
aObjs := HSMObjList( aSlots[nI][1], cPass )
nObjs := Len( aObjs )
for nJ := 1 to nObjs
if aObjs[nJ][2] == .T.
cPath := "slot_" + cValToChar( aSlots[nI][1] ) + "-label_" + aObjs[nJ][1]
conout( "Modulus from " + cPath + ": " + HSMModulus( cPath, cPass ) )
endif
next nJ
endif
next nI
return
Abrangência
Disponível em builds superiores a 7.00.131227A-20141208.
Veja também
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas