Add bison trails nginx config (#56)

* Add bison trails nginx proxy config

* Update https for rpc providers with Bison Trails

Author: SEJeff

doc/https-for-rpc-providers.md

@@ -12,6 +12,8 @@ This lack will be remedied in a future release but in order to address the probl
 | 7901 | Figment | HTTP RPC and websocket |
 | 7802 | TritonOne | websocket only |
 | 7902 | TritonOne | HTTP RPC and websocket |
+| 7803 | BisonTrails | websocket only |
+| 7903 | BisonTrails | HTTP RPC and websocket |
 
 ## Running `nginx` as a standalone, unprivileged process
 

doc/nginx-configs/bison-trails-virt-server-config.conf

@@ -0,0 +1,83 @@
+#
+# Bison Trails configuration snippet
+#
+# Can be included directly in /etc/nginx/sites-available/ (Debian based distros)
+# or /etc/nginx/conf.d/ (Red Hat based distros)
+#
+# Bison Trails currently only supports http basic authentication. To
+# get the basic auth digest, you need to use the base64 encoded version
+# of USERNAME:PASSWORD.
+#
+# From a linux machine, you can do this replacing USERNAME and PASSWORD
+# with the credentials from the bison trails QT "API Access" tab:
+#
+#    echo USERNAME:PASSWORD | base64 -w0
+#
+# Use the base64 encoded value for REPLACE_ME_WITH_YOUR_AUTH_TOKEN.
+#
+# YOUR_SERVER and REPLACE_ME_WITH_YOUR_AUTH_TOKEN should be replaced with the
+# appropriate values for your organization
+#
+
+# Bison Trails RPC & websocket with auth
+server {
+    listen 7903;
+
+    # Remove "https://" and any trailing slash e.g. 977c2599-63f9-4c6b-9eed-49dada416a3f.solana.bison.run
+    set $upstream_host YOUR_SERVER;
+    set $basic_auth_digest REPLACE_ME_WITH_YOUR_AUTH_TOKEN;
+
+    location / {
+        try_files /nonexistent-used-for-try-testing @$http_upgrade;
+    }
+
+    location @websocket {
+        proxy_pass https://$upstream_host/ws$request_uri;
+        proxy_http_version 1.1;
+        proxy_set_header Host $proxy_host;
+        # websocket requirements
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "Upgrade";
+        # Bison Trails specific authentication requirement
+        proxy_set_header Authorization "Basic $basic_auth_digest";
+        proxy_redirect https://$proxy_host http://$server_name:$server_port;
+        proxy_redirect https:// http://;
+    }
+
+    location @ {
+        proxy_pass https://$upstream_host/rpc$request_uri;
+        proxy_http_version 1.1;
+        proxy_set_header Host $proxy_host;
+        proxy_set_header Connection "";
+        # Bison Trails specific authentication requirement
+        proxy_set_header Authorization "Basic $basic_auth_digest";
+        proxy_redirect https://$proxy_host http://$server_name:$server_port;
+        proxy_redirect https:// http://;
+    }
+}
+
+#
+# This is a separate port for handling only websocket connections that some developers
+# have found greatly eases debugging.  It provides the same functionality as the first
+# location stanza in the virtual server above.
+#
+
+server {
+    listen 7803;
+
+    set $upstream_host YOUR_SERVER;
+    set $basic_auth_digest REPLACE_ME_WITH_YOUR_AUTH_TOKEN;
+
+    location / {
+        proxy_pass https://$upstream_host/ws$request_uri;
+        proxy_http_version 1.1;
+        proxy_set_header Host $proxy_host;
+        # websocket requirements
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "Upgrade";
+        # Bison Trails specific authentication requirement
+        proxy_set_header Authorization "Basic $basic_auth_digest";
+        proxy_redirect https://$proxy_host http://$server_name:$server_port;
+        proxy_redirect https:// http://;
+    }
+}