ExternalSignature

Vue d’ensemble

ExternalSignature est une classe dans le FOSS Aspose.PDF pour .NET. Hérite de : Signature.

Une configuration de signature PKCS#7 détachée construite autour d’un certificat de plateforme déjà chargé — généralement provenant du magasin de certificats du système d’exploitation, d’une carte à puce ou d’un HSM — plutôt que d’un fichier PFX.

Cette classe fournit 11 méthodes pour travailler avec des objets ExternalSignature dans les programmes .NET. Les méthodes disponibles incluent : ExternalSignature, GetSignatureAlgorithmInfo, Signature, Verify. Tous les membres publics sont accessibles à toute application .NET après l’installation du paquet Aspose.PDF FOSS pour .NET. Propriétés : Authority, AvoidEstimatingSignatureLength, ByteRange, Certificate, ContactInfo, CustomAppearance, et 9 autres.

Propriétés

Nom	Type	Accès	Description
`Certificate`	`System.Security.Cryptography.X509Certificates.X509Certificate2`	Lecture	Le certificat avec lequel cette instance a été construite.
`Authority`	`string`	Lecture/Écriture	Obtient ou définit l’autorité.
`ContactInfo`	`string`	Lecture/Écriture	Obtient ou définit les informations de contact.
`Location`	`string`	Lecture/Écriture	Obtient ou définit l’emplacement.
`Reason`	`string`	Lecture/Écriture	Obtient ou définit la raison.
`Date`	`DateTime`	Lecture/Écriture	Obtient ou définit la date.
`ByteRange`	`int[]`	Lecture	L’entrée /ByteRange de la signature.
`TimestampSettings`	`Aspose.Pdf.TimestampSettings`	Lecture/Écriture	Paramètres TSA RFC 3161 ; respectés par le signataire lorsqu’ils sont définis.
`OcspSettings`	`Aspose.Pdf.OcspSettings`	Lecture/Écriture	Paramètres de vérification OCSP / révocation ; respectés par le signataire lorsqu’ils sont définis.
`CustomAppearance`	`SignatureCustomAppearance?`	Lecture/Écriture	Paramètres d’apparence visuelle respectés par SignWithAppearance lorsque la signature est signée via une surcharge visible-rect.
`CustomSignHash`	`SignHash?`	Lecture/Écriture	Rappel optionnel du signataire externe.
`UseLtv`	`bool`	Lecture/Écriture	Obtient ou définit l’utilisation de ltv.
`AvoidEstimatingSignatureLength`	`bool`	Lecture/Écriture	Lorsque vrai, le signataire ignore la passe d’estimation de la plage d’octets et utilise DefaultSignatureLength directement lors de la réservation d’espace pour la chaîne hexadécimale PKCS#7 /Contents.
`DefaultSignatureLength`	`int`	Lecture/Écriture	Nombre d’octets réservés pour la chaîne hexadécimale PKCS#7 /Contents.
`ShowProperties`	`bool`	Lecture/Écriture	Lorsque vrai, l’apparence visible de la signature inclut le Reason/Location/ContactInfo du signataire sous forme de texte.

Méthodes

Signature	Description
`ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2)`	Appelle ExternalSignature(certificate) sur cette instance ExternalSignature.
`ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, detached: bool)`	detached sélectionne le gestionnaire, exactement comme le couple PKCS7 / PKCS7Detached le fait : true émet une enveloppe adbe.pkcs7.detached sur un SHA-256 digest, false le gestionnaire adbe.pkcs7.sha1 sur un SHA-1 digest.
`ExternalSignature(certificate: System.Security.Cryptography.X509Certificates.X509Certificate2, digestHashAlgorithm: DigestHashAlgorithm)`	Appelle ExternalSignature(certificate, digestHashAlgorithm) sur cette instance ExternalSignature.
`ExternalSignature(base64Certificate: string, detached: bool)`	Construit à partir d’un certificat public codé en base64 (sans clé privée) pour une signature différée/externe via CustomSignHash.
`Signature()`	Appelle Signature sur cette instance ExternalSignature.
`Signature(pfx: string, password: string)`	Appelle Signature(pfx, password) sur cette instance ExternalSignature.
`Signature(pfx: Stream, password: string)`	Appelle Signature(pfx, password) sur cette instance ExternalSignature.
`Verify()`	Vérifiez le PKCS#7 de la signature chargée contre les octets PDF originaux — renvoie true lorsque la signature se décode et se valide.
`Verify(options: Security.ValidationOptions, validationResult: Security.ValidationResult)`	Vérifiez avec des options explicites + un DTO de résultat.
`Verify(publicKeyCertificate: System.Security.Cryptography.X509Certificates.X509Certificate2, options: Security.ValidationOptions, validationResult: Security.ValidationResult)`	Vérification avec clé publique épinglée.
`GetSignatureAlgorithmInfo()`	Analyser l’enveloppe PKCS#7 (lorsqu’elle est chargée à partir d’une signature existante) pour rapporter le triple algorithme de signature / algorithme de hachage / norme cryptographique.