Winfoom is an HTTP(s) proxy server facade that allows applications to authenticate through the following proxies:
- NTML or Kerberos HTTP authenticated proxy
- SOCKS version 4 or 5, with or without authentication
- Proxy Auto Config files - including Mozilla Firefox extension that is not part of original Netscape specification
typically used in corporate environments, without having to deal with the actual handshake.
A lot of software applications have problems when dealing with an authenticated proxy server's protocol. Winfoom sits between the corporate proxy and applications and offloads the authentication and the proxy's protocol, acting as a facade. This way, the software application will only have to deal with a basic proxy with no authentication.
An example of such a facade for NTLM proxies is CNTLM
To try out Winfoom without needing to download the source and package it, check out the releases for a prepackaged winfoom.zip
.
Winfoom is a Java application and comes with a release that includes a Java environment AdoptOpenJDK,
so you don't have to install anything.
If you decide to build the executable jar file from the source code, you would need these prerequisites:
- Java JDK 11(+)
- Maven 3.x version (optional)
First download the source code from releases and unzip it.
Then open a terminal and execute this command inside the winfoom-x.x.x
directory:
mvn clean package
or, if you did not install Maven, use the Maven Wrapper:
.\mvnw clean package
Now you should have the generated executable jar file under the target directory.
๐ Note: Winfoom only works on Windows OS!
The prepackaged winfoom.zip
contains a single executable file: launch.bat
.
Available commands:
launch.bat
launches the application using the bundled JRE.launch.bat --debug
launches the application using the bundled JRE in debug mode.launch.bat --systemjre
launches the application using your system JRE - you'll need a JRE v.11 (at least).launch.bat --debug --systemjre
launches the application using your system JRE in debug mode.
The fastest way to run Winfoom is by double-click on launch.bat
file.
The application log file is placed under <user.home.dir>/.winfoom/logs
directory.
Winfoom has a graphical user interface that allows configuration.
The first thing to select is the proxy type:
HTTP
- if the remote proxy is NTLM, KERBEROS or any other HTTP proxySOCKS4
- if the remote proxy is SOCKS version 4SOCKS5
- if the remote proxy is SOCKS version 5PAC
- if the proxy is using a Proxy Auto Config fileDIRECT
- no proxy, used for various testing environments
Then fill in the required fields. You can use the field's tooltip to get more information.
The system settings configuration file is <user.home.dir>/.winfoom/system.properties
.
Please do not modify this file unless absolutely necessary. It is advisable to post your issue in Issues Section first.
The available settings:
Key | Description | Type | Default value |
---|---|---|---|
maxConnections.perRoute | Connection pool property: max polled connections per route | Integer | 20 |
maxConnections | Connection pool property: max polled connections | Integer | 600 |
internalBuffer.length | The max size of the entity buffer (bytes) | Integer | 102400 |
connectionManager.clean.interval | The frequency of running purge idle on the connection manager pool (seconds) | Integer | 30 |
connectionManager.idleTimeout | The connections idle timeout, to be purged by a scheduled task (seconds) | Integer | 30 |
serverSocket.backlog | The maximum number of pending connections | Integer | 1000 |
socket.soTimeout | The timeout for read/write through socket channel (seconds) | Integer | 30 |
socket.connectTimeout | The timeout for socket connect (seconds) | Integer | 10 |
useSystemProperties | Whether to use the environment properties when configuring a HTTP client builder | Boolean | false |
- For HTTP proxy type, Winfoom uses the current Windows user credentials to authenticate to the remote proxy.
- For SOCKS5 proxy type, the user/password need the be provided when required.
To test it, open a browser, let's say Firefox and configure proxy like this:
Now you should be able to access any URL without Firefox asking for credentials.
If you don't have an available proxy, you still can test WinFoom by installing WinGate and configure it to act as a NTML proxy.
- Linux/MacOS porting.
Please review these docs below about coding practices.
Any feedback or suggestions are welcome. It is hosted with an Apache 2.0 license so issues, forks and PRs are most appreciated.