iText 8.0.5 API
iText.Signatures.IssuingCertificateRetriever Class Reference

IIssuingCertificateRetriever default implementation. More...

Inheritance diagram for iText.Signatures.IssuingCertificateRetriever:
iText.Signatures.IIssuingCertificateRetriever

Public Member Functions

  IssuingCertificateRetriever ()
  Creates IssuingCertificateRetriever instance. More...
 
virtual IX509Certificate[]  RetrieveMissingCertificates (IX509Certificate[] chain)
  Retrieves missing certificates in chain using certificate Authority Information Access (AIA) Extension. More...
 
virtual IX509Certificate  RetrieveIssuerCertificate (IX509Certificate certificate)
  Retrieve issuer certificate for the provided certificate. More...
 
virtual IX509Certificate  RetrieveOCSPResponderCertificate (IBasicOcspResponse ocspResp)
  Retrieves OCSP responder certificate either from the response certs or trusted store in case responder certificate isn't found in /Certs. More...
 
virtual IX509Certificate[]  GetCrlIssuerCertificates (IX509Crl crl)
  Retrieves certificates that can be used to verify the signature on the CRL response using CRL Authority Information Access (AIA) Extension. More...
 
virtual void  SetTrustedCertificates (ICollection< IX509Certificate > certificates)
  Sets trusted certificate list to be used as certificates trusted for any possible usage. More...
 
virtual void  AddTrustedCertificates (ICollection< IX509Certificate > certificates)
  Add trusted certificates collection to trusted certificates storage. More...
 
virtual void  AddKnownCertificates (ICollection< IX509Certificate > certificates)
  Add certificates collection to known certificates storage, which is used for issuer certificates retrieval. More...
 
virtual TrustedCertificatesStore  GetTrustedCertificatesStore ()
  Gets iText.Signatures.Validation.V1.TrustedCertificatesStore to be used to provide more complex trusted certificates configuration. More...
 
virtual bool  IsCertificateTrusted (IX509Certificate certificate)
  Check if provided certificate is present in trusted certificates storage. More...
 

Package Functions

virtual Stream  GetIssuerCertByURI (String uri)
  Get CA issuers certificates represented as System.IO.Stream. More...
 
virtual ICollection< IX509Certificate ParseCertificates (Stream certsData)
  Parses certificates represented as byte array. More...
 

Detailed Description

IIssuingCertificateRetriever default implementation.

Constructor & Destructor Documentation

◆ IssuingCertificateRetriever()

iText.Signatures.IssuingCertificateRetriever.IssuingCertificateRetriever ( )
inline

Creates IssuingCertificateRetriever instance.

Member Function Documentation

◆ AddKnownCertificates()

virtual void iText.Signatures.IssuingCertificateRetriever.AddKnownCertificates ( ICollection< IX509Certificate certificates )
inlinevirtual

Add certificates collection to known certificates storage, which is used for issuer certificates retrieval.

Parameters
certificates certificates System.Collections.ICollection to be added

◆ AddTrustedCertificates()

virtual void iText.Signatures.IssuingCertificateRetriever.AddTrustedCertificates ( ICollection< IX509Certificate certificates )
inlinevirtual

Add trusted certificates collection to trusted certificates storage.

Parameters
certificates certificates System.Collections.ICollection to be added

◆ GetCrlIssuerCertificates()

virtual IX509Certificate [] iText.Signatures.IssuingCertificateRetriever.GetCrlIssuerCertificates ( IX509Crl  crl )
inlinevirtual

Retrieves certificates that can be used to verify the signature on the CRL response using CRL Authority Information Access (AIA) Extension.

Parameters
crl

Retrieves certificates that can be used to verify the signature on the CRL response using CRL Authority Information Access (AIA) Extension.

Returns

Retrieves certificates that can be used to verify the signature on the CRL response using CRL Authority Information Access (AIA) Extension.

Implements iText.Signatures.IIssuingCertificateRetriever.

◆ GetIssuerCertByURI()

virtual Stream iText.Signatures.IssuingCertificateRetriever.GetIssuerCertByURI ( String  uri )
inlinepackagevirtual

Get CA issuers certificates represented as System.IO.Stream.

Parameters
uri

System.Uri URI, which is expected to be used to get issuer certificates from. Usually CA Issuers value from Authority Information Access (AIA) certificate extension.

Returns
CA issuer certificate (or chain) bytes, represented as System.IO.Stream.

◆ GetTrustedCertificatesStore()

virtual TrustedCertificatesStore iText.Signatures.IssuingCertificateRetriever.GetTrustedCertificatesStore ( )
inlinevirtual

Gets iText.Signatures.Validation.V1.TrustedCertificatesStore to be used to provide more complex trusted certificates configuration.

Returns

iText.Signatures.Validation.V1.TrustedCertificatesStore storage

◆ IsCertificateTrusted()

virtual bool iText.Signatures.IssuingCertificateRetriever.IsCertificateTrusted ( IX509Certificate  certificate )
inlinevirtual

Check if provided certificate is present in trusted certificates storage.

Parameters
certificate

iText.Commons.Bouncycastle.Cert.IX509Certificate to be checked

Returns

true if certificate is present in trusted certificates storage, false otherwise

◆ ParseCertificates()

virtual ICollection<IX509Certificate> iText.Signatures.IssuingCertificateRetriever.ParseCertificates ( Stream  certsData )
inlinepackagevirtual

Parses certificates represented as byte array.

Parameters
certsData stream which contains one or more X509 certificates.
Returns
a (possibly empty) collection of the certificates read from the given byte array.

◆ RetrieveIssuerCertificate()

virtual IX509Certificate iText.Signatures.IssuingCertificateRetriever.RetrieveIssuerCertificate ( IX509Certificate  certificate )
inlinevirtual

Retrieve issuer certificate for the provided certificate.

Parameters
certificate

iText.Commons.Bouncycastle.Cert.IX509Certificate for which issuer certificate shall be retrieved

Returns
issuer certificate. null if there is no issuer certificate, or it cannot be retrieved.

◆ RetrieveMissingCertificates()

virtual IX509Certificate [] iText.Signatures.IssuingCertificateRetriever.RetrieveMissingCertificates ( IX509Certificate[]  chain )
inlinevirtual

Retrieves missing certificates in chain using certificate Authority Information Access (AIA) Extension.

Parameters
chain

Retrieves missing certificates in chain using certificate Authority Information Access (AIA) Extension.

Returns

Retrieves missing certificates in chain using certificate Authority Information Access (AIA) Extension.

Implements iText.Signatures.IIssuingCertificateRetriever.

◆ RetrieveOCSPResponderCertificate()

virtual IX509Certificate iText.Signatures.IssuingCertificateRetriever.RetrieveOCSPResponderCertificate ( IBasicOcspResponse  ocspResp )
inlinevirtual

Retrieves OCSP responder certificate either from the response certs or trusted store in case responder certificate isn't found in /Certs.

Parameters
ocspResp basic OCSP response to get responder certificate for
Returns
retrieved OCSP responder certificate or null in case it wasn't found.

◆ SetTrustedCertificates()

virtual void iText.Signatures.IssuingCertificateRetriever.SetTrustedCertificates ( ICollection< IX509Certificate certificates )
inlinevirtual

Sets trusted certificate list to be used as certificates trusted for any possible usage.

Sets trusted certificate list to be used as certificates trusted for any possible usage. In case more specific trusted is desired to be configured GetTrustedCertificatesStore() method is expected to be used.

Parameters
certificates certificate list to be used as certificates trusted for any possible usage.

Implements iText.Signatures.IIssuingCertificateRetriever.