ExternalSignature
ภาพรวม
ExternalSignature เป็นคลาสใน Aspose.PDF FOSS สำหรับ .NET. สืบทอดจาก: Signature.
การกำหนดค่าลายเซ็น PKCS#7 แบบแยกที่สร้างขึ้นรอบใบรับรองแพลตฟอร์มที่โหลดไว้แล้ว — โดยทั่วไปมาจากที่เก็บใบรับรองของ OS, สมาร์ทการ์ด หรือ 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 | อ่าน/เขียน | การตั้งค่า RFC 3161 TSA; ได้รับการเคารพโดยผู้ลงนามเมื่อกำหนด. |
OcspSettings | Aspose.Pdf.OcspSettings | อ่าน/เขียน | การตั้งค่า OCSP / revocation-check; ได้รับการเคารพโดยผู้ลงนามเมื่อกำหนด. |
CustomAppearance | SignatureCustomAppearance? | อ่าน/เขียน | ตัวควบคุมการปรากฏภาพที่เคารพโดย SignWithAppearance เมื่อลายเซ็นถูกลงนามผ่านการ overload ของ visible-rect. |
CustomSignHash | SignHash? | อ่าน/เขียน | คอลแบ็กผู้ลงนามภายนอกแบบไม่บังคับ. |
UseLtv | bool | อ่าน/เขียน | รับหรือกำหนดการใช้ ltv. |
AvoidEstimatingSignatureLength | bool | อ่าน/เขียน | เมื่อเป็นจริง ผู้ลงนามจะข้ามขั้นตอนการประมาณช่วงไบต์และใช้ DefaultSignatureLength โดยตรงเมื่อจองพื้นที่สำหรับสตริงฐานสิบหก /Contents ของ PKCS#7. |
DefaultSignatureLength | int | อ่าน/เขียน | จำนวนไบต์ที่จองไว้สำหรับสตริงฐานสิบหก /Contents ของ PKCS#7. |
ShowProperties | bool | อ่าน/เขียน | เมื่อเป็นจริง การแสดงลายเซ็นที่มองเห็นได้จะรวม 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 จะสร้าง envelope adbe.pkcs7.detached บน digest SHA-256, false จะใช้ handler adbe.pkcs7.sha1 บน digest 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 (เมื่อโหลดจากลายเซ็นที่มีอยู่) เพื่อรายงาน signing-algorithm / digest-algorithm / cryptographic-standard triple. |
