FPCWebProxy object

Applies to: desktop apps only

The FPCWebProxy object defines the configuration settings for the Forefront TMG Web proxy in a Forefront TMG array.

The FPCWebProxy object is accessed through the WebProxy property of the FPCArrayPolicy object.

Ff827041.bkbutton(en-us,VS.85).png Click here to see the Forefront TMG object hierarchy.

Inheritance

This object inherits from the FPCPersist object, which contains methods and properties related to the persistent storage of an object's data. They include methods for exporting the object's data to and importing it from an XML document.

Members

The FPCWebProxy object has these types of members:

  • Methods
  • Properties

Methods

The FPCWebProxy object has these methods.

Method Description
TestConnectivity

Performs a connectivity test to the specified web server.

 

Properties

The FPCWebProxy object has these properties.

Property Access type Description

ApplyPutAndDeleteInForward

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will delete the corresponding object currently stored in the cache when PUT and DELETE requests are received in the forward proxy scenario.

ApplyPutAndDeleteInReverse

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will delete the corresponding object currently stored in the cache when PUT and DELETE requests are received in the reverse proxy scenario.

BlockInvalidUtf8Urls

Read/write

Gets or sets a Boolean value that indicates whether requests with an invalid UTF8-encoded URL will be blocked.

CARPExceptions

Read-only

Gets an FPCRefs collection that contains references to the FPCDomainNameSet collections defining the domain name sets which make up the list of Web sites to which requests are sent without using the Cache Array Routing Protocol (CARP).

CARPNameSystem

Read/write

Gets or sets a value from the FpcNameSystem enumerated type that specifies the method to be used by Web browsers for resolving the names of array members to which they are to connect according to the CARP algorithm.

ConnectCacheSize

Read/write

Gets or sets a value that is a factor for determining the maximum size of the connection cache.

CookieCryptoConfiguration

Read-only

Gets an FPCCookieCryptoConfiguration object that holds the configuration settings used for cookie hashing and encryption in forms-based authentication.

EnforceLogUrlLengthInWebProxy

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will reject requests with URLs that are longer than the maximum length that can be logged.

ExplicitLinkTranslationMappings

Read-only

Gets an FPCExplicitLinkTranslationMappings collection that contains objects representing all the explicit link translation mappings defined in the array.

HTTPCompressionConfiguration

Read-only

Gets an FPCHTTPCompressionConfiguration object that holds the configuration settings for Hypertext Transfer Protocol (HTTP) compression.

LinkTranslationEnabled

Read/write

Gets or sets a Boolean value that indicates whether link translation can be enabled in Web publishing rules.

LinkTranslationRedirection

Read-only

Gets an FPCLinkTranslationRedirection object that holds the configuration settings for redirecting links to unpublished sites in link translation.

MaxResponseHeadersSize

Read/write

Gets or sets the maximum allowed size, in bytes, of an HTTP response header.

OutboundHTTPSInspectionConfiguration

Read-only

Gets an FPCOutboundHTTPSInspectionConfiguration object that holds the configuration settings for outbound HTTPS inspection.

PerfCounterSettings

Read-only

Gets an FPCPerfCounterSettings object that holds the configuration settings of the Web proxy performance counters.

RemoveAllProxyAuthorization

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server.

RemoveRedundantProxyAuthorization

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove all redundant Proxy-Authorization headers from requests passed to an upstream server when Basic authentication is used for authentication to the upstream server.

RemoveTrailersFromChunkedEncodedRequests

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove trailers from requests that are encoded with the chunked transfer coding (this property is relevant only for responses sent to HTTP 1.1 clients).

RemoveTrailersFromChunkedEncodedResponses

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will remove trailers from responses that are encoded with the chunked transfer coding (this property is relevant only for responses sent to HTTP 1.1 clients).

SkipAuthenticationForRoutingInformation

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip the authentication process for requests for routing information.

SkipNameResolutionForAccessAndRoutingRules

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip name resolution while checking access and routing rules.

SkipNameResolutionForWebPublishingRules

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will skip name resolution while checking Web publishing rules.

TunnelPortRanges

Read-only

Gets an FPCTunnelPortRanges collection.

UpstreamResolveSystem

Read/write

Gets or sets a value from the FpcNameSystem enumerated type that specifies the method that the Forefront TMG Web proxy will use for resolving the names of upstream array members to which it is to connect according to the CARP algorithm.

UrlFilteringSettings

Read-only

Gets an FPCUrlFilteringSettings object that holds the URL filtering settings for the array.

UseDigestSSP

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will prefer Advanced Digest authentication over Digest authentication.

ValidateClientCertificateCRL

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate client certificates against the relevant certificate revocation list (CRL).

ValidateCrlOnline

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will try to connect to the certification authority (CA) and download the latest certificate revocation list (CRL).

ValidateServerCertificateCRLInForward

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate server certificates against the relevant certificate revocation list (CRL) in the forward proxy scenario.

ValidateServerCertificateCRLInReverse

Read/write

Gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate server certificates against the relevant certificate revocation list (CRL) in the reverse proxy scenario.

WebProxyFtpClientPassword

Read/write

Gets or sets the password that will be used when mediating anonymous FTP requests.

 

Methods Inherited from FPCPersist

Name Description
CancelWaitForChanges Cancels the registration established by the WaitForChanges method (for use in C and C++ programming only).
CanImport Returns a Boolean value that indicates whether the object's properties can be imported from the specified XML document.
Export Recursively writes the stored values of all the properties of the object and its subobjects to the specified XML document.
ExportToFile Recursively writes the stored values of all the properties of the object and its subobjects to the specified XML file.
GetServiceRestartMask Retrieves a 32-bit bitmask of the FpcServices enumerated type that specifies which services need to be restarted for currently unsaved changes to take effect.
Import Recursively copies the values of all the properties of the object and of its subobjects from the specified XML document to persistent storage.
ImportFromFile Recursively copies the values of all the properties of the object and of its subobjects from the specified XML file to persistent storage.
LoadDocProperties Provides the XML document's properties so that you can know what information can be imported from the document.
Refresh Recursively reads the values of all the properties of the object and of its subobjects from persistent storage, overwriting any changes that have not been saved.
Save Recursively writes the current values of all the properties of the object and its subobjects to persistent storage.
WaitForChanges Registers to wait for an event indicating that the contents of the object have changed (for use in C and C++ programming only).

 

Properties Inherited from FPCPersist

Name Description
PersistentName Gets the persistent name of the object. The persistent name of an object is a name that is unique for the object at the respective level of the COM object hierarchy.
VendorParameterSets Gets an FPCVendorParametersSets collection that can hold sets of custom data for extending the object.

 

Interfaces for C++ Programming

This object implements the IFPCWebProxy, IFPCEEWebProxy, IFPCWebProxy2, and IFPCWebProxy3 interfaces.

Requirements

Minimum supported client

Windows Vista, None supported

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

Forefront Threat Management Gateway (TMG) 2010

IDL

Msfpccom.idl

See also

COM Objects

 

 

Build date: 7/12/2010