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
| SubjectName | Podmiot 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 |
| PFXPassword | Hasło chroniące eksportowany plik PFX |
| ValidDays | Okres ważności w dniach od chwili obecnej; wartości mniejsze niż 1 przyjmują domyślnie 365 |
| KeyBits | Długość klucza RSA w bitach; wartości spoza zakresu 1024..16384 przyjmują domyślnie 2048 |
Wartości zwracane
| 0 | Nie można było utworzyć certyfikatu (pusty podmiot lub nazwa pliku albo błąd Windows CryptoAPI) |
|---|---|
| 1 | Powodzenie |