Quickstart

​

Connecting

1. After you request SGS service in a region, Salad will provision and test a new, dedicated SGS server before sending you its connection details, which will include a unique SGS hostname, port number, password, and other basic information.

   Note that this documentation assumes you are using HTTP CONNECT requests. SGS also supports HAProxy’s PROXY v2 protocol. Learn how to use it here.

2. All requests should be made through the SGS server using this connection information. The SGS server will then route them to the appropriate Salad node. For example, https://SESSIONID:PASSWORD@HOSTNAME:PORT/

   • Let’s break down each component: SESSIONID, PASSWORD, HOSTNAME, and PORT.
     • SESSIONID can be anything you like, as a string encoded in ASCII or UTF8. There are no character length limits enforced. Each session ID will be associated with one salad node. Because all requests sent through a single session ID will be proxied through the same node, we recommend using separate session IDs for each of your end users. If a Salad node goes offline for any reason, all connections that it was servicing will be automatically distributed to one or more nodes using a modified least connections algorithm.
     • PASSWORD is the password for connecting to SGS. It will be shared with you using a 1Password link before beginning the trial period.
     • HOSTNAME is the hostname of the SGS server. It is typically in the format sgs-{unique_string}.salad.com, and will be shared with you before beginning the trial period.
     • PORT is the port of the SGS server you should connect to. It will be shared with you before beginning the trial period.
       Proxy authentication with the SGS server MUST be made using TLS (https endpoint). In addition, requests can only be made to destination addresses using HTTPS.

3. Using curl, you can check the IP address and region of a node connected to one of your SGS servers:

curl -x 'https://session123:PASSWORD@sgs-NAME.salad.com:PORT' https://www.ipinfo.io