ASProxy Configuration

Warning, these configurations are not valid for version 5.2 and later.

Most of the configurations are stored in Web.Config file in appSettings section.

Below are the default configurations:

<appSettings> <add key="WebProxyMode" value="0"/> <add key="WebProxyHost" value="0.0.0.0"/> <add key="WebProxyPort" value="8080"/> <add key="ASProxyLoginNeeded" value="false"/> <add key="ASProxyLoginUser" value="admin"/> <add key="ASProxyLoginPassword" value="admin"/> <add key="ASProxyServerPort" value="8080"/> <add key="ASProxyServerAdminPassword" value=""/> <add key="ErrorLogEnabled" value="false"/> <add key="ASProxyAutoUpdateEnabled" value="false"/> <add key="ASProxyAutoUpdateInfoUrl" value="http://asproxy.sourceforge.net/update/autoupdate.xml"/> </appSettings>

Automatic update:

One of the new features in ASProxy is automatic update which updates the proxy automatically according to your preference.

This feature is disabled by default. To enable it open the "Web.Config" file and locate "ASProxyAutoUpdateEnabled" key in "appSettings" section. Then change its value to "true". That's it!

After enabling this feature, ASProxy will check the URL entered in "ASProxyAutoUpdateInfoUrl" key for update every 3 weeks.
If a new version is available, it will download the update and install the update on itself.

You may have noticed that you can change the update information location in "ASProxyAutoUpdateInfoUrl" key. But remember the entered URL should exist and the information file format should be correct, otherwise the update will fail.

Private proxy:

With this new feature you can disable other people's access to your own proxy site. This is a valuable option for personal sites to get rid of abusers and save the bandwidth. To enable this feature follow these instructions:

Open the "Web.Config" file, and go to "appSettings" section.
Locate "ASProxyLoginNeeded" key, then change its value to "true".
To specify username; locate the "ASProxyLoginUser" key and change its "value" to your desired username.
To specify password; locate the "ASProxyLoginPassword" key and change its "value" to your desired password.

After this setting is enabled any unauthorized user will be redirected to login.aspx page. If the username and the password match they will have access to ASProxy.

Access the Web through network proxy:

In some network structures the web server is behind a proxy server and the web server cannot access to the internet directly. The web application needs to be configured to access the web.

ASProxy needs some configurations to pass the network proxy:

Open the "Web.Config" file and locate "WebProxyMode" key in "appSettings" section. The value may be set to one of these:

0 : means that this configuration is disabled and the application can connect to internet directly. For security reasons this is default option.
1 : means that ASProxy can detect the configurations automatically.
3 : means that the custom values will be used. To enter the custom values enter the network proxy IP in "WebProxyHost" key and enter its port in "WebProxyPort" key.

Error log:

This feature is only for developers. If any unhandled error occurs in application execution the error details will be logged in a new file named "exceptions.xml" in "bin" folder.

To enable this feature, open the "Web.Config" file and locate "ErrorLogEnabled" key in "appSettings" section and change its value to "true".

ASProxyServer Configuration

ASProxyServer is another type of proxies introduced with ASProxy. A version of ASProxy presented as IP Proxy. Here are the setup and configuration instructions:

In ASProxyServer package the ServerConfig.aspx is included. Open this page on your browser (for example: proxy.mysite.com/ServerConfig.aspx). Enter the administration password (specified in "web.config" file in "ASProxyServerAdminPassword" key) in "Admin password" field. Specify your desired port address and then click on "Start proxy" button. The proxy will start to work and the state will change to "Listening".

To access the created proxy follow these configurations in your browser but remember the IP address is the address that hosts ASProxy. (For example mysite.com which its IP is something like 156.25.16.69)

For "Internet Explorer": Open the "Internet Options" in "Control Panel". Go to the "Connections" tab and click the "LAN Settings" button. In "Proxy Server" group, check the "User a proxy server for your LAN" check box and enter the IP address in "Address" field and the port number in "Port" field. Then OK everything!

For "FireFox": Select "Options" from "Tools" menu and go to "Advanced" section. Go to "Network" tab and click on the "Settings" button on the "Connections" group. Check the "Manual proxy configuration" radio button. Enter the IP address in "HTTP Proxy" field and the port number in "Port" field. And check the "Use this proxy for all protocols" check box. Then OK everything!

Note: Do these configurations when you are online. These options may cause some problems when you are offline. To disable them in "IE" uncheck the "User a proxy server for your LAN" and in "FireFox" select "Direct connection to internet" radio button.

Important note: "Application Pool" of ASProxy should have "System" identity to work correctly. The default value is "Network". You can access this option in IIS 6. The ASProxyServer installer will do this for you if installation is done successfully.
If you do not have enough information about IIS 6, do not change the configurations.