ExternalSignature
Обзор
ExternalSignature — это класс в Aspose.PDF FOSS для .NET. Наследует от: Signature.
Отсоединённая конфигурация подписи PKCS#7, построенная вокруг уже загруженного сертификата платформы — обычно из хранилища сертификатов ОС, смарт-карты или HSM — вместо файла PFX.
Этот класс предоставляет 11 методов для работы с объектами ExternalSignature в программах .NET. Доступные методы включают: ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify. Все публичные члены доступны любому приложению .NET после установки пакета Aspose.PDF FOSS для .NET. Свойства: Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance и ещё 9.
Свойства
| Имя: | Тип: | Доступ | Описание: |
|---|---|---|---|
Certificate | System.Security.Cryptography.X509Certificates.X509Certificate2 | Чтение | Сертификат, с которым был построен этот экземпляр. |
Authority | string | Чтение/запись | Получает или задает значение свойства authority. |
ContactInfo | string | Чтение/запись | Получает или задает контактную информацию. |
Location | string | Чтение/запись | Получает или задает местоположение. |
Reason | string | Чтение/запись | Получает или задает причину. |
Date | DateTime | Чтение/запись | Получает или задает дату. |
ByteRange | int[] | Чтение | Запись /ByteRange подписи. |
TimestampSettings | Aspose.Pdf.TimestampSettings | Чтение/запись | Настройки TSA RFC 3161; учитываются подписантом, если заданы. |
OcspSettings | Aspose.Pdf.OcspSettings | Чтение/запись | Настройки проверки OCSP / отзыва; учитываются подписантом, если заданы. |
CustomAppearance | SignatureCustomAppearance? | Чтение/запись | Параметры визуального отображения, учитываемые SignWithAppearance, когда подпись подписывается через перегрузку visible-rect. |
CustomSignHash | SignHash? | Чтение/запись | Необязательный callback внешнего подписанта. |
UseLtv | bool | Чтение/запись | Получает или задает использование ltv. |
AvoidEstimatingSignatureLength | bool | Чтение/запись | Если true, подписант пропускает проход оценки диапазона байтов и использует DefaultSignatureLength напрямую при резервировании места для шестнадцатеричной строки PKCS#7 /Contents. |
DefaultSignatureLength | int | Чтение/запись | Количество байтов, зарезервированных для шестнадцатеричной строки PKCS#7 /Contents. |
ShowProperties | bool | Чтение/запись | Если true, визуальное отображение подписи включает в себя Reason/Location/ContactInfo подписанта как текст. |
Методы
| Подпись | Описание: |
|---|---|
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | Вызывает ExternalSignature(certificate) у этого экземпляра ExternalSignature. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool) | detached выбирает обработчик, точно так же, как пара PKCS7 / PKCS7Detached: true генерирует конверт adbe.pkcs7.detached поверх SHA-256 дайджеста, false — обработчик adbe.pkcs7.sha1 поверх SHA-1 дайджеста. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm) | Вызывает ExternalSignature(certificate, digestHashAlgorithm) у этого экземпляра ExternalSignature. |
ExternalSignature(base64Certificate: string, detached: bool) | Создаёт из публичного сертификата, закодированного в base64 (без закрытого ключа), для отложенной/внешней подписи через CustomSignHash. |
Signature() | Вызывает Signature на этом экземпляре ExternalSignature. |
Signature(pfx: string, password: string) | Вызывает Signature(pfx, password) на этом экземпляре ExternalSignature. |
Signature(pfx: Stream, password: string) | Вызывает Signature(pfx, password) на этом экземпляре ExternalSignature. |
Verify() | Проверьте PKCS#7 загруженной подписи относительно оригинальных байтов PDF — возвращает true, когда подпись декодируется и проходит проверку. |
Verify(options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Проверьте с явными параметрами + DTO результата. |
Verify(publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Проверка с привязкой к публичному ключу. |
GetSignatureAlgorithmInfo() | Разберите оболочку PKCS#7 (при загрузке из существующей подписи), чтобы сообщить тройку: алгоритм подписи / алгоритм дайджеста / криптографический стандарт. |
