For IBM® iNotes® features
that send requests either to external servers for external calendar
overlays or to Web services (IBM Quickr® integration),
you must configure an HTTP-proxy servlet to intercept calls and retrieve
information from a remote site.
About this task
An HTTP-proxy servlet specifies which sites are allowed
and filters out unwanted sites. Then, instead of making a request
call to an external server such as a Quickr server or a Google
server, calls are passed through the HTTP-proxy servlet. If the external
server is included as one of the allowed sites in the whitelist rule
for proxy servlets in the security policy settings document, then
the request is passed on to the external server, and any information
received from the external server is also returned.In IBM Domino® 8.5, the HTTP-proxy
servlet was configured by creating a proxy-config.properties file
located in the Domino\data\properties directory.
This file is no longer supported. Instead, you must create or edit
a security settings policy, using the information in this file. Once
you have done so, you can delete this file, however leaving it in
place will not adversely affect your configuration.
To
configure proxies, use a security settings document.
Procedure
- From the Domino Administrator,
create or edit a security settings document.
- Click the Proxies tab.
- Click Edit List.
- Enter the following information to create a white-list
rule for each site you want to allow.
Note: If you created
a proxy-config.properties file in a previous
release, use the information in that file to populate these fields.
Table 1. Proxies tab fields
Property |
Description |
Context |
The path of the request to the proxy server,
specifies which proxy the rule is for. Examples include: /xsp/proxy/QuickrProxy/ /xsp/proxy/GoogleProxy/ /xsp/proxy/BasicProxy/ |
URL |
Address of the site to which this policy applies. This
is the target of the proxy. |
Actions |
The set of HTTP actions this policy allows. These
can be GET, POST, HEAD, PUT, DELETE. The most frequently used are
GET and POST. For Quickr integration
with iNotes, make sure
that HEAD is included. |
Cookies |
Cookies allowed for this site. That is, the
cookies that will be passed from the browser to the target URL server. Note: Cookies
with specified names are always proxied to this site. In addition,
any incoming (Set-Cookie response headers) received from the site
will also be remembered and eventually sent back on subsequent requests
to this site. |
Mime-types |
Content types allowed back from the target
server, or use * to allow all. |
Headers |
Headers allowed for this site, or use * to
allow all. This attribute determines which headers are forwarded to
the target server. Note: Cookies are not handled as a standard
header. Adding the entry "cookie" in the headers list has no effect. |