CreateSelfSignedCertificate

Sicurezza e firme

Descrizione

Crea un certificato RSA autofirmato con firma SHA-256 e lo esporta, chiave privata inclusa, in un file PFX protetto da password. Il PFX generato funziona direttamente con SignFile, SetSignProcessPFXFromFile e gli altri punti di ingresso per la firma basati su PFX, consentendo di sviluppare e testare i flussi di firma senza ottenere un certificato da un'autorità esterna

Il certificato viene generato in un contenitore di chiavi temporaneo, eliminato nuovamente dopo l'esportazione; solo il file PFX conserva il materiale della chiave. I certificati autofirmati sono destinati ai test e ai documenti interni: i visualizzatori PDF li segnalano come non attendibili, a meno che l'utente non li installi esplicitamente

Sintassi

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);

Parametri

SubjectNameSoggetto del certificato come stringa X.500, ad esempio "CN=Alice Signer, O=Example Corp". Un nome senza "=" riceve automaticamente "CN=".
PFXFileNameIl percorso del file PFX (PKCS#12) da scrivere
PFXPasswordLa password che protegge il file PFX esportato
ValidDaysPeriodo di validità in giorni da oggi; i valori minori di 1 usano 365 come predefinito
KeyBitsLunghezza della chiave RSA in bit; i valori fuori da 1024..16384 usano 2048 come predefinito

Valori restituiti

0Impossibile creare il certificato (oggetto o nome file vuoto oppure errore Windows CryptoAPI)
1Success