IFPCWebListenerProperties::AlwaysAuthenticate property

Article
08/27/2012

Applies to: desktop apps only

The AlwaysAuthenticate property gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy always requires authentication before processing a request even if the policy does not require authentication.

This property is read/write.

Syntax

HRESULT put_AlwaysAuthenticate(
  VARIANT_BOOL fAlwaysAuthenticate
);

HRESULT get_AlwaysAuthenticate(
  VARIANT_BOOL **pfAlwaysAuthenticate
);

' Data type: Boolean

Property AlwaysAuthenticate( _
  ByVal fAlwaysAuthenticate As VARIANT_BOOL, _
  ByVal pfAlwaysAuthenticate As VARIANT_BOOL _
) As Boolean

Property value

Boolean value that indicates whether the Web proxy always requires authentication before processing a request.

Error codes

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 False (VARIANT_FALSE in C++).

When this property is set to False (VARIANT_FALSE in C++) for a network, authentication can be required for an access rule by referencing the All Authenticated Users user set instead of the All Users user set in the UserSets property of the applicable rule.

When this property is set to True (VARIANT_TRUE in C++) for a network, traffic to sites that do not support user authentication, such as Windows Update, may be blocked. For a Web listener used in a Web publishing rule, authentication will be performed before the rule is applied to the traffic. If forms-based authentication is used, only the authentication settings in the Web listener will be used, and the customized HTML forms set specified in the Web publishing rule properties (CustomFormsDirectory) will be ignored.

The value of this property corresponds to the status of the Require all users to authenticate check box for the applicable network or Web listener in Forefront TMG Management.

Requirements

Minimum supported client	Windows Vista
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
DLL	Msfpccom.dll

Share via