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
| SubjectName | Soggetto del certificato come stringa X.500, ad esempio "CN=Alice Signer, O=Example Corp". Un nome senza "=" riceve automaticamente "CN=". |
|---|---|
| PFXFileName | Il percorso del file PFX (PKCS#12) da scrivere |
| PFXPassword | La password che protegge il file PFX esportato |
| ValidDays | Periodo di validità in giorni da oggi; i valori minori di 1 usano 365 come predefinito |
| KeyBits | Lunghezza della chiave RSA in bit; i valori fuori da 1024..16384 usano 2048 come predefinito |
Valori restituiti
| 0 | Impossibile creare il certificato (oggetto o nome file vuoto oppure errore Windows CryptoAPI) |
|---|---|
| 1 | Success |