CreateSelfSignedCertificate
Seguridad y Firmas
Descripción
Crea un certificado RSA autofirmado con firma SHA-256 y lo exporta, incluida la clave privada, a un archivo PFX protegido por contraseña El PFX generado funciona directamente con SignFile, SetSignProcessPFXFromFile y los demás puntos de entrada de firma basados en PFX, por lo que los flujos de firma pueden desarrollarse y probarse sin obtener un certificado de una autoridad externa
El certificado se genera en un contenedor de claves temporal que se elimina de nuevo después de la exportación; solo el archivo PFX conserva el material de claves Los certificados autofirmados están destinados a pruebas y documentos internos: los visores de PDF los marcan como no confiables a menos que el usuario los instale explícitamente
Sintaxis
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 | El sujeto del certificado como una cadena X.500, por ejemplo "CN=Alice Signer, O=Example Corp" Un nombre simple sin "=" recibe automáticamente el prefijo "CN=" |
|---|---|
| PFXFileName | La ruta del archivo PFX (PKCS#12) que se escribirá |
| PFXPassword | La contraseña que protege el archivo PFX exportado |
| ValidDays | Período de validez en días a partir de hoy; los valores inferiores a 1 se establecen en 365 de forma predeterminada |
| KeyBits | Longitud de clave RSA en bits; los valores fuera de 1024..16384 se establecen en 2048 de forma predeterminada |
Valores devueltos
| 0 | No se pudo crear el certificado (asunto o nombre de archivo vacío, o falla de Windows CryptoAPI) |
|---|---|
| 1 | Success |