CreateSelfSignedCertificate
Безопасность и подписи
Описание
Создаёт самоподписанный RSA-сертификат с подписью SHA-256 и экспортирует его — вместе с приватным ключом — в защищённый паролем PFX-файл. Такой PFX напрямую работает с SignFile, SetSignProcessPFXFromFile и другими PFX-точками входа, поэтому сценарии подписания можно разрабатывать и тестировать без покупки сертификата во внешнем удостоверяющем центре
Сертификат генерируется во временном контейнере ключей, который после экспорта удаляется; материал ключа сохраняет только PFX-файл. Самоподписанные сертификаты предназначены для тестов и внутренних документов: просмотрщики помечают их как недоверенные, пока пользователь не установит их явно
Синтаксис
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);
Параметры
| SubjectName | Субъект сертификата строкой X.500, например "CN=Alice Signer, O=Example Corp"; голое имя без "=" автоматически получает префикс "CN=" |
|---|---|
| PFXFileName | Путь записываемого PFX (PKCS#12) файла |
| PFXPassword | Пароль, защищающий экспортируемый PFX-файл |
| ValidDays | Срок действия в днях от текущего момента; значения меньше 1 по умолчанию дают 365 |
| KeyBits | RSA key length in bits; values outside 1024..16384 default to 2048. |
Возвращаемые значения
| 0 | Сертификат создать не удалось (пустой субъект или имя файла, либо сбой Windows CryptoAPI) |
|---|---|
| 1 | Success |