Viewing the Lotus Developer Domain in its native Notes format (Connecting to through a proxy sidebar)

[back to "Viewing the Lotus Developer Domain in its native Notes format"]

Connecting through a proxy (sidebar)
If you have an indirect connection to the Internet—that is, if your Notes client is behind a firewall and/or proxy server, you can still use Notes to connect to the Lotus Developer Domain servers. This sidebar gives you some background on what your administrator must do to set up a proxy, and then describes how you can specify proxy settings in your Location document. We'll also look at some additional troubleshooting tips for connecting via Notes.

How your administrator sets up a firewall/proxy for Notes communication
Your network administrator can set things up so you can use Notes to connect through a firewall and/or proxy server. To connect through a firewall, your administrator must allow the destination IP port 1352 through the firewall. No additional proxy configuration is required. (You do not need to specify any proxy settings on your Notes client to connect through a firewall; it's purely an administrative task.)

To connect through a proxy server, your administrator must set up one of the following proxy technologies: Domino passthru, an HTTP proxy for Notes RPC communication, or a SOCKS proxy for Notes RPC communication. (The HTTP proxy server must support the Connect method.) In addition, your administrator must allow port 1352 to pass through the proxy. The proxy should not require authentication, because the Notes RPC does not support connections through an authenticated proxy. Finally, your administrator should let you know the correct proxy settings you should use, so you can enter them in your Location document.

Specifying proxy settings in your Location document
To connect through a proxy server, you should first get the appropriate proxy settings from your administrator. Then, you only need to specify the proxy settings in your Location document. The rest of the steps for connecting to the site stay the same.

To specify the proxy settings in your Location document, do one of the following:

To use Domino passthru, enter the name of the appropriate Domino server in the Passthru server field (on the Servers tab).
To use an HTTP proxy for Notes RPC communication—In the Location document, click the hat icon next to the Proxy field (on the Basics tab). In the HTTP Tunnel field, enter the proxy server's name and the port number (usually 8080). For example, proxy.acme.com:8080 or 222.333.44.555:8080. (You want to enter this information into the HTTP Tunnel field, so you can use Notes services like replication. The HTTP proxy field is for strict HTTP connections, such as connecting to Web sites with the Personal Web Navigator.)
To use a SOCKS proxy for Notes RPC communication—In the Location document, click the hat icon next to the the Proxy field (on the Basics tab). In the SOCKS field, enter the host name or IP address of the SOCKS proxy and the port number (usually 1080). For example, proxy.company.com:1080 or 222.33.44.555:1080.

Note:

If you specify either a HTTP Tunnel or SOCKS proxy, you should also use the "No proxy for these hosts or domains" field to specify any Domino servers that you want to access without going through the proxy. For example, you'll probably want to access the servers on your internal network without using the proxy. So, you could enter a wildcard (*) character with your internal domain name; for example, *.acme.com. (If you leave the field blank, you won't be able to access your internal servers if the proxy server ever goes down. In addition, the additional traffic through the proxy server could affect performance and overall connectivity to the internal network.)