Histórico da Página
...
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
cHSMPath | caracterecharacter | Indica o caminho no dispositivo HSM para o certificado de cliente. | X | |
cFile | caracterecharacter | Indica o caminho de destino da chave pública, incluindo o nome do arquivo. | X | |
cPass | caracterecharacter | Indica a senha do slot onde está armazenado o certificado apontado por cHSMPath. | ||
lChangeCase | lógicological | Se verdadeiro (.T.), nomes de arquivos e pastas serão convertidos para letras minúsculas; caso contrário, falso (.F.), não será feito nenhum ajuste no nome do arquivo informado. Valor padrão (.T.). | ||
lClient | lógicological | Indica se o dispositivo HSM está na máquina do SmartClient. |
Retorno
Nome | Tipo | Descrição |
---|---|---|
lRet | lógicological | Retorna .T. caso consiga extrair a chave pública do HSM; caso contrário, retorna .F.. |
...
- O formato aceito no caminho do parâmetro cHSMPath é "slot_<num>-id_<idhex>" ou "slot_<num><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 (igual ao índice 4 do valor retornado pela função HSMObjList), 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.
- Caso o HSM esteja no AppServer, o caminho apontado por cFile deve ser no AppServer; caso esteja no SmartClient, o caminho deve ser no SmartClientinstalado na mesma máquina onde o AppServer está em execução, o parâmetro cFile deve apontar para um path no mesmo servidor. Caso esteja instalado na mesma máquina onde o SmartClient foi executado, este parâmetro deve receber um path da mesma estação.
- O valor padrão do parâmtero parâmetro lChangeCase é .T..
- O parâmetro opcional lChangeCase foi introduzido pois em sistemas LINUX/UNIX existe a diferenciação entre maiúsculo e minúsculo em nomes de arquivos ou pastascriado para ampliar o suporte a Sistemas Operacionais que são Case Sensitive, assim como Linux e Mac. Quando este parâmetro for informado, terá prioridade sobre comportamento de Case Sensitive definido pelas chaves de ini configuração CASESENSITIVE ou SERVERTYPE. Porém, quando não especificado o parâmetro, o valor padrão (.T.) , seu comportamento fica condicionado ao que está configurado nessas chaves.
- Em ambiente Windows, os nomes de arquivos e pastas não possuem diferenciação entre maiúsculo e minúsculo, logo, a função conseguirá tratar os arquivos e pastas independente do valor definido no parâmetro lChangeCase.
- Quando o SmartClient utilizado for uma build nativa Linux ou Mac, sabe-se que sistema de arquivos destas plataformas não têm unidade de disco, a nomenclatura dos arquivos é case sensitive (letras minúsculas diferente de maiúsculas), e as barras separadoras de diretório / pasta são barras normais "/" ao invés de barras inversas "\". Mesmo nestes casos, deve-se especificar uma letra de unidade de disco no diretório de destino; pois quando o SmartClient em Linux e/ou Mac receber o diretório de destino, com a unidade de disco especificada, a unidade de disco será ignorada e as barras serão internamente invertidas. Por exemplo, a cópia especificando o path de destino "C:\USER\LOCAL\TEMP\" será interpretado pelo SmartClient Linux e/ou Mac como "/user/local/temp/".
- O valor padrão do parâmtero lClient é .F..
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
user function teste() Local aSlots := {} Local aObjs := {} Local nI := 0 Local nJ := 0 Local nSlots := 0 Local nObjs := 0 Local cPath := "" Local cDest := "" Local cPass := "" // define o password utilizado para acessar o HSM cPass := "1234" // inicializa o HSM if HSMInitialize() <= 0 conout( "HSM not initialized" ) return endif // pega a lista de slots do HSM aSlots := HSMSlotList() nSlots := Len( aSlots ) // para cada um dos slots for nI := 1 to nSlots // verifica se o slot está inicializado if aSlots[nI][4] == .T. ASize( aObjs, 0 ) // pega a lista de objetos do slot aObjs := HSMObjList( aSlots[nI][1], cPass ) nObjs := Len( aObjs ) // para cada objeto do slot for nJ := 1 to nObjs // verifica se é o objeto não é chave privada // o certificado e a chave pública ficam juntos if aObjs[nJ][2] == .F. // monta o caminho do objeto no HSM cPath := "slot_" + cValToChar( aSlots[nI][1] ) + "-label_" + aObjs[nJ][1] // monta o caminho de destino cDest := "\cert-slot_" + cValToChar( aSlots[nI][1] ) + "-obj_" + cValToChar( nJ ) + ".pem" // pega a chave pública no HSM if HSMGetKeyFile( cPath, cDest, cPass ) == .F. conout( "Could not get public key for certificate on " + cPath ) endif endif next nJ endif next nI if HSMFinalize() <> 1 conout( "HSM not finalized" ) endif return |
...