PFXCert2PEM

Extrai o certificado de cliente de um arquivo com extensão .PFX (formato padrão do IIS - Internet Information Services), e gera como saída um arquivo no formato .PEM (Privacy Enhanced Mail).

Sintaxe

PFXCert2PEM( < cPFXFile >, < cPEMFile >, < @cError >, [ cPassword ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório	Referência
cPFXFile	caractere	Indica o caminho do arquivo .PFX, a partir da raiz do diretório (RootPath) do TOTVS Application Server.	X
cPEMFile	caractere	Indica o caminho do arquivo .PEM, a partir da raiz do diretório (RootPath) do TOTVS Application Server, com as informações de certificado de cliente.	X
cError	caractere	Indica a saída da mensagem de erro, em caso de falha.	X	X
cPassword	caractere	Indica a senha para extrair os dados do arquivo PFX.

Retorno

Nome	Tipo	Descrição
lRet	lógico	Retorna .T. quando o PEM é gerado com sucesso; caso contrário, .F..

Observações

O formato PEM é frequentemente usado para codificação de chaves e certificados em ASCII.
Caso seja informado nos parâmetros <cPFXFile> ou <cPEMFile> caminho de arquivos no client, a aplicação será terminada com uma ocorrência de erro fatal AdvPL "Only server path are allowed (PFXCert2PEM)".
Esta função tem o comportamento igual a ferramenta PKCS12, da OpenSSL, com a opção de extrair o certificado de cliente (-clcerts). Para mais informações sobre a ferramenta PKCS12, consulte a documentação disponível no site da OpenSSL - http://www.openssl.org/docs/apps/pkcs12.html.

Exemplos

Exemplo 1

user function getCert()
  Local cPFX := "\certs\tests.pfx"
  Local cCert := "\certs\cert.pem"
  Local cError := ""
  Local lRet
  lRet := PFXCert2PEM( cPFX, cCert, @cError, "123" )
  If( lRet == .F. )
    conout( "Error: " + cError )
  Else
    cContent := MemoRead( cCert )
    varinfo( "Cert", cContent )
  Endif
return

Abrangência

Protheus 10, TOTVS Application Server 10

Árvore de páginas