Skip to main content

How to configure Dashboard Server to use a proxy

Documentation Team
  • Updated

How to configure Dashboard Server to use a proxy

If you use a proxy server you may get an error when activating Dashboard Server or configuring an OAuth Web API provider.

This provider has not been authorized (or there is an error with its configuration)

You need to configure Dashboard Server to use the proxy, as described below. This will configure Dashboard Server to use the proxy settings from Internet Explorer. For more information see the defaultProxy element article from Microsoft.

 

Adding a proxy to the web.config

You will need to connect to your SquaredUp server (How to connect to your SquaredUp server).

  2. Find the web.config file located in the Dashboard Server folder.

    Name of the Dashboard Server folder

    The name of the Dashboard Server folder is SquaredUpv followed by the product version number.

    Location of the Dashboard Server folder

    If you deployed Dashboard Server via the Azure or AWS Marketplace:

    The default location for the Dashboard Server folder is F:\SquaredUpv[Version Number].
    For example, for Dashboard Server Community Edition v5 the default location is F:\SquaredUpv5.

    If you installed Dashboard Server using the installer:

    The default location for the Dashboard Server folder is C:\inetpub\wwwroot\SquaredUpv[Version Number], but a custom location may have been chosen during the installation.
    For example, for Dashboard Server v5 the default folder location is C:\inetpub\wwwroot\SquaredUpv5

  3. Create a backup of the web.config file by copy and pasting the file to a different location.

  4. Open the original web.config file with Notepad.

  5. Add the following XML snippet under the <configuration> section of the web.config file:

    Copy
    <system.net>
     <defaultProxy enabled="true"useDefaultCredentials="true">
       <proxy usesystemdefault="true" />
     </defaultProxy>
    </system.net>
  6. If your proxy uses Active Directory for authentication, the responsible team will need to give your Dashboard Server application pool user(s) access. For more information about identifying the Dashboard Server application pool identity for each of your SquaredUp servers see How to check and modify the application pool identity.