Documentation

Interface ICertificateProvider5

Extension interface for certificate provider implementation, adding methods to read and write the root certificate to a file To override default certificate handling, your class should implement this interface.

Inherited Members
Namespace: Fiddler
Assembly: FiddlerCore.dll

Syntax

public interface ICertificateProvider5 : ICertificateProvider4, ICertificateProvider3, ICertificateProvider2, ICertificateProvider

Methods

ClearCertificateCache(Boolean, out CertificateStoreOperationStatus)

When this method is called, your extension should discard all certificates and clear any certificates that have been added to the user's certificate store

Declaration
bool ClearCertificateCache(bool bClearRoot, out CertificateStoreOperationStatus status)
Parameters
System.Boolean bClearRoot

TRUE if the root certificate should also be cleared
CertificateStoreOperationStatus status

Provides details in case operation is not successful
Returns
System.Boolean

TRUE, if all certificates were removed; FALSE if any certificates were preserved

ReadRootCertificateAndPrivateKeyFromPkcs12File(String, String, String)

When this method is called, your extension should read the root certificate and its private key from the PKCS#12 file(.pfx | .p12).

Declaration
void ReadRootCertificateAndPrivateKeyFromPkcs12File(string filename, string password, string alias = null)
Parameters
System.String filename

The filename of the PKCS#12 file (.pfx | .p12).
System.String password

The password which is used to protect the private key. Could be null or empty if the private key is not protected.
System.String alias

The alias for the certificate and the private key. Could be null.

ReadRootCertificateAndPrivateKeyFromStream(Stream, String, String)

When this method is called, your extension should read the root certificate and its private key from a stream.

Declaration
void ReadRootCertificateAndPrivateKeyFromStream(Stream stream, string password, string alias = null)
Parameters
System.IO.Stream stream

The stream.
System.String password

The password which is used to protect the private key. Could be null or empty if the private key is not protected.
System.String alias

The alias for the certificate and the private key. Could be null.

WriteRootCertificateAndPrivateKeyToPkcs12File(String, String, String)

When this method is called, your extension should write the root certificate and its private key to a PKCS#12 file(.pfx | .p12).

Declaration
void WriteRootCertificateAndPrivateKeyToPkcs12File(string filename, string password, string alias = null)
Parameters
System.String filename

The filename of the PKCS#12 file (.pfx | .p12).
System.String password

The password which is used to protect the private key. If null or empty, the private key is written unprotected.
System.String alias

The alias for the certificate and the private key. If null, a random alias could be created.

WriteRootCertificateAndPrivateKeyToStream(Stream, String, String)

When this method is called, your extension should write the root certificate and its private key to a stream.

Declaration
void WriteRootCertificateAndPrivateKeyToStream(Stream stream, string password, string alias = null)
Parameters
System.IO.Stream stream

The stream.
System.String password

The password protecting the private key. If null or empty, the private key is written unprotected.
System.String alias

The alias for the certificate and the private key. If null, a random alias could be created.

WriteRootCertificateToDerEncodedFile(String)

When this method is called, your extension should write the root certificate without the private key to a DER encoded file(.cer | .crt | .der).

Declaration
void WriteRootCertificateToDerEncodedFile(string filename)
Parameters
System.String filename

The filename of the DER encoded file (.cer | .crt | .der)

WriteRootCertificateToStream(Stream)

When this method is called, your extension should write the root certificate without the private key to a stream.

Declaration
void WriteRootCertificateToStream(Stream stream)
Parameters
System.IO.Stream stream

The stream.