CreateSelfSignedCertificateA

Sicurezza e firme

Descrizione

Il suffisso A indica il punto di ingresso ANSI (char) della DLL; la superficie ActiveX/COM espone solo la forma Unicode. Il comportamento è identico a CreateSelfSignedCertificate e gli argomenti stringa vengono interpretati utilizzando la tabella codici SetAnsiMode corrente

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 DLCreateSelfSignedCertificateA(InstanceID: Integer; SubjectName, PFXFileName, PFXPassword: PAnsiChar; ValidDays, KeyBits: Integer): Integer;

DLL

int DLCreateSelfSignedCertificateA(int InstanceID, const char * SubjectName, const char * PFXFileName, const char * 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