Export (0) Print
Expand All

RemoveRedundantProxyAuthorization Property of IFPCWebProxy[C++] | FPCWebProxy.RemoveRedundantProxyAuthorization [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

The RemoveRedundantProxyAuthorization property gets or sets a Boolean value that indicates whether the ISA Server 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.


HRESULT get_RemoveRedundantProxyAuthorization(
  VARIANT_BOOL* pfRemoveRedundantProxyAuthorization );

HRESULT put_RemoveRedundantProxyAuthorization(
  VARIANT_BOOL fRemoveRedundantProxyAuthorization );

Parameters

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

Return Values

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

Remarks

This property is read/write. Its default value is VARIANT_FALSE.

If requests sent by Web proxy clients are forwarded to an upstream proxy server by a Web chaining rule, Integrated authentication is required on the downstream ISA server computer, and Basic authentication is used for authentication to the upstream server, random authentication requests and other error messages may be displayed in the Web browser on the client computer. This problem can be resolved by configuring the downstream proxy server to remove all redundant 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.

The RemoveRedundantProxyAuthorization property gets or sets a Boolean value that indicates whether the ISA Server 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.


Property RemoveRedundantProxyAuthorization As Boolean

Property Value

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

Remarks

This property is read/write. Its default value is False.

If requests sent by Web proxy clients are forwarded to an upstream proxy server by a Web chaining rule, Integrated authentication is required on the downstream ISA server computer, and Basic authentication is used for authentication to the upstream server, random authentication requests and other error messages may be displayed in the Web browser on the client computer. This problem can be resolved by configuring the downstream proxy server to remove all redundant 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.

Example Code

This VBScript script sets the value of the RemoveRedundantProxyAuthorization property so that the 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.
 ' 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 redundant Proxy-Authorization
' headers from requests passed to an upstream server when Basic
' authentication is used for authentication to the upstream server.
webProxy.RemoveRedundantProxyAuthorization = 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

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCWebProxy

Show:
© 2014 Microsoft