ExternalSignature
Tổng quan
ExternalSignature là một lớp trong Aspose.PDF FOSS cho .NET. Kế thừa từ: Signature.
Cấu hình chữ ký PKCS#7 rời rạc được xây dựng quanh một chứng chỉ nền tảng đã được tải sẵn — thường từ kho chứng chỉ của hệ điều hành, thẻ thông minh hoặc HSM — thay vì tệp PFX.
Lớp này cung cấp 11 phương thức để làm việc với các đối tượng ExternalSignature trong các chương trình .NET. Các phương thức khả dụng bao gồm: ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify. Tất cả các thành viên công khai đều có thể truy cập bởi bất kỳ ứng dụng .NET nào sau khi cài đặt gói Aspose.PDF FOSS cho .NET. Thuộc tính: Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance, và 9 mục khác.
Thuộc tính
| Tên | Kiểu | Truy cập | Mô tả |
|---|---|---|---|
Certificate | System.Security.Cryptography.X509Certificates.X509Certificate2 | Đọc | Chứng chỉ mà đối tượng này được tạo ra bằng. |
Authority | string | Đọc/Ghi | Lấy hoặc đặt cơ quan. |
ContactInfo | string | Đọc/Ghi | Lấy hoặc đặt thông tin liên hệ. |
Location | string | Đọc/Ghi | Lấy hoặc đặt vị trí. |
Reason | string | Đọc/Ghi | Lấy hoặc đặt lý do. |
Date | DateTime | Đọc/Ghi | Lấy hoặc đặt ngày. |
ByteRange | int[] | Đọc | Mục /ByteRange của chữ ký. |
TimestampSettings | Aspose.Pdf.TimestampSettings | Đọc/Ghi | Cài đặt TSA RFC 3161; được người ký tôn trọng khi được thiết lập. |
OcspSettings | Aspose.Pdf.OcspSettings | Đọc/Ghi | Cài đặt OCSP / kiểm tra thu hồi; được người ký tôn trọng khi được thiết lập. |
CustomAppearance | SignatureCustomAppearance? | Đọc/Ghi | Các công tắc về hiển thị hình ảnh được SignWithAppearance tôn trọng khi chữ ký được ký thông qua một visible-rect overload. |
CustomSignHash | SignHash? | Đọc/Ghi | Callback người ký bên ngoài tùy chọn. |
UseLtv | bool | Đọc/Ghi | Lấy hoặc đặt việc sử dụng ltv. |
AvoidEstimatingSignatureLength | bool | Đọc/Ghi | Nếu đúng, người ký sẽ bỏ qua bước ước tính phạm vi byte và sử dụng DefaultSignatureLength trực tiếp khi dự trữ không gian cho chuỗi hex /Contents của PKCS#7. |
DefaultSignatureLength | int | Đọc/Ghi | Số byte được dự trữ cho chuỗi hex /Contents của PKCS#7. |
ShowProperties | bool | Đọc/Ghi | Nếu đúng, phần hiển thị chữ ký có thể nhìn thấy sẽ bao gồm Lý do/Vị trí/ContactInfo của người ký dưới dạng văn bản. |
Phương thức
| Chữ ký | Mô tả |
|---|---|
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | Gọi ExternalSignature(certificate) trên thể hiện ExternalSignature này. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool) | detached chọn trình xử lý, chính xác như cặp PKCS7 / PKCS7Detached: true phát ra một phong bì adbe.pkcs7.detached dựa trên hàm băm SHA-256, false sử dụng trình xử lý adbe.pkcs7.sha1 dựa trên hàm băm SHA-1. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm) | Gọi ExternalSignature(certificate, digestHashAlgorithm) trên thể hiện ExternalSignature này. |
ExternalSignature(base64Certificate: string, detached: bool) | Tạo từ một chứng chỉ công cộng được mã hoá base64 (không có khóa riêng) để ký hoãn/ngoại vi thông qua CustomSignHash. |
Signature() | Gọi Signature trên thể hiện ExternalSignature này. |
Signature(pfx: string, password: string) | Gọi Signature(pfx, password) trên đối tượng ExternalSignature này. |
Signature(pfx: Stream, password: string) | Gọi Signature(pfx, password) trên đối tượng ExternalSignature này. |
Verify() | Xác minh PKCS#7 của chữ ký đã tải so với các byte PDF gốc — trả về true khi chữ ký được giải mã và hợp lệ. |
Verify(options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Xác minh với các tùy chọn rõ ràng + một DTO kết quả. |
Verify(publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Xác thực gắn khóa công khai. |
GetSignatureAlgorithmInfo() | Phân tích phong bì PKCS#7 (khi được tải từ chữ ký hiện có) để báo cáo bộ ba signing-algorithm / digest-algorithm / cryptographic-standard triple. |