Share via


Proxy Server Registry Settings (Compact 7)

3/12/2014

You can configure the registry settings in HKEY_LOCAL_MACHINE\Comm\WebProxy to customize the HTTP proxy server in Windows Embedded Compact 7.

Name Type Description Default value

BasicAuth

REG_DWORD

Indicates whether the proxy server uses Basic Authentication for client connections. Set to 1 to enable Basic Authentication, and set to 0 (zero) to disable Basic Authentication.

Basic Authentication enables the client browser to send the user identifier and password to the server.

Hh490539.security(en-us,WinEmbedded.70).gifSecurity Note:
When you use Basic Authentication, the client browser sends the user ID and password to the proxy server in plain text, which is open to packet sniffing by malware (malicious software). Therefore, also use Secure Sockets Layer (SSL) to help protect the user ID and password. For more information, see Authentication Services Catalog Items and Sysgen Variables.

The default value is 1.

MaxConnections

REG_DWORD

Maximum number of client connections that the proxy server supports.

The default value is 20.

MaxHeadersSize

REG_DWORD

Maximum size of HTTP headers, in bytes.

The default value is 24,576.

NTLMAuth

REG_DWORD

Indicates whether the proxy server uses NTLM to authenticate user credentials. If you use NTLM, the server and client browser negotiate a way for the client browser to send the password across a network in an encrypted format. Set to 1 to enable NTLM, and set to 0 to disable NTLM.

The default value is 1.

Port

REG_DWORD

The port on which the proxy server listens for incoming socket connections.

The default value is 8080.

ProxyErrorStringSize

REG_DWORD

The maximum size of the error text string, in bytes.

The default value is 512.

SecondProxyHost

REG_SZ

Host name or address of the second proxy host. If this registry value is present, the proxy server forwards all requests through a second proxy.

None.

SecondProxyPort

REG_SZ

Port number of the second proxy host.

None.

SessionThreads

REG_DWORD

Number of session threads.

Default value is 20.

SessionTimeoutSeconds

REG_DWORD

The timeout for each session, in seconds.

The default value is 30.

You can add registry keys under HKEY_LOCAL_MACHINE\Comm\WebProxy\Filters to specify a list of customized web filters that Windows Embedded Compact 7 loads when it starts the proxy server.

Name Type Description Default value

A filter name

REG_SZ

File name of a custom filter DLL that exports the following custom-implemented functions:

  • DWORD ProxyFilterHttpRequest(PROXY_HTTP_REQUEST pRequest);
  • DWORD WINAPI ProxyInitializeFilter(PROXY_HTTP_INFORMATION pInfo);
  • DWORD WINAPI ProxyNotifyAddrChange(void);
  • DWORD ProxySignalFilter( DWORD dwSignal);
  • DWORD WINAPI ProxyUninitializeFilter (void);

For example, to add Pcfilter.dll, use the registry code in the following example.

;Web Proxy filter setting
[HKEY_LOCAL_MACHINE\COMM\WEBPROXY\FILTERS]
"1"="pcfilter.dll"

None.

See Also

Concepts

Proxy Server Catalog Items and Sysgen Variables

Other Resources

Proxy Server
Authentication Services