aspera.conf - Websocket configuration

The <server> section of aspera.conf can be used to configure the server to use the Websocket protocol over HTTPS instead of SSH. The ascp client uses HTTPS for Websocket only. However, the Websocket server can be configured to use HTTP as long as a proxy is being used to stop the HTTPS server endpoint.

Configuration methods: These instructions describe how to manually modify aspera.conf. You can also add and edit these parameters that use asconfigurator commands. For more information on using asconfigurator, see User, group, and default configurations. Run the following command to retrieve a complete default aspera.conf file that includes the asconfigurator syntax for each setting:
$ /Library/Aspera/bin/asuserdata -+
  1. Open aspera.conf from the following location:

    /Library/Aspera/etc/aspera.conf

  2. Add or locate the <server> section, as in the following example:
    <server>
        <enable_http>true</enable_http>
        <enable_https>true</enable_https>
        <wss_port>9093</wss_port>
        <wss_enabled>true</wss_enabled>
        <wss_listen_port>9099</wss_listen_port>
    </server>
  3. Edit settings as needed.
    Websocket settings reference
    Field Description Values
    Enable HTTP Enable HTTP true or false
    Enable HTTPS Enable HTTPS true or false
    WSS Port Websocket port 9093
    WSS Enabled Enable Websocket true or false
    WSS Listen Port Listening Port 9099
  4. Save and validate aspera.conf.
    Run the following command to confirm that the XML is correctly formatted and the parameter settings are valid:
    $ /Library/Aspera/bin/asuserdata -v