Class
CONFIG

The CONFIG object is Fiddler's legacy settings object, introduced before the advent of the Preferences system.

Definition

Namespace:Fiddler

Assembly:FiddlerCore.dll

Syntax:

cs-api-definition
public static class CONFIG

Inheritance: objectCONFIG

Inherited Members object.GetType()object.MemberwiseClone()object.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()

Fields

FiddlerVersionInfo

Version information for the Fiddler/FiddlerCore assembly

Declaration

cs-api-definition
public static Version FiddlerVersionInfo

Field Value

Version

RetryOnReceiveFailure

Controls whether a Session may be resent on a different connection because reading of the response did not succeed. Default is to always retry.

Declaration

cs-api-definition
public static RetryMode RetryOnReceiveFailure

Field Value

RetryMode

bAutoProxyLogon

Controls whether Fiddler will attempt to log on to the upstream proxy server to download the proxy configuration script

Declaration

cs-api-definition
public static bool bAutoProxyLogon

Field Value

bool

bCaptureCONNECT

Controls whether Fiddler should register as the HTTPS proxy

Declaration

cs-api-definition
public static bool bCaptureCONNECT

Field Value

bool

bDebugCertificateGeneration

Controls whether Certificate-Generation output will be spewed to the Fiddler Log

Declaration

cs-api-definition
public static bool bDebugCertificateGeneration

Field Value

bool

bDebugSpew

Set to true to force Fiddler Core to emit extra debugging information while capturing sessions

Declaration

cs-api-definition
public static bool bDebugSpew

Field Value

bool

bMapSocketToProcess

Boolean controls whether Fiddler should map inbound connections to their original process using IPHLPAPI

Declaration

cs-api-definition
public static bool bMapSocketToProcess

Field Value

bool

bUseAESForSAZ

Use 128bit AES Encryption when password-protecting .SAZ files. Note that, while this encryption is much stronger than the default encryption algorithm, it is significantly slower to save and load these files, and the Windows Explorer ZIP utility cannot open them.

Declaration

cs-api-definition
public static bool bUseAESForSAZ

Field Value

bool

bUseEventLogForExceptions

Controls whether Fiddler will try to write exceptions to the System Event log. Note: Usually fails due to ACLs on the Event Log.

Declaration

cs-api-definition
public static bool bUseEventLogForExceptions

Field Value

bool

bUseSNIForCN

Boolean controls whether Fiddler will attempt to use the Server Name Indicator TLS extension to generate the SubjectCN for certificates

Declaration

cs-api-definition
public static bool bUseSNIForCN

Field Value

bool

oAcceptedClientHTTPSProtocols

SSL/TLS Protocols we allow the client to choose from (when we call AuthenticateAsServer) We allow all TLS protocols by default (Tls1, Tls1.1, Tls1.2, Tls1.3). We 'Bitwise OR' in the constants for TLS1.1, TLS1.2 and TLS1.3 because we still build for .NET4.0.

Declaration

cs-api-definition
public static SslProtocols oAcceptedClientHTTPSProtocols

Field Value

SslProtocols

oAcceptedServerHTTPSProtocols

SSL/TLS Protocols we request the server use (when we call AuthenticateAsClient). By default, TLS1, TLS1.1, TLS1.2 and TLS1.3 are accepted.

Declaration

cs-api-definition
public static SslProtocols oAcceptedServerHTTPSProtocols

Field Value

SslProtocols

oBodyEncoding

The encoding with which HTTP Body should be parsed. Defaults to UTF8

Declaration

cs-api-definition
public static Encoding oBodyEncoding

Field Value

Encoding

oHeaderEncoding

The encoding with which HTTP Headers should be parsed. Defaults to UTF8, but may be overridden by specifying a REG_SZ containing the encoding name in the registry key \Fiddler2\HeaderEncoding

Declaration

cs-api-definition
public static Encoding oHeaderEncoding

Field Value

Encoding

sAlternateHostname

Alternative hostname which Fiddler should recognize as an alias for the local machine. The default value of ? will never be usable, as it's the QueryString delimiter

Declaration

cs-api-definition
public static string sAlternateHostname

Field Value

string

sGatewayPassword

The password to send to the upstream gateway if the Version Checking webservice request requires authentication

Declaration

cs-api-definition
public static string sGatewayPassword

Field Value

string

sGatewayUsername

The username to send to the upstream gateway if the Version Checking webservice request requires authentication

Declaration

cs-api-definition
public static string sGatewayUsername

Field Value

string

Properties

CaptureFTP

Controls whether Fiddler should register as the FTP proxy

Declaration

cs-api-definition
public static bool CaptureFTP { get; set; }

Property Value

bool

CustomClientTlsProvider

Gets or sets an optional custom client TLS provider for Fiddler. The provider will be used to authenticate Fiddler as a server on a new client connection and return a stream to read/write data from/to it.

Declaration

cs-api-definition
public static IClientTlsConnectionProvider CustomClientTlsProvider { get; set; }

Property Value

IClientTlsConnectionProvider

DecryptHTTPS

Controls whether Fiddler should attempt to decrypt HTTPS Traffic

Declaration

cs-api-definition
public static bool DecryptHTTPS { get; set; }

Property Value

bool

DecryptWhichProcesses

Control which processes have HTTPS traffic decryption enabled

Declaration

cs-api-definition
public static ProcessFilterCategories DecryptWhichProcesses { get; set; }

Property Value

ProcessFilterCategories

EnableHTTP2

Controls whether Fiddler will allow HTTP/2 client connections

Declaration

cs-api-definition
public static bool EnableHTTP2 { get; set; }

Property Value

bool

EnableIPv6

Controls whether Fiddler will attempt to connect to IPv6 addresses

Declaration

cs-api-definition
public static bool EnableIPv6 { get; set; }

Property Value

bool

ForceExclusivePort

Boolean indicating whether Fiddler will open the listening port exclusively

Declaration

cs-api-definition
public static bool ForceExclusivePort { get; }

Property Value

bool

GRPCSettings

Gets or sets a value containing gRPC metadata

Declaration

cs-api-definition
public static IList<GRPCConfig> GRPCSettings { get; set; }

Property Value

IList<GRPCConfig>

IgnoreServerCertErrors

Controls whether server certificate errors are ignored when decrypting HTTPS traffic.

Declaration

cs-api-definition
public static bool IgnoreServerCertErrors { get; set; }

Property Value

bool

JSEditor

Returns the path and filename of the editor used to edit the Rules script file.

Declaration

cs-api-definition
[CodeDescription("Return path to user's FiddlerScript editor.")]
public static string JSEditor { get; set; }

Property Value

string

ListenPort

The port upon which Fiddler is configured to listen.

Declaration

cs-api-definition
public static int ListenPort { get; }

Property Value

int

ReuseClientSockets

Controls whether Fiddler will reuse client connections for multiple sessions

Declaration

cs-api-definition
public static bool ReuseClientSockets { get; set; }

Property Value

bool

ReuseServerSockets

Controls whether Fiddler will reuse server connections for multiple sessions

Declaration

cs-api-definition
public static bool ReuseServerSockets { get; set; }

Property Value

bool

StreamAudioVideo

Should Audio/Video types automatically stream by default?

Declaration

cs-api-definition
public static bool StreamAudioVideo { get; set; }

Property Value

bool

UpstreamGateway

Gets a value indicating what mechanism, if any, will be used to find the upstream proxy/gateway.

Declaration

cs-api-definition
[Obsolete("Use Telerik.NetworkConnections.NetworkConnectionsManager.GetCurrentProxySettingsForConnection(*) to get information for the current proxy settings.")]
public static GatewayType UpstreamGateway { get; }

Property Value

GatewayType

bAllowRemoteConnections

Returns true if Fiddler should permit remote connections. Requires restart.

Declaration

cs-api-definition
[CodeDescription("Returns true if Fiddler is configured to accept remote clients.")]
public static bool bAllowRemoteConnections { get; }

Property Value

bool

iReverseProxyForPort

Port to which Fiddler should forward inbound requests when configured to run as a Reverse Proxy

Declaration

cs-api-definition
public static int iReverseProxyForPort { get; set; }

Property Value

int

sHookConnectionNamed

Name of connection to which Fiddler should autoattach if MonitorAllConnections is not set

Declaration

cs-api-definition
[Obsolete("Use Telerik.NetworkConnections.NetworkConnectionsManager.GetCurrentProxySettingsForConnection(*)/SetProxySettingsForConnections(*) to get/set proxy settings for a network connection.")]
public static string sHookConnectionNamed { get; set; }

Property Value

string

sHookConnectionNamespace

The connection namespace to use when looking for network connection information. For example: "WinINet", "OSX", or "Linux".

Declaration

cs-api-definition
[Obsolete("Use Telerik.NetworkConnections.NetworkConnectionsManager.GetAllConnectionFullNames() to get information for the current connections.")]
public static string sHookConnectionNamespace { get; set; }

Property Value

string

sHostsThatBypassFiddler

On attach, will configure WinINET to bypass Fiddler for these hosts.

Declaration

cs-api-definition
[Obsolete("Use Telerik.NetworkConnections.NetworkConnectionsManager.GetCurrentProxySettingsForConnection(*)/SetProxySettingsForConnections(*) to get/set ProxySettings.BypassHosts value for a network connection.")]
public static string sHostsThatBypassFiddler { get; set; }

Property Value

string

Methods

GetPath(string)

Return an app path (ending in Path.DirectorySeparatorChar) or a filename

Declaration

cs-api-definition
[CodeDescription("Return a filesystem path.")]
public static string GetPath(string sWhatPath)

Parameters

sWhatPath

string

CASE-SENSITIVE

Returns

string

The specified filesystem path

GetRegPath(string)

Get a registry path for a named constant

Declaration

cs-api-definition
public static string GetRegPath(string sWhatPath)

Parameters

sWhatPath

string

The path to retrieve [Root, UI, Dynamic, Prefs]

Returns

string

The registry path

GetUrl(string)

Return a Special URL.

Declaration

cs-api-definition
[CodeDescription("Return a special Url.")]
public static string GetUrl(string sWhatUrl)

Parameters

sWhatUrl

string

String constant describing the URL to return. CASE-SENSITIVE!

Returns

string

Returns target URL

SetNoDecryptList(string)

List of hostnames for which HTTPS decryption (if enabled) should be skipped

Declaration

cs-api-definition
public static void SetNoDecryptList(string sNewList)

Parameters

sNewList

string

A list of hostnames(comma or semicolon or space or newline separated)

SetNoDecryptListInvert(bool)

Whether to invert the behavior of hosts set in SetNoDecryptList(string). If behavior is inverted, only hosts in the NoDecryptList will be subject to HTTPS decryption.

Declaration

cs-api-definition
public static void SetNoDecryptListInvert(bool bInvert)

Parameters

bInvert

bool

True to invert the no decryption hosts list. Default behavior is if set to false.

SetSkipCertificateValidationHostsList(string)

Set a list of hostnames for which Certificate validation should be skipped.

Declaration

cs-api-definition
public static void SetSkipCertificateValidationHostsList(string sNewList)

Parameters

sNewList

string

A list of hostnames(comma or semicolon or space or newline separated)