CreateSelfSignedCertificate

Segurança e Assinaturas

Descrição

Cria um certificado RSA autoassinado com assinatura SHA-256 e o exporta - chave privada incluída - para um arquivo PFX protegido por senha. O PFX gerado funciona diretamente com SignFile, SetSignProcessPFXFromFile e os demais pontos de entrada de assinatura baseados em PFX, de modo que fluxos de assinatura podem ser desenvolvidos e testados sem obter um certificado de uma autoridade externa

O certificado é gerado em um contêiner de chaves temporário que é excluído após a exportação; apenas o arquivo PFX mantém o material da chave. Certificados autoassinados destinam-se a testes e documentos internos: os visualizadores de PDF os marcam como não confiáveis, a menos que o usuário os instale explicitamente

Sintaxe

Delphi

Function TPDFlib.CreateSelfSignedCertificate(Const SubjectName, PFXFileName, PFXPassword: WideString; ValidDays, KeyBits: Integer): Integer;

ActiveX

Function PDFlib::CreateSelfSignedCertificate(SubjectName As String, PFXFileName As String, PFXPassword As String, ValidDays As Long, KeyBits As Long) As Long

DLL

int DLCreateSelfSignedCertificate(int InstanceID, const wchar_t * SubjectName, const wchar_t * PFXFileName, const wchar_t * PFXPassword, int ValidDays, int KeyBits);

Parâmetros

SubjectName	O subject do certificado como string X.500, por exemplo "CN=Alice Signer, O=Example Corp". Um nome simples sem "=" recebe o prefixo "CN=" automaticamente.
PFXFileName	The path of the PFX (PKCS#12) file to write.
PFXPassword	A senha que protege o arquivo PFX exportado.
ValidDays	Período de validade em dias a partir de agora; valores abaixo de 1 usam o padrão 365.
KeyBits	RSA key length in bits; values outside 1024..16384 default to 2048.

Valores retornados

0	O certificado não pôde ser criado (subject ou nome de arquivo vazio, ou uma falha da Windows CryptoAPI)
1	Success