ExternalSignature
Panoramica
ExternalSignature è una classe in Aspose.PDF FOSS per .NET. Eredita da: Signature.
Una configurazione di firma PKCS#7 staccata costruita attorno a un certificato della piattaforma già caricato — tipicamente dal deposito di certificati del sistema operativo, una smartcard o un HSM — anziché da un file PFX.
Questa classe fornisce 11 metodi per lavorare con oggetti ExternalSignature nei programmi .NET. I metodi disponibili includono: ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify. Tutti i membri pubblici sono accessibili a qualsiasi applicazione .NET dopo aver installato il pacchetto Aspose.PDF FOSS per .NET. Proprietà: Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance, e altre 9.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
Certificate | System.Security.Cryptography.X509Certificates.X509Certificate2 | Lettura | Il certificato con cui è stata costruita questa istanza. |
Authority | string | Lettura/Scrittura | Ottiene o imposta l’autorità. |
ContactInfo | string | Lettura/Scrittura | Ottiene o imposta le informazioni di contatto. |
Location | string | Lettura/Scrittura | Ottiene o imposta la posizione. |
Reason | string | Lettura/Scrittura | Ottiene o imposta il motivo. |
Date | DateTime | Lettura/Scrittura | Ottiene o imposta la data. |
ByteRange | int[] | Lettura | L’entry /ByteRange della firma. |
TimestampSettings | Aspose.Pdf.TimestampSettings | Lettura/Scrittura | Impostazioni TSA RFC 3161; rispettate dal firmatario quando impostate. |
OcspSettings | Aspose.Pdf.OcspSettings | Lettura/Scrittura | Impostazioni di verifica OCSP / revoca; rispettate dal firmatario quando impostate. |
CustomAppearance | SignatureCustomAppearance? | Lettura/Scrittura | Manopole di aspetto visivo onorate da SignWithAppearance quando la firma è firmata tramite un overload visible-rect. |
CustomSignHash | SignHash? | Lettura/Scrittura | Callback opzionale per firmatario esterno. |
UseLtv | bool | Lettura/Scrittura | Ottiene o imposta l’uso ltv. |
AvoidEstimatingSignatureLength | bool | Lettura/Scrittura | Quando è true, il firmatario salta la fase di stima dell’intervallo di byte e utilizza DefaultSignatureLength direttamente durante la riserva di spazio per la stringa esadecimale /Contents del PKCS#7. |
DefaultSignatureLength | int | Lettura/Scrittura | Numero di byte riservati per la stringa esadecimale /Contents del PKCS#7. |
ShowProperties | bool | Lettura/Scrittura | Quando è true, l’aspetto della firma visibile include il Reason/Location/ContactInfo del firmatario come testo. |
Metodi
| Firma | Descrizione |
|---|---|
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2) | Chiama ExternalSignature(certificate) su questa istanza ExternalSignature. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool) | detached seleziona il gestore, esattamente come fa la coppia PKCS7 / PKCS7Detached: true genera un involucro adbe.pkcs7.detached su un digest SHA-256, false il gestore adbe.pkcs7.sha1 su un digest SHA-1. |
ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm) | Chiama ExternalSignature(certificate, digestHashAlgorithm) su questa istanza ExternalSignature. |
ExternalSignature(base64Certificate: string, detached: bool) | Costruisci a partire da un certificato pubblico codificato in base64 (senza chiave privata) per firma differita/esterna tramite CustomSignHash. |
Signature() | Chiama Signature su questa istanza di ExternalSignature. |
Signature(pfx: string, password: string) | Chiama Signature(pfx, password) su questa istanza di ExternalSignature. |
Signature(pfx: Stream, password: string) | Chiama Signature(pfx, password) su questa istanza di ExternalSignature. |
Verify() | Verifica il PKCS#7 della firma caricata rispetto ai byte PDF originali — restituisce true quando la firma viene decodificata e valida. |
Verify(options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Verifica con opzioni esplicite + un DTO di risultato. |
Verify(publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult) | Verifica con chiave pubblica pinata. |
GetSignatureAlgorithmInfo() | Analizza l’involucro PKCS#7 (quando caricato da una firma esistente) per riportare la tripla algoritmo di firma / algoritmo di digest / standard crittografico. |