Skip to content

Commit

Permalink
Update beta version number and Readme file.
Browse files Browse the repository at this point in the history
  • Loading branch information
atauenis committed Jun 27, 2023
1 parent 7e39494 commit eeb360e
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 28 deletions.
2 changes: 1 addition & 1 deletion Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ static void Main(string[] args)
Assembly.GetExecutingAssembly().GetName().Version.Major + "." +
Assembly.GetExecutingAssembly().GetName().Version.Minor + "." +
Assembly.GetExecutingAssembly().GetName().Version.Build
+ "-beta2pre"
+ "-beta2"
);
Variables.Add("WOSystem", Environment.OSVersion.ToString());

Expand Down
43 changes: 17 additions & 26 deletions README-0.16-BETA.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,46 +2,37 @@

While the latest stable version of WebOne Proxy Server is 0.15.3, the development is still going forward. There are also newer developers builds of next version, 0.16. They are available for testing and debugging. Compiled builds can be found in [Release archive](https://github.com/atauenis/webone/releases). But sometimes a newer build can be obtained from sources from Git repository.

This is a pre-release of WebOne Proxy Server, version 0.16 pre-Beta 2. It is half-completed work, containing preview of new features and may be not enough stable.
This is a pre-release of WebOne Proxy Server, version 0.16 Beta 2. It is half-completed work, containing preview of new features and may be not enough stable.

WebOne 0.16's major new feature is support for HTTPS requests through proxy. Implementing the HTTPS support required also to rewrite from scratch most of code, related to regular HTTP/1.1. Previous WebOne versions (including 0.15.3) used Microsoft's library for decoding (and coding back) HTTP traffic. It have many limitations, which appear as "400 Bad Request" error pages without any prints in WebOne log.
WebOne 0.16's major new feature is support for HTTPS requests through proxy. Also it supports "CERN-compatible" FTP support, meaning ability to open ftp:// URLs via Web browser as well as https:// and http://.

Examples of errors: https://github.com/atauenis/webone/issues/82, https://github.com/atauenis/webone/issues/88, https://github.com/atauenis/webone/issues/90.
Implementing these features support required also to rewrite from scratch most of code. New low-level & high-level HTTP/HTTPS processing code is written from zero, so currently may work not as expected. Original HTTP/1.1 protocol (RFC 2616) is 176 page long, and not all aspects of it are currently implemented correctly.

New low-level & high-level HTTP/HTTPS processing code is written from zero, so currently may work not as expected. Original HTTP/1.1 protocol (RFC 2616) is 176 page long, and not all aspects of it is currently implemented correctly. In addition to HTTP & HTTPS, it also supports "CERN-compatible" FTP proxying. So you can open http://, https:// and ftp:// URLs via Web browser.

**Only in this Beta version, WebOne runs on two ports in parallel.** It's made for test & debug purposes.

- The main port, 8080, is a slightly modified version of original HTTP Proxy. It still use Microsoft HTTPAPI, and works almost as before. But may contain new bugs, due to some modifications of other WebOne parts. **Port 8080 is a regular HTTP-only proxy, and also hosts PAC/WPAD file (just as before). By default, Proxy Automatic Configuration file configures client to this port for HTTP.**
- Port Number can be changed via `webone.conf/[Server]/Port` or `webone.conf/[Server]/HttpPort`.
- The secondary port, **8081**, is the new HTTP(S) Proxy server. It supports work as **HTTP Proxy, Secure Proxy (only for HTTPS), FTP Proxy**, and also hosts PAC file (same as on 8080) and other WebOne stuff like Retro Online Video Player.
- Port Number can be changed via `webone.conf/[Server]/HttpsPort`. Cannot be same as HttpPort in this Beta version.

Later WebOne will return to single-port mode.
**If you have problems, first try to set `UseMsHttpApi=enable` in webone.conf file.** This will temporarily disable new HTTP server code and enable old. And please report to author.

## Browser configurations

|Protocol|Old |New |Automatic|
|--------|----|----|---------|
|HTTP |8080|8081|8080 |
|HTTPS |x |8081|8081 |
|FTP |x |8081|8081 |
|GOPHER |x |x |x |
|WAIS |x |x |x |
|NEWS |x |x |x |
|POP,SMTP|x |x |x |
|SOCKS |x |x |x |
|Protocol|Old |New |
|--------|----|----|
|HTTP |8080|8080|
|HTTPS |x |8080|
|FTP |x |8080|
|GOPHER |x |x |
|WAIS |x |x |
|NEWS |x |x |
|POP,SMTP|x |x |
|SOCKS |x |x |

The automatic configuration settings are most stable and most fast at this moment. But if you want to test WebOne 0.16 Beta fully, try to set Port 8081 for HTTP too.

## Work with HTTPS

To use HTTPS through WebOne 0.16, you need to install Proxy's Root Certificate (aka Certificate Authority). Go to http://proxy:8080/!ca or http://proxy:8081/!ca, download the file to disk, and import the root (CA) certificate to your certificate store.
To use HTTPS through WebOne 0.16, you need to install Proxy's Root Certificate (aka Certificate Authority). Go to http://proxy:8080/!ca, download the file to disk, and import the root (CA) certificate to your certificate store.

- Mozilla-based browsers use own storage of Authority (root) certificates.
- Firefox: Options -> Network -> Encryption -> View certificates.
- Mozilla SeaMonkey: Preferences -> Privacy & Security -> Manage certificates.
- Netscape Navigator 3, 4 is similar to Mozilla.
- Sometimes just a click to `WebOne CA root certificate` link at status page starts certificate import.
- Netscape Navigator 3, 4 is a bit similar to Mozilla.
- Microsoft Internet Explorer use Windows certificates storage. Double click on downloaded `WebOneCA.crt` file, and install to *Trusted Root Certificate Authorities* store. To remove, use `C:\Windows\system32\certmgr.msc` console.
- Apple Safari and Google Chrome are using the system certificate store.
- On Windows all is identical to MSIE.
Expand Down
2 changes: 1 addition & 1 deletion WebOne.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<TargetFramework>net6.0</TargetFramework>
<Authors>Alexander Tauenis</Authors>
<Version>0.16.0</Version>
<VersionSuffix>-beta2pre</VersionSuffix> <!--<VersionSuffix>-pre</VersionSuffix>-->
<VersionSuffix>-beta2</VersionSuffix> <!--<VersionSuffix>-pre</VersionSuffix>-->
<PackageVersion>$(Version)$(VersionSuffix)</PackageVersion>
<Company>World</Company>
<Product>WebOne HTTP Proxy Server</Product>
Expand Down

0 comments on commit eeb360e

Please sign in to comment.