Configure the Proxy for RMS

When KeyView needs to access contents that are protected by the Microsoft Rights Management System (RMS), it must make HTTP requests. By default, KeyView uses the system proxy settings for these requests.

To use different proxy settings, you can configure them in the [RMS] section of the formats.ini configuration file. The following table describes the available options.

Parameter Description
UseSystemProxy

Whether to obtain details about your HTTP proxy from the system. By default, this parameter is set to TRUE, which means:

  • On Microsoft Windows platforms, KeyView reads the proxy settings that are configured in the Windows Control Panel.
  • On Linux, KeyView reads the proxy settings from environment variables such as HTTP_PROXY and HTTPS_PROXY.

You can use UseSystemProxy instead of setting the other proxy parameters (ProxyHost, ProxyPort, ProxyUsername, and ProxyPassword). When UseSystemProxy is set to TRUE, you must remove these other parameters from your configuration.

NOTE: On Linux platforms, KeyView can retrieve a proxy username and password from an environment variable in the form http://username:password@proxy.example.com:8080/. However, this value cannot be encrypted.

On Microsoft Windows platforms, the operating system does not return a proxy username and password, so these are not supported.

Set UseSystemProxy to FALSE to use different proxy settings. In this case you must set at least ProxyHost and ProxyPort.

ProxyHost The host name or IP address of the proxy server.
ProxyPassword The password to use to authenticate with the proxy server.
ProxyPort The port of the proxy server to use to access the repository. This port must be greater than 0, and less than 65535.
ProxyUsername The user name to use to authenticate with the proxy server.