CreateSelfSignedCertificate

Sécurité et signatures

Description

Crée un certificat RSA autosigné avec une signature SHA-256 et l’exporte, clé privée comprise, dans un fichier PFX protégé par mot de passe. Le PFX fonctionne directement avec SignFile, SetSignProcessPFXFromFile et les autres points d’entrée PFX, permettant de développer et tester les flux sans certificat externe

Le certificat est généré dans un conteneur de clés temporaire supprimé après l’exportation ; seul le fichier PFX conserve le matériel de clé. Les certificats autosignés sont destinés aux tests et documents internes : les visualiseurs les signalent comme non fiables sauf installation explicite par l’utilisateur

Syntaxe

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

Paramètres

SubjectName	Sujet du certificat comme chaîne X.500, par exemple "CN=Alice Signer, O=Example Corp". Un nom nu sans "=" reçoit automatiquement le préfixe "CN="
PFXFileName	Chemin du fichier PFX (PKCS#12) à écrire
PFXPassword	Mot de passe protégeant le fichier PFX exporté
ValidDays	Période de validité en jours à partir de maintenant ; les valeurs inférieures à 1 prennent 365 par défaut
KeyBits	Longueur de clé RSA en bits ; les valeurs hors de 1024..16384 prennent 2048 par défaut

Valeurs de retour

0	Le certificat n'a pas pu être créé (sujet ou nom de fichier vide, ou échec de Windows CryptoAPI)
1	Success