Microsoft Internet Security and Acceleration Server 2000

FPCWebPublishingRule Object

The FPCWebPublishingRule object representsa Web publishing rule. Web publishing rules determine how ISA Server should intercept incoming requests for HTTP objects on an internal Web server and how ISA Server should respond on behalf of the Web server. Requests are forwarded downstream to an internal Web server, located behind the ISA Server computer. If possible, the request is serviced from the ISA Server cache.

A Web publishing rule defines the response to attempts by outside users to access an internal site. Possible responses include:

Publishing rules cannot be created at the enterprise level. However, the enterprise administrator can specify, by using the FPCEnterprise.AllowPublishing property, whether an array is allowed to publish servers. If the array is allowed to publish, the array administrator can create Web publishing rules (FPCWebPublishingRule object) or server publishing rules (FPCServerPublishingRule object). If the enterprise policy does not allow publishing, then an attempt to add a Web or server publishing rule will return an error message.

This object is a member of the FPCWebPublishingRules collection.

Click here to see the ISA object hierarchy.

Note to C++ Programmers

This object implements the IFPCWebPublishingRule interface.

Methods

The following table lists the methods of the FPCWebPublishingRule object.

Method Description
Refresh Reads the object's configuration information from persistent storage, discarding any changes to the configuration that were not saved.
Save Saves the object's configuration to persistent storage.
SetDestination Sets the destinations to which the rule applies.
SetWebSiteAndPorts Sets the action to Redirect and sets the redirect Web site and ports.

Properties

The following table lists the properties of the FPCWebPublishingRule object.

Property Description
Action Gets the action that this rule performs.
AppliesToAccounts Gets the collection of accounts to which the rule applies.
AppliesToDestination Gets the type of destination to which the rule applies.
AppliesToMethod Gets or sets the method used for deciding to which users the rule applies.
ClientAddressSetsExcluded Gets the collection of client address sets to which the rule does not apply.
ClientAddressSetsUsed Gets the collection of client address sets to which the rule applies.
Description Gets or sets the description of the rule.
DestinationSetUsed Gets an FPCRef object that contains the name of the FPCRefs collection used to define the destination to which the rule applies.
Enabled Gets or sets whether the rule is enabled.
FTPRedirectPort Gets the port to redirect a request if the Web proxy service redirects it as an FTP request.
HTTPRedirectPort Gets the port to redirect a request if the Web proxy service redirects it as an HTTP request.
IsDefault Gets whether the rule is a preinstalled rule that cannot be deleted.
Name Gets or sets the name of the publishing rule.
NonSecureProtocolRedirection Gets or sets the protocol used when delegating a request that came on a nonsecure channel.
Order Gets the rule's order of execution in relation to the other rules.
SecureProtocolRedirection Gets or sets the protocol used when delegating a request that came on a nonsecure channel.
SendOriginalHostHeader Gets or sets whether ISA Server sends the original host header, or the header related to the site specified in the Web publishing rule.
SSLClientCertificate Gets or sets how the Web proxy handles client certificates.
SSLRedirectPort Gets the port to redirect requests if redirecting as an SSL request.
SSLRequireSecureChannel Gets or sets whether a secure channel is required.
VendorParametersSets Gets a reference to an object for storing and loading of custom data into the FPCWebPublishingRule object's storage.
WebSite Gets the Web site to redirect requests to when the Action property is set to the value fpcRouteRedirect.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires ISA Server 2000.
  Header: Msfpccom.idl.