Windows SharePoint Services relies on absolute hyperlinks. A Uniform Resource Locator (URL) correction approach, such as ISA Server link translation, does not provide a complete solution. Some of the absolute URLs used by Windows SharePoint Services are easy to find and fix. For example, it is fairly easy to get something simple like the home page of a SharePoint site to render and function correctly. However, other absolute URLs are more difficult to find and fix. For example, there are absolute URLs in Microsoft ActiveX® controls, form post bodies, URL parameters, and Simple Object Access Protocol (SOAP) messages. These absolute URLs can be outbound from Windows SharePoint Services, inbound from client applications, or round-trip from Windows SharePoint Services to the client and back. Furthermore, the absolute URLs can be encoded when used as a parameter. For example, the URL http://server_name can look like http%2f%3a%3aserver_name in the form post body.
Taking into account these limitations, the following sections describe two ISA Server publishing scenarios that work with Windows SharePoint Services:
-
Web publishing Windows SharePoint Services with host-header forwarding. In host-header forwarding, ISA Server translates the IP address of the page that the client requests into the IP address of the page that the server returns.
-
Secure Web publishing Windows SharePoint Services with host-header forwarding. Use HTTPS-to-HTTPS bridging with two separate SSL connections—one between the client and ISA Server, and one between ISA Server and the published Windows SharePoint Services server. If you want to publish your Windows SharePoint Services server over a secure connection, you must use HTTPS-to-HTTPS bridging.
Web Publishing with Host-Header Forwarding
In a Web publishing scenario, the client sends HTTP requests to ISA Server as if it were the Web server. With host-header forwarding enabled, ISA Server then forwards the HTTP packets to the actual Web server while preserving the host header in the HTTP packets. On the Web server, Windows SharePoint Services uses the host header information to generate hyperlinks on pages that will be reachable by the client. The Web server then sends HTTP responses through ISA Server to the client. The following figure shows an example of a host-header forwarding configuration.
Figure 1 Host-header forwarding
The configuration process is as follows:
-
Install and configure Windows SharePoint Services. Install and configure your Windows SharePoint Services server farm and sites as required. For more information about installation requirements, see Installation Considerations for Windows SharePoint Services in the Administrator’s Guide for Windows SharePoint Services. When you have finished configuring your server farm and sites, select the Microsoft Internet Information Services (IIS) authentication method appropriate for your environment, as described in the Configuring Authentication topic in the Administrator’s Guide for Windows SharePoint Services. ISA Server can authenticate client requests using either Integrated Windows authentication or Basic authentication. Consider authentication requirements:
-
In Basic authentication, plaintext credentials are encoded (not encrypted) and can be easily decoded (BASE 64). Basic authentication should be used in conjunction with an HTTPS connection.
-
If ISA Server policy requires user authentication, Basic authentication must be configured on both the server running Windows SharePoint Services, and ISA Server. The Web publishing rule must be configured to delegate Basic authentication credentials. Basic authentication with delegation first authenticates the user at the ISA Server computer, before forwarding client credentials to the Web server for authentication. If you configure Basic authentication on the ISA Server computer and on the internal Web server without delegating credentials, external users will be presented with multiple logon prompts. Authentication will not be successful because ISA Server consumes the credentials before the internal Web server receives them. Delegating credentials ensures that users are first authenticated at the ISA Server computer before the request is forwarded. It also provides a means of logging user credentials in the ISA Server logs, and a single sign-on mechanism between ISA Server and the Web server. Note that there may still be instances in which users are prompted for credentials after initial authentication. For example, this may happen when trying to open an Office document from the site. To delegate Basic authentication credentials on the ISA Server computer, you must configure authentication on the Web listener, and then configure the Web publishing rule to delegate Basic authentication credentials.
-
Integrated Windows authentication is more secure than Basic authentication. No user name and domain is sent across the wire. Integrated Windows authentication makes use of Kerberos or built-in NTLM. This type of authentication may cause some issues for users running early browser versions.
-
If ISA Server policy does not require user authentication, you can use either Basic authentication or Integrated Windows authentication on the Windows SharePoint Services computer. Note that you can configure Integrated Windows authentication on the ISA Server computer or on the Web server, but not both. If you choose to authenticate only on the Web server, ISA Server uses pass-through authentication. (Kerberos cannot be used.) The disadvantage of authenticating only on the Windows SharePoint Services server is that it does not provide the protection that ISA Server provides. When you configure authentication on the ISA Server computer, you ensure that any unauthenticated, anonymous requests are dropped before forwarding to the published server.
-
By default, virtual Web sites created in IIS Manager are configured for Basic and Integrated Windows authentication. For instructions on modifying authentication settings on the Web server running Windows SharePoint Services, see Configure Authentication on the Web Server in this document.
-
Allow Windows SharePoint Services to connect to the Internet. Configure ISA Server to allow the Windows SharePoint Services server to make connections to the Internet when necessary. For example, the Web Capture Web Part and the online Web Part gallery require access to the Internet. Do this as follows:
-
Create a computer set containing the Windows SharePoint Services server.
-
Create an access rule to allow the computer set to access the External network (Internet).
-
On the Windows SharePoint Services server, edit the Web.config file for access to the Internet.
-
Create a public DNS entry. After setting up Windows SharePoint Services on your server farm, you must create an external (public) Domain Name System (DNS) entry to resolve the fully qualified domain name (FQDN) that external clients specify in a Web request to the IP address of the external interface of the ISA Server computer publishing the Web site. If you are using Windows SharePoint Services in a multiple host names deployment (scalable hosting mode), be sure that a DNS mapping is created for each host name site you set up. To do so, create a unique public DNS entry for each host name site. For example:
-
Host1.Contoso.com 10.11.111.11
-
Host2.Contoso.com 10.11.111.11
Alternatively, you can create a wildcard public DNS entry so that all host names within your domain map to your proxy server’s public interface IP address. For example:
-
*.Contoso.com 10.11.111.11
For more information, see Server Farm with Multiple Host Names Deployment in the Administrator’s Guide for Windows SharePoint Services.
-
Back up your current configuration. We recommend that you use the backup functionality of ISA Server to back up your configuration before making any changes. If the changes you make result in behavior that you did not expect, you can revert to the previous configuration.
-
Create a Web listener. All incoming Web requests to ISA Server should be received by a Web listener. Multiple Web publishing rules can use a single listener. When you configure a Web listener, you specify the network that corresponds to the adapter on which ISA Server will listen for incoming requests. For example, if you want to allow access to the SharePoint site from the Internet (External network), you should select the External network for the Web listener. The listener can listen on all IP addresses associated with a network, or specific IP addresses. You also configure the port number that will listen for requests on the selected network IP addresses.
-
Create a Web publishing rule. Create a Web publishing rule to publish SharePoint sites, and to forward client requests, complete with host headers, from ISA Server to the published server.
-
Configure the HTTP filter. After creating the Web publishing rule, you must change the HTTP security filter setting. The HTTP filter screens all incoming Web requests to the ISA Server computer, and only allows requests that comply with the restrictions configured in ISA Server. For example, the Verify Normalization feature (enabled by default) specifies that requests with URLs that contain escape characters after normalization will be blocked. Escaped characters include, but are not limited to, the percent sign (%) and space character ( ). If this feature is enabled, Windows SharePoint Services document libraries will fail. URLs for document libraries and files uploaded and downloaded include non-standard characters such as the percent sign (%).
-
Test the connection:
-
From an internal client. After configuring the Windows SharePoint Services server, check that it can be accessed from an internal client computer. In Internet Explorer, type the URL or IP address for the SharePoint site, and the workspace should appear. For Basic authentication, you will be prompted for credentials. For Integrated Windows authentication, you will not receive an authentication prompt. If you specify a URL rather than an IP address, the internal computer will need to be able to resolve the name of the Windows SharePoint Services computer, either using an internal DNS server, or with a hostname entry in the client computer’s Hosts file.
-
From an external client. Open Internet Explorer, enter the external FQDN of the published SharePoint Web site (the external IP address of the ISA Server computer) in the address box, and press Enter. If you configured Basic authentication, you should be prompted for your account credentials. Enter a user name (without the domain prefix to test the default domain setting in IIS) and password, and click OK. If you configure Integrated Windows authentication, you will not be prompted for credentials.
Allow Windows SharePoint Services to Connect to the Internet
To allow an outbound connection from the published Windows SharePoint Services server to the Internet, you will create a computer set, create an access rule, and then edit the Web.config file.
Create a computer set
This procedure presumes that the Windows SharePoint Services computer is located in the Internal network. To create a computer set, perform the following steps:
-
Click Start, point to All Programs, point to Microsoft ISA Server, and then click ISA Server Management.
-
In the scope pane, click the plus sign next to the server name and then click the plus sign next to Configuration.
-
Click Networks, on the Networks tab right-click Internal, and then click Properties.
-
On the Web Proxy tab, verify that the Enable Web Proxy clients and Enable HTTP check boxes are selected. Then click OK.
-
In the scope pane, click Firewall Policy.
-
In the task pane, on the Toolbox tab, click Network Objects. Click New, and then click Computer Set.
-
In the Name box, type a descriptive name for your server environment such as Windows SharePoint Services servers.
-
Click Add, and then click AddressRange.
-
In the New Address Range Rule Element dialog box, in the Name box, type a descriptive name for the Windows SharePoint Services computer.
-
In the Start Address and End Address boxes, enter the IP address range of your servers running Windows SharePoint Services. For example, if the IP addresses for your servers running Windows SharePoint Services are 192.168.1.1, 192.168.1.2, and 192.168.1.3, you would enter the following:
-
Start Address: 192.168.1.1
-
End Address: 192.168.1.3
-
Click OK to close the New Address Range Rule Element dialog box.
-
Click OK to close the New Computer Set Rule Element dialog box.
-
Click Apply to apply changes.
Create an access rule
To create an access rule to allow the computer set to access the Internet, perform the following steps:
-
Click Start, point to All Programs, point to Microsoft ISA Server, and then click ISA Server Management.
-
In the scope pane, right-click Firewall Policy, point to New, and then click Access Rule.
-
In the New Access Rule Wizard, in the Access rule name box, type an access rule name such as Allow Web servers access to Internet, and then click Next.
-
Under Action to take when rule conditions are met, click Allow, and then click Next.
-
In the This rule applies to box, select Selected protocols, and then click Add.
-
In the Add Protocols dialog box, click the plus sign next to Web, click HTTP, and then click Add.
-
Click HTTPS, click Add, and then click Close.
-
Click Next.
-
In the Access Rule Sources dialog box, under This rule applies to traffic from these sources, click Add.
-
In the Add Network Entities dialog box, click the plus sign next to Computer Sets, select the computer set you created earlier, and then click Add.
-
Click Close to close the Add Network Entities dialog box.
-
Click Next.
-
Under This rule applies to traffic sent to these destinations, click Add.
-
In the Add Network Entities dialog box, click the plus sign next to Network Sets, select All Networks, and then click Add.
-
Click Close.
-
Click Next.
-
Click Next again, click Finish, and then click Apply to save the changes and update the configuration.
Edit the Web.config file
Find the Web.config file in the root of the virtual server or virtual servers that have been extended with Windows SharePoint Services. For example, the path to the Web.config file might be C:\Inetpub\wwwroot\web.config. In the Web.config file, after the </SharePoint> tag, add the following tags to configure Windows SharePoint Services to make connections to the Internet through your outbound proxy server, where http://myproxy:8080 is the address and TCP port to connect to the outbound proxy server’s private network interface:
<system.net>
<defaultProxy>
<proxy proxyaddress="http://myproxy:8080" bypassonlocal="true" />
</defaultProxy>
</system.net>
Note that you must make this change to the Web.config files for each virtual server on each server in your server farm.
Back Up Your Current Configuration
To back up your current configuration, perform the following steps:
-
In ISA Server Management, right-click the name of the ISA Server computer, and click Back Up.
-
In Backup Configuration, provide the location and name of the file to which you want to save the configuration. You may want to include the date of the export in the file name to make it easier to identity, such as ExportBackup2June2004.
-
Click Back Up. If you are exporting confidential information such as user passwords, you will be prompted to provide a password, which will be needed to restore the configuration from the exported file.
-
When the backup operation is complete, click OK.
Create a Web Listener
To create a Web listener, perform the following steps:
-
In ISA Server Management, click Firewall Policy.
-
In the task pane, on the Toolbox tab, click Network Objects, click New, and then select Web Listener.
-
In the Web listener name box, type a name for the Web listener, for example, WSS_Listener.
-
Click Next.
-
In the Listen for requests from these networks box, select the check boxes for the networks that you want the listener to listen on. For example, select the External check box to listen for requests from the Internet.
-
Click Next.
-
On the Port Specification page, under HTTP, select the Enable HTTP check box, and then in the HTTP port box, type 80.
Note: |
|---|
|
If the virtual server running IIS that you will publish is configured to listen on a different port, you should configure the ISA Server Web listener to use the same port.
|
-
Click Next, and then click Finish.
-
Click Apply to save the changes and update the configuration.
Create a Web Publishing Rule
To create a Web publishing rule, perform the following steps:
-
In ISA Server Management, right-click the Firewall Policy node, point to New, and then click Web Server Publishing Rule.
-
In the New Web Publishing Rule Wizard, type a name for the new rule. For example, Publish SharePoint for external access.
-
Click Next.
-
Under Action to take when rule conditions are met, click Allow, and then click Next.
-
On the Define Website to Publish page, in the Computer name or IP address box, type the IP address or name of the computer running the SharePoint site. Remember that if you specify a name, you will need an internal DNS entry to resolve the name to an IP address.
-
Select the Forward the original host header instead of the actual one (specified above) check box to ensure that the host header contains the original external DNS name typed in the URL.
-
In the Path box, type /*.
-
Click Next.
-
On the Public Name Details page, in the Accept requests for box, select Any domain name to forward requests to the published SharePoint site without checking for the domain name, or select This domain name, and in the Public name box, specify the external FQDN that users will specify in their browser to reach the site.
-
Click Next.
-
On the Select Web Listener page, in the Web listener box, select the Web listener that you created previously.
-
Click Next.
-
Click Next again, and then click Finish.
-
Click Apply to save the changes and update the configuration.
Configure the HTTP Filter
To configure the HTTP filter, perform the following steps:
-
Right-click the Web publishing rule you created, and select Configure HTTP.
-
On the General tab, clear the Verify normalization check box.
-
If you are using a language containing high bit characters (for example, the umlaut mark in German) you should also clear the Block high bit characters check box.
Note: |
|---|
|
The Verify normalization and Block high bit characters options are meant to address potential security exploits. When you disable these features, you are potentially creating an opening for malicious users.
|
Web Publishing with Host-Header Forwarding over a Secure Connection
ISA Server HTTPS-to-HTTPS bridging allows stateful inspection of SSL connections, and prevents attackers from hiding exploits inside the SSL channel. ISA Server decrypts the packets, inspects them for attack code, and then encrypts them. The encrypted packets are forwarded to the secure SSL Web server on the corporate network.
Although ISA Server also enables HTTPS-to-HTTP bridging, this is not supported when publishing Windows SharePoint Services. Windows SharePoint Services uses absolute URLs, and the URL from the client and the URL sent to the server must match. To keep the URL sent from the client to ISA Server the same as the URL sent from ISA Server to the Web server, a new SSL connection must be established between ISA Server and the Web server.
The following figure shows an SSL bridging (HTTPS-to-HTTPS) configuration.
Figure 2 Secure Sockets Layer (SSL) bridging
The configuration process is as follows:
-
Install and configure Windows SharePoint Services. Install and configure your Windows SharePoint Services server farm and sites as required. For more information about installation requirements, see Installation Considerations for Windows SharePoint Services. When you have finished configuring your server farm and sites, select the Microsoft Internet Information Services (IIS) authentication method appropriate for your client, server, and proxy environment, as described in the Configuring Authentication topic in the Administrator’s Guide for Windows SharePoint Services. ISA Server can support either Integrated Windows authentication or Basic authentication. Consider authentication requirements:
-
In Basic authentication, plaintext credentials are encoded (not encrypted) and can be easily decoded (BASE 64). Basic authentication should be used in conjunction with an HTTPS connection.
-
If ISA Server policy requires user authentication, Basic authentication must be configured on both the server running Windows SharePoint Services, and ISA Server. The Web publishing rule must be configured to delegate Basic authentication credentials. Basic authentication with delegation first authenticates the user at the ISA Server computer, before forwarding client credentials to the Web server for authentication. If you configure Basic authentication on the ISA Server computer and on the internal Web server without delegating credentials, external users will be presented with multiple logon prompts. Authentication will not be successful because ISA Server consumes the credentials before the internal Web server receives them. Delegating credentials ensures that users are first authenticated at the ISA Server computer before the request is forwarded. It also provides a means of logging user credentials in the ISA Server logs, and a single sign-on mechanism between ISA Server and the Web server. Note that there may still be instances in which users are prompted for credentials after initial authentication. For example, this may happen when trying to open an Office document from the site.
-
Integrated Windows authentication is more secure than Basic authentication. No user name and domain is sent across the wire. Integrated Windows authentication makes use of Kerberos or built-in NTLM. This type of authentication may cause some issues for users running early browser versions.
-
If ISA Server policy does not require user authentication, you can use either Basic authentication or Integrated Windows authentication on Windows SharePoint Services. Note that you can configure Integrated Windows authentication on the ISA Server computer or on the Web server, but not both. If you choose to authenticate only on the Web server, ISA Server uses pass-through authentication. (Kerberos cannot be used.) The disadvantage of authenticating only on the Windows SharePoint Services server is that it does not provide the protection that ISA Server provides. When you configure authentication on the ISA Server computer, you ensure that any unauthenticated, anonymous requests are dropped before forwarding to the published server.
-
By default, virtual Web sites created in IIS Manager are configured for Basic and Integrated Windows authentication.
-
Allow Windows SharePoint Services to connect to the Internet. Configure ISA Server to allow the Windows SharePoint Services server to make connections to the Internet when necessary. For example, the Web Capture Web Part and the online Web Part gallery require access to the Internet. Do this as follows:
-
Create a computer set containing the Windows SharePoint Services server.
-
Create an access rule to allow the computer set to access the External network (Internet).
-
On the Windows SharePoint Services server, edit the Web.config file for access to the Internet.
-
Create a public DNS entry. After setting up Windows SharePoint Services on your server farm, you must create an external (public) DNS entry to resolve the FQDN that external clients specify in a Web request to the IP address of the external interface of the ISA Server computer publishing the Web site. If you are using Windows SharePoint Services in a multiple host names deployment (scalable hosting mode), be sure that a DNS mapping is created for each host name site you set up. To do so, create a unique public DNS entry for each host name site. For example:
-
Host1.Contoso.com 10.11.111.11
-
Host2.Contoso.com 10.11.111.11
-
Alternatively, you can create a wildcard public DNS entry so that all host names within your domain map to your proxy server’s public interface IP address. For example:
-
*.Contoso.com 10.11.111.11
For more information, see Server Farm with Multiple Host Names Deployment.
-
Back up your current configuration. We recommend that you use the backup functionality of ISA Server to back up your configuration before making any changes. If the changes you make result in behavior that you did not expect, you can revert to the previous configuration.
-
Configure SSL certificates. For publishing over a secure connection, use HTTPS-to-HTTPS bridging. This requires a certificate on both the ISA Server computer and the Windows SharePoint Services site.
-
Create a secure Web listener. All incoming Web requests to ISA Server should be received by a Web listener. Multiple Web publishing rules can use a single listener. When you configure a Web listener, you specify the network that corresponds to the adapter on which ISA Server will listen for incoming Windows SharePoint Services requests. For example, if you want to allow access to the SharePoint site from the Internet (External network), you should select the External network for the Web listener. The listener can listen on all IP addresses associated with a network, or specific IP addresses. You also configure the port number that will listen for requests on the selected network IP addresses. By default, ISA Server listens for SSL requests on port 443.
-
Create a secure Web publishing rule. Create a Web publishing rule to publish SharePoint sites, and to forward client requests, complete with host headers, from ISA Server to a published server.
-
Configure the HTTP filter. After you have created the Web publishing rule, you must change the HTTP security filter setting. The HTTP filter screens all incoming Web requests to the ISA Server computer, and only allows requests that comply with the restrictions configured in ISA Server. For example, the Verify Normalization feature (enabled by default) specifies that requests with URLs that contain escape characters after normalization will be blocked. Escaped characters include, but are not limited to, the percent sign (%) and space character ( ). If this feature is enabled, Windows SharePoint Services document libraries will fail. URLs for document libraries and files uploaded and downloaded include non-standard characters such as the percent sign (%).
-
Test the connection:
-
From an internal client. After configuring the Windows SharePoint Services server, check that it can be accessed from an internal client computer. In Internet Explorer, type the URL or IP address for the SharePoint portal site, and the workspace should appear. For Basic authentication, you will be prompted for credentials. For Integrated Windows authentication, you will not receive an authentication prompt. If you specify a URL rather than an IP address, the internal computer will need to be able to resolve the name of the Windows SharePoint Services computer, either using an internal DNS server, or with a hostname entry in the client computer’s Hosts file.
-
From an external client. Open Internet Explorer, enter the external FQDN of the published SharePoint Web site (the external IP address of the ISA Server computer) in the address box, and press Enter. If you configured Basic authentication, you should be prompted for your account credentials. Enter a user name (without the domain prefix to test the default domain setting in IIS) and password, and click OK. If you configure Integrated Windows authentication, you will not be prompted for credentials.
Allow Windows SharePoint Services to Connect to the Internet
To allow an outbound connection from the published Windows SharePoint Services server, you will create a computer set, create an access rule, and edit the Web.config file.
Create a computer set
This procedure presumes that the Windows SharePoint Services computer is located in the Internal network. To create a computer set, perform the following steps:
-
Click Start, point to All Programs, point to Microsoft ISA Server, and then click ISA Server Management.
-
In the scope pane, click the plus sign next to the server name and then click the plus sign next to Configuration.
-
Click Networks, on the Networks tab right-click Internal, and then click Properties.
-
On the Web Proxy tab, verify that the Enable Web Proxy clients and Enable HTTP check boxes are selected. Then click OK.
-
In the scope pane, click Firewall Policy.
-
In the task pane, on the Toolbox tab, click Network Objects. Click New, and then click Computer Set.
-
In the Name box, type a descriptive name for your server environment such as Windows SharePoint Services servers.
-
Click Add, and then click AddressRange.
-
In the New Address Range Rule Element dialog box, in the Name box, type a descriptive name for the Windows SharePoint Services computer.
-
In the Start Address and End Address boxes, enter the IP address range of your servers running Windows SharePoint Services. For example, if the IP addresses for your servers running Windows SharePoint Services are 192.168.1.1, 192.168.1.2, and 192.168.1.3, you would enter the following:
-
Start Address: 192.168.1.1
-
End Address: 192.168.1.3
-
Click OK to close the New Address Range Rule Element dialog box.
-
Click OK to close the New Computer Set Rule Element dialog box.
-
Click Apply to apply changes.
Create an access rule
To create an access rule to allow the computer set to access the Internet, perform the following steps:
-
Click Start, point to All Programs, point to Microsoft ISA Server, and then click ISA Server Management.
-
In the scope pane, right-click Firewall Policy, point to New, and then click Access Rule.
-
In the New Access Rule Wizard, in the Access rule name box, type an access rule name such as Allow Web servers access to Internet, and then click Next.
-
Under Action to take when rule conditions are met, click Allow, and then click Next.
-
In the This rule applies to box, select Selected protocols, and then click Add.
-
In the Add Protocols dialog box, click the plus sign next to Web, click HTTP, and then click Add.
-
Click HTTPS, click Add, and then click Close.
-
Click Next.
-
In the Access Rule Sources dialog box, under This rule applies to traffic from these sources, click Add.
-
In the Add Network Entities dialog box, click the plus sign next to Computer Sets, select the computer set you created earlier, and then click Add.
-
Click Close to close the Add Network Entities dialog box, and then click Next.
-
Under This rule applies to traffic sent to these destinations, click Add.
-
In the Add Network Entities dialog box, click the plus sign next to Network Sets, select All Networks, and then click Add.
-
Click Close, and then click Next.
-
Click Next again, click Finish, and then click Apply to save the changes and update the configuration.
Edit the Web.config file
Find the Web.config file in the root of the virtual server or virtual servers that have been extended with Windows SharePoint Services. For example, the path to the Web.config file might be C:\Inetpub\wwwroot\web.config. In the Web.config file, after the </SharePoint> tag, add the following tags to configure Windows SharePoint Services to make connections to the Internet through your outbound proxy server, where http://myproxy:8080 is the address and TCP port to connect to the outbound proxy server’s private network interface:
<system.net>
<defaultProxy>
<proxy proxyaddress="http://myproxy:8080" bypassonlocal="true" />
</defaultProxy>
</system.net>
Note that you must make this change to the Web.config files for each virtual server on each server in your server farm.
Back Up Your Current Configuration
To back up your current configuration, perform the following steps:
-
In ISA Server Management, right-click the name of the ISA Server computer, and click Back Up.
-
In Backup Configuration, provide the location and name of the file to which you want to save the configuration. You may want to include the date of the export in the file name to make it easier to identity, such as ExportBackup2June2004.
-
Click Back Up. If you are exporting confidential information such as user passwords, you will be prompted to provide a password, which will be needed to restore the configuration from the exported file.
-
When the backup operation is complete, click OK.
Configure SSL Certificates
HTTPS-to-HTTPS bridging requires a certificate on both the ISA Server computer and the Windows SharePoint Services site. All of the SSL certificates must meet the following criteria:
-
The Issued to name on the certificate must match the internal DNS name you specify when you create the Web publishing rule.
-
The certificate must not be expired.
-
ISA Server must trust the certification authority (CA) that issued the SSL certificate on the servers running Windows SharePoint Services.
The following scenarios show you how to configure the certificates.
Scenario 1: You already have a commercial SSL Server certificate installed on the published server
On the ISA Server computer. Either export the existing certificate or obtain a new one, as follows:
-
Export the existing certificate from your Web server to ISA Server. For instructions, see Export a Certificate from the Web Server to the ISA Server Computer in this document. If you do not want to use the name on the existing commercial certificate, you must purchase a new one.
-
Alternatively, if you do not want to use the existing commercial certificate, you can leave the existing commercial certificate on the Web server, and request and install a new commercial certificate for the ISA Server computer. For procedures, see Appendix B: Obtain and Configure Certificates from a Commercial CA in this document.
On the published server. Choose whether to leave a copy of the existing certificate on the Web server, or obtain a new one, as follows:
-
Leave a copy of the existing certificate on the Web server. For this to work, the name on the To tab of the Web publishing rule must match the name on the certificate, the published name. Otherwise an error is generated when ISA Server sends an HTTPS request.
-
Alternatively, request and install a new commercial certificate for the Web server. For instructions, see Create a Certificate Request from a Commercial CA, and then Submit a Certificate Request File in this document. The name on the certificate (Common Name or CN) must match the name that ISA Server uses to refer to the Web server, which is the name on the To tab of the Web publishing rule. If it does not match, you may encounter issues outlined in the article Clients may receive an "Error Code 500 Internal Server Error" error message.
Note: |
|---|
|
Instead of a new commercial certificate, you can obtain a certificate from a local certification authority (CA) for the published server. This certificate will be used for the ISA Server computer to Web server connection. This saves the cost of a second commercial certificate, and the root certificate from the local CA can be stored on the ISA Server computer. To set up such a certificate, follow the procedures in Appendix C: Set Up a Local CA in this document.
|
Scenario 2: You do not have a commercial SSL certificate installed on the published server
On the ISA Server computer. Obtain a certificate for ISA Server, as follows:
-
Generally, for external sites, you obtain a certificate from a commercial CA (such as Verisign or Thawte). You create a certificate request from a commercial CA using the IIS Web Server Certificate Wizard, and submit the request file. Because IIS is typically not installed on the ISA Server computer, you will request the certificate from the Web server, and export it to the ISA Server computer. For instructions, see Appendix B: Obtain and Configure Certificates from a Commercial CA in this document. Note that the name you use to publish the Web site in the Web publishing rule must match the name on the certificate. Currently there is no way to request an SSL server certificate from ISA Server 2004 to the CA directly.
On the published server. Choose whether to leave a copy of the new certificate you obtained and exported to ISA Server, or obtain another commercial or local CA certificate, as follows:
-
Leave a copy of the existing certificate on the Web server, so that both the ISA Server computer and the Web server use the same certificate. The name on the To tab of the Web publishing rule must match the name on the certificate.
-
Alternatively, request and install a new commercial certificate for the Web server. For instructions, see Appendix B: Obtain and Configure Certificates from a Commercial CA in this document. The name on the certificate must match the name that ISA Server uses to refer to the Web server, which is the name on the To tab of the Web publishing rule.
Note: |
|---|
|
Instead of obtaining another new commercial certificate, you can obtain a certificate from a local CA for the ISA Server computer to Web server connection. This would save you the cost of a second commercial certificate, and the root certificate from the local CA can be stored on the ISA Server computer. To do this, follow the procedures in Appendix C: Set Up a Local CA.
|
Create a Secure Web Listener
To create a secure Web listener, perform the following steps:
-
In ISA Server Management, click Firewall Policy.
-
In the task pane, on the Toolbox tab, select Network Objects, click New, and then select Web Listener.
-
Specify a name for the Web listener. For example WSS_Listener.
-
Then click Next.
-
In IP Addresses, select the check box for the networks that you want the listener to listen on. For example, select the External check box to listen to requests from the Internet.
-
Click Next.
-
On the Port Specification page, under HTTP, clear Enable HTTP. Under SSL, select the Enable SSL check box, and then in SSL port, type 443.
-
Click Select to choose the server certificate you will use for the SSL authentication process. In the Select Certificate dialog box, select the required certificate. Then click OK.
-
Click Next, and then click Finish to complete the wizard.
-
Click Apply to apply changes.
Create a Secure Web Publishing Rule
To create a secure Web publishing rule to specify how ISA Server handles HTTPS requests for the Windows SharePoint Services Web server, and how it responds on behalf of the Web server, perform the following steps:
-
In ISA Server Management, right-click the Firewall Policy node, point to New, and then click Secure Web Server Publishing Rule.
-
In the SSL Web Publishing Wizard, type a name for the new rule, and then click Next.
-
On the Publishing Mode page, select SSL Bridging, and then click Next.
-
On the Select Rule Action page, select Allow, and then click Next.
-
On the Bridging Mode page, to forward HTTPS requests from the ISA Server computer to the Web server over HTTPS, select Secure connection to clients and Web server. Then click Next.
-
On the Define Website to Publish page, in Computer name or IP address, type the IP address or name of the computer running the SharePoint Web site. Remember that if you specify a name, you will need an internal DNS entry to resolve the name to an IP address.
-
Select Forward the original host header instead of the actual one (specified above) to ensure that the host header contains the original external DNS name typed in the URL. Some Windows SharePoint Services features require the external DNS name. Click Next.
-
On the Public Name Details page, in Accept requests for, select Any domain name to forward requests to the published SharePoint site without checking for the domain name, or select This domain name, and in the Public name dialog box that appears, specify the external FQDN that users will specify in their browser to reach the site. Then click Next.
-
On the Select Web Listener page, in Web listener, select the Web listener for the network on which you want to listen for requests to the SharePoint site. Click New to create a new listener if you have not previously defined one. Then click Next.
-
On the User Sets page, specify the users from whom the listener will accept requests. To accept requests from all users, leave the default All Users. To limit users, click Add and then select the user set. On the Add Users page, click New to create a new user set. Then click Next. Then click Finish to complete the wizard.
Configure the HTTP Filter
To configure the HTTP filter, perform the following steps:
-
Right-click the Web publishing rule you created, and select Configure HTTP.
-
On the General tab, clear Verify normalization.
-
If you are using a language containing high bit characters (for example, the umlaut mark in German) you may want to clear Block hit bit characters.