.. _licensing-web-proxy:

Set up a Web Proxy
-------------------

.. _24.2|VOSS-1430|EKB-21301:

:bdg-info-line:`sys-admin`


Web Proxies can be added from the **Web Proxies** menu:

* For licensing:

  If your licensing delivery method configuration includes a destination
  that allows for the selection of a web proxy.

  Add a web proxy to capture its connection details in the partner deployment.

  The web proxy **Name** will be available to select on file transfer destination
  input forms that have **Web proxy** drop downs, for example **VOSS Cloud Licensing Service**.
* For VOSS Wingman:

  To create a web proxy instance to be used in the **Wingman Web Proxy** 
  setting available to ``sysadmin`` users (default menus, **Administration Menu > Settings**),
  thereby allowing VOSS Wingman to function in environments that access the internet via an HTTP proxy.
  The web proxy **Name** will be available to select in the **Wingman Web Proxy** dropdown.

  .. note::

     The Web protocol setting must be ``https``.

  .. raw:: html

     Refer to <a href="data-settings.html#wingman-web-proxy">Wingman Web Proxy</a>

  .. raw:: latex

     Refer to the "Wingman Web Proxy" section of the Settings topic in the Core Feature Guide.

  .. note::

     Ensure that the web proxy is created at a hierarchy level that is at or above the required level.
     This is necessary for the proxy to be available for requests. For example, if the proxy is created
     at a specific customer hierarchy level below a provider, it will not be available for another customer
     hierarchy that is also below the same provider.



1. From the menu, add an instance and complete the necessary fields:

   * Name
   * Web protocol (http/https)
   * Proxy protocol (http)
   * Proxy address
   * Proxy port
   * Username
   * Password
2. Click **Save**.