RemoveAllProxyAuthorization Property of the IFPCWebProxy Interface

Article
08/13/2010

The RemoveAllProxyAuthorization property 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.

C++

HRESULT put_RemoveAllProxyAuthorization(
    VARIANT_BOOL fRemoveAllProxyAuthorization
);
HRESULT get_RemoveAllProxyAuthorization(
    VARIANT_BOOL* pfRemoveAllProxyAuthorization
);

Parameters

fRemoveAllProxyAuthorization
Boolean value that specifies whether the Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server.
pfRemoveAllProxyAuthorization
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if the Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server, or to VARIANT_FALSE if the Web proxy does not remove all Proxy-Authorization headers from requests passed to an upstream server.

Return Value

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Visual Basic

Property RemoveAllProxyAuthorization As Boolean

Property Value

Boolean value that indicates whether the Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server.

Example Code

This VBScript script sets the value of the RemoveAllProxyAuthorization property so that the Web proxy will remove all Proxy-Authorization headers from requests passed to an upstream server.

' Create the root object.
Dim root  ' The FPCLib.FPC root object
Set root = CreateObject("FPC.Root")
' Declare the other objects needed.
Dim isaArray     ' An FPCArray object
Dim webProxy     ' An FPCWebProxy object
' Get references to the array object
' and the Web proxy object. 
Set isaArray = root.GetContainingArray()
Set webProxy = isaArray.ArrayPolicy.WebProxy
' Configure the Web proxy to remove all Proxy-Authorization headers 
' from requests passed to an upstream server. 
webProxy.RemoveAllProxyAuthorization = True
' Save the new configuration with the fResetRequiredServices parameter set 
' to True so that the Firewall service will be restarted and the change
' will take effect. 
webProxy.Save True

Remarks

This property is read/write. Its default value is False (VARIANT_FALSE in C++).

If requests sent by Internet Explorer are forwarded to an upstream proxy server by a Web chaining rule, Integrated authentication is required on the downstream Forefront TMG computer, and no client authentication is required on the upstream proxy server, random authentication requests and other error messages may be displayed on the client computer. This problem can be resolved by configuring the downstream proxy server to remove all Proxy-Authorization headers from requests passed to the upstream server.

After the value of this property has been modified, the change must be written to persistent storage by calling the Save method, and the Microsoft Firewall service must be restarted for the change to take effect. For more information about restarting the Firewall service to apply changes, see Restarting Services After Configuration Changes.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.

Share via