CreateSelfSignedCertificate

Zabezpieczenia i podpisy

Opis

Tworzy samopodpisany certyfikat RSA z podpisem SHA-256 i eksportuje go wraz z kluczem prywatnym do chronionego hasłem pliku PFX. Wygenerowany plik PFX działa bezpośrednio z SignFile, SetSignProcessPFXFromFile i innymi punktami wejścia podpisywania opartymi na PFX, dlatego przepływy podpisywania można tworzyć i testować bez uzyskiwania certyfikatu od zewnętrznego urzędu.

Certyfikat jest generowany w tymczasowym kontenerze kluczy, który zostaje usunięty po eksporcie; materiał klucza zachowuje tylko plik PFX. Certyfikaty samopodpisane są przeznaczone do testów i dokumentów wewnętrznych: przeglądarki PDF oznaczają je jako niezaufane, chyba że użytkownik jawnie je zainstaluje.

Składnia

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

Parametry

SubjectNamePodmiot certyfikatu jako ciąg X.500, na przykład "CN=Alice Signer, O=Example Corp". Sama nazwa bez "=" automatycznie otrzymuje prefiks "CN="
PFXFileNameŚcieżka pliku PFX (PKCS#12), który ma zostać zapisany
PFXPasswordHasło chroniące eksportowany plik PFX
ValidDaysOkres ważności w dniach od chwili obecnej; wartości mniejsze niż 1 przyjmują domyślnie 365
KeyBitsDługość klucza RSA w bitach; wartości spoza zakresu 1024..16384 przyjmują domyślnie 2048

Wartości zwracane

0Nie można było utworzyć certyfikatu (pusty podmiot lub nazwa pliku albo błąd Windows CryptoAPI)
1Powodzenie