IOfficeSecurityProvider
OfficeIMO.Security
Strongly typed cryptographic provider used by OfficeIMO document packages when security features are explicitly enabled. The contract is dependency-free; implementations such as OfficeIMO.Security may use additional cryptographic packages.
Methods
public abstract byte[] CanonicalizeXml(byte[] xml, string algorithm, string? inclusiveNamespacesPrefixList = null, long maxOutputBytes = 16777216) #Canonicalizes a bounded XML document using an explicitly supported XML DSig algorithm.
Parameters
- xml byte[]
- algorithm string
- inclusiveNamespacesPrefixList string? = null
- maxOutputBytes long = 16777216
Returns
byte[]public abstract ICmsVerificationSession CreateCmsVerificationSession(CmsVerificationOptions options) #Creates a bounded CMS verification session whose aggregate timestamp limits are shared across every verification performed by that session.
Parameters
- options OfficeIMO.Security.CmsVerificationOptions
Returns
ICmsVerificationSessionpublic abstract byte[] CreateXmlSignature(XmlDigitalSignatureCreationRequest request) #Creates one bounded enveloping XML signature.
Parameters
- request OfficeIMO.Security.XmlDigitalSignatureCreationRequest
Returns
byte[]public abstract CmsDecryptionResult DecryptCms(byte[] encodedCms, X509Certificate2 recipientCertificate, CmsEnvelopeOptions? options = null) #Decrypts CMS EnvelopedData for a matching recipient certificate.
Parameters
- encodedCms byte[]
- recipientCertificate System.Security.Cryptography.X509Certificates.X509Certificate2
- options OfficeIMO.Security.CmsEnvelopeOptions? = null
Returns
CmsDecryptionResultpublic abstract byte[] EncryptCms(byte[] content, IEnumerable<X509Certificate2> recipients, CmsEnvelopeOptions? options = null) #Creates CMS EnvelopedData for the supplied recipients.
Parameters
- content byte[]
- recipients System.Collections.Generic.IEnumerable<System.Security.Cryptography.X509Certificates.X509Certificate2>
- options OfficeIMO.Security.CmsEnvelopeOptions? = null
Returns
byte[]public abstract byte[] NormalizeAsn1Object(byte[] encoded, bool allowTrailingZeroPadding, long maxEncodedBytes) #Normalizes one bounded DER/BER object, optionally trimming PDF-style trailing zero padding.
Parameters
- encoded byte[]
- allowTrailingZeroPadding bool
- maxEncodedBytes long
Returns
byte[]public abstract byte[] SignCmsDetached(byte[] content, X509Certificate2 signingCertificate, CmsSigningOptions? options = null, IEnumerable<X509Certificate2>? certificateChain = null) #Creates detached CMS SignedData over the exact supplied content.
Parameters
- content byte[]
- signingCertificate System.Security.Cryptography.X509Certificates.X509Certificate2
- options OfficeIMO.Security.CmsSigningOptions? = null
- certificateChain System.Collections.Generic.IEnumerable<System.Security.Cryptography.X509Certificates.X509Certificate2>? = null
Returns
byte[]public abstract byte[] SignCmsEncapsulated(byte[] content, X509Certificate2 signingCertificate, CmsSigningOptions? options = null, IEnumerable<X509Certificate2>? certificateChain = null) #Creates encapsulated CMS SignedData containing the supplied content.
Parameters
- content byte[]
- signingCertificate System.Security.Cryptography.X509Certificates.X509Certificate2
- options OfficeIMO.Security.CmsSigningOptions? = null
- certificateChain System.Collections.Generic.IEnumerable<System.Security.Cryptography.X509Certificates.X509Certificate2>? = null
Returns
byte[]public abstract CertificateTrustValidationResult ValidateCertificate(X509Certificate2 certificate, IEnumerable<X509Certificate2>? additionalCertificates = null, CertificateValidationOptions? options = null, CertificateValidationPurpose purpose = DocumentSigning) #Validates certificate trust, revocation, and intended usage under caller policy.
Parameters
- certificate System.Security.Cryptography.X509Certificates.X509Certificate2
- additionalCertificates System.Collections.Generic.IEnumerable<System.Security.Cryptography.X509Certificates.X509Certificate2>? = null
- options OfficeIMO.Security.CertificateValidationOptions? = null
- purpose OfficeIMO.Security.CertificateValidationPurpose = DocumentSigning
public abstract CmsVerificationResult VerifyCms(byte[] encodedCms, CmsVerificationOptions? options = null, CertificateValidationPurpose signerCertificatePurpose = DocumentSigning) #Verifies encapsulated CMS SignedData.
Parameters
- encodedCms byte[]
- options OfficeIMO.Security.CmsVerificationOptions? = null
- signerCertificatePurpose OfficeIMO.Security.CertificateValidationPurpose = DocumentSigning
Returns
CmsVerificationResultpublic abstract CmsVerificationResult VerifyCmsDetached(byte[] encodedCms, byte[] detachedContent, CmsVerificationOptions? options = null, CertificateValidationPurpose signerCertificatePurpose = DocumentSigning) #Verifies detached CMS SignedData against the exact supplied content.
Parameters
- encodedCms byte[]
- detachedContent byte[]
- options OfficeIMO.Security.CmsVerificationOptions? = null
- signerCertificatePurpose OfficeIMO.Security.CertificateValidationPurpose = DocumentSigning
Returns
CmsVerificationResultpublic abstract Rfc3161TimestampVerificationResult VerifyTimestamp(byte[] encodedToken, byte[] timestampedData, CertificateValidationOptions? certificateOptions = null, long maxEncodedBytes = 16777216, int maxCertificates = 64) #Verifies an RFC 3161 timestamp token against the exact timestamped bytes.
Parameters
- encodedToken byte[]
- timestampedData byte[]
- certificateOptions OfficeIMO.Security.CertificateValidationOptions? = null
- maxEncodedBytes long = 16777216
- maxCertificates int = 64
public abstract XmlDigitalSignatureVerificationResult VerifyXmlSignature(XmlDigitalSignatureVerificationRequest request) #Verifies XML signature math and bounded local-reference processing independently of trust.
Parameters
- request OfficeIMO.Security.XmlDigitalSignatureVerificationRequest
Properties
public abstract string Name { get; } #Gets a stable provider name for diagnostics.