Microsoft Internet Security and Acceleration Server 2004 SDK

FPCWebListenerProperties

The FPCWebListenerProperties object provides access to the properties of a Web listener for incoming or outgoing Web requests.

A Web listener can be configured to use Basic authentication, Digest authentication, Advanced Digest authentication, Integrated authentication, or Secure Sockets Layer (SSL) certificate authentication, or any combination of these methods to authenticate Web requests. Alternatively, a Web listener can be configured to use an authentication scheme defined by an FPCAuthenticationScheme object for authentication. The following authentication schemes are supplied with ISA Server 2004:

This object can be accessed through the Properties property of an FPCWebListener object, where it contains the properties of a Web listener for incoming Web requests, and through the WebListenerProperties property of an FPCNetwork object, where it contains the properties of a Web listener for outgoing Web requests.

Click here to see the ISA Server object hierarchy.

Methods

The FPCWebListenerProperties object defines the following methods.

Method Description
Refresh Recursively reads all the properties of the Web listener from persistent storage, overwriting any changes that were not saved.
Save Recursively writes the current values of all of the object's properties, including all the properties of its subobject and its elements, to persistent storage.

Properties

The FPCWebListenerProperties object has the following properties.

Property Description
AlwaysAuthenticate Gets or sets a Boolean value that indicates whether the ISA Server Web proxy always authenticates requests even if the policy does not require authentication.
AppliedSSLCertificates Gets an FPCAppliedSSLCertificates collection that contains the SSL server certificates used to authenticate the ISA Server computer when a client connects to the Web listener through the SSL port.
AuthenticationSchemes Gets an FPCRefs collection that contains references to the FPCAuthenticationScheme objects defining the authentication schemes available to the Web listener.
BasicAuthentication Gets or sets a Boolean value that indicates whether Basic authentication is used.
BasicAuthPersistSingleRequest Gets or sets a Boolean value that indicates whether Basic authentication persists across requests, thereby lasting throughout a session.
ConnectionTimeout Gets or sets the time, in seconds, of inactivity allowed on a connection before the connection is closed.
DigestAuthentication Gets or sets a Boolean value that indicates whether Digest authentication is used.
DigestAuthPersistSingleRequest Gets or sets a Boolean value that indicates whether Digest authentication persists across requests, thereby lasting throughout a session.
DomainForAuthentication Gets or sets the domain for Basic or Digest authentication.
IntegratedAuthPersistSingleRequest Gets or sets a Boolean value that indicates whether the Windows Integrated authentication persists across requests, thereby lasting throughout a session.
IntegratedWindowsAuthentication Gets or sets a Boolean value that indicates whether Windows Integrated authentication is used.
NumberOfConnections Gets or sets the number of simultaneous connections allowed from the ISA Server Web proxy to the Internet.
ResolveInArray Gets or sets a Boolean value that indicates whether the Web listener will attempt to retrieve the requested URL from the cache of the current array or directly from the external site.
ReturnAuthRequiredIfAuthUserDenied Gets or sets a Boolean value that indicates whether to return a Proxy Authorization Required message when a user is authenticated by the Web proxy but is denied access by the rules.
SingleRadiusServerAuthPerSession Gets or sets a Boolean value that indicates whether RADIUS authentication persists across requests, thereby lasting throughout a session.
SSLCertificateAuthentication Gets or sets a Boolean value that indicates whether SSL certificate authentication is used.
SSLPort Gets or sets the SSL port for the Web listener.
TCPPort Gets or sets the TCP port for the Web listener.
UnlimitedNumberOfConnections Gets or sets a Boolean value that indicates whether the Web proxy can have an unlimited number of connections.

Remarks

This object implements the IFPCWebListenerProperties interface.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

COM Objects