Proxy Support

On some computer networks, you might need a Proxy Server to access the internet.

In these cases, you'll need to do some additional setup to make Resonite work with your Proxy Server. You can follow this page to get that setup.

Creating a Startup Config File

Proxy support is configured via a Startup Config File. So if you don't have one of those, create it in the same folder as Resonite's main executable (Resonite.exe).

By default, the config file should be named Config.json.

Adding the Proxy Configuration Section

Within the Config.json file. You'll need to add the following:

{
    "proxy": {

    }
}

Proxy Configuration Options

The Proxy section, contains your proxy configuration. Depending on your setup, you'll need a number of properties:

Property	Description	Example
autoDetect	Set this to true, to tell Resonite to try and automatically detect the proxy configuration.	true
address	Allows you to specify the web address where Resonite can find your Proxy. Include the Url and Port	127.0.0.1:8080
localBypass	When set to true, will bypass the Proxy for local domains such as localhost, 127.0.0.1	true
credentialStore	The Credential mode for the proxy. There are a number of options.	See #Authentication
username	Username for the proxy, only used when credentialStore is set to "UsernamePassword"	See #Authentication
password	Password for the proxy, only used when credentialStore is set to "UsernamePassword"	See #Authentication

Authentication

To setup authentication you need to configure the credentialStore property to an appropriate value for your authentication needs, pick one of the following values:

• "UsernamePassword" - Allows you to manually specify a Username and Password for the proxy, specify the username and password with the username and password properties that are described above.
• "NetworkCache" - Retrieves the credentials from the NetworkCache. TODO: Prime has no idea what the NetworkCache is.
• "Kerberos" - Retrieves the credentials from Kerberos. TODO: Prime has no idea what kerberos is.
• "DefaultSystemCache" - Retrieves the credentials from the Default System Cache.

Examples

A basic proxy

{
    "proxy": {
        "address": "127.0.0.1:8080"
    }
}

A basic proxy, with Username and Password Authentication

{
    "proxy": {
        "address": "127.0.0.1:8080",
        "credentialStore": "UsernamePassword",
        "username": "ProbablePrime",
        "password": "Cheese"
    }
}

Troubleshooting

SkyFrost WebProxy test failed

If when starting up Resonite you see a message stating that the "SkyFrost WebProxy test failed", then it means that Resonite tested the proxy you have configured and that this test failed.

Additionally, if your proxy configuration is required then Resonite will have crashed.

You can resolve this in a number of ways:

1. Validate your Proxy Configuration, the rest of this page provides information on all of the options.
   • You may need to contact your systems administrator for assistance.
2. Disable or clear your proxy configuration by removing it from your Startup Config File
3. Set the "required" property to false, which will enable Resonite to continue running even when this test fails.