Difference between revisions of "ConfigOption/node uri"

From Snowblossom Wiki
Jump to: navigation, search
(Created page with "==node_uri== Controls which SnowBlossomNode this program connects to. General form is: schema://host[:port][/?key=node:...] If using grpc+tls, the key parameter specifi...")
 
 
(6 intermediate revisions by the same user not shown)
Line 6: Line 6:
  
 
If using grpc+tls, the key parameter specifies which TLS key the node is expected to use.
 
If using grpc+tls, the key parameter specifies which TLS key the node is expected to use.
 +
 +
For best security and privacy it is best to use grpc+tls and specify the key.
 +
If you don't know the key for a particular server, connect without the key and look for a log entry like this:
 +
 +
<code>
 +
    INFO: Connected to TLS server with key: node:fse8tvly48zwz9fej6x5znsrm573pyyf83uj9kxw
 +
</code>
 +
 +
Normal URI parsing applies.
 +
 +
It can also be a comma separated list of multiple URIs, in which case the first to reply will be used.
 +
  
  
Line 12: Line 24:
 
===Examples===
 
===Examples===
 
<code>
 
<code>
 +
 
node_uri=grpc://snow-tx1.snowblossom.org
 
node_uri=grpc://snow-tx1.snowblossom.org
 +
 
node_uri=grpc://snow-tx1.snowblossom.org:2338
 
node_uri=grpc://snow-tx1.snowblossom.org:2338
 +
 
node_uri=grpc+tls://snow-tx1.snowblossom.org
 
node_uri=grpc+tls://snow-tx1.snowblossom.org
 +
 
node_uri=grpc+tls://snow-tx1.snowblossom.org?key=node:fgmfupck7seaq8t2gl6plzs5vh7nyl6656wscgq3
 
node_uri=grpc+tls://snow-tx1.snowblossom.org?key=node:fgmfupck7seaq8t2gl6plzs5vh7nyl6656wscgq3
 +
 +
node_uri=grpc+tls://snow-tx1.snowblossom.org,grpc+tls://snow-de1.snowblossom.org
  
 
</code>
 
</code>
Line 25: Line 43:
 
[[Category:ConfigOptionsShackletonExplorer]]
 
[[Category:ConfigOptionsShackletonExplorer]]
 
[[Category:ConfigOptionsClient]]
 
[[Category:ConfigOptionsClient]]
 +
[[Category:ConfigOptionsChannelNode]]

Latest revision as of 21:58, 27 November 2019

node_uri

Controls which SnowBlossomNode this program connects to.

General form is: schema://host[:port][/?key=node:...]

If using grpc+tls, the key parameter specifies which TLS key the node is expected to use.

For best security and privacy it is best to use grpc+tls and specify the key. If you don't know the key for a particular server, connect without the key and look for a log entry like this:

   INFO: Connected to TLS server with key: node:fse8tvly48zwz9fej6x5znsrm573pyyf83uj9kxw

Normal URI parsing applies.

It can also be a comma separated list of multiple URIs, in which case the first to reply will be used.


Default

None

Examples

node_uri=grpc://snow-tx1.snowblossom.org

node_uri=grpc://snow-tx1.snowblossom.org:2338

node_uri=grpc+tls://snow-tx1.snowblossom.org

node_uri=grpc+tls://snow-tx1.snowblossom.org?key=node:fgmfupck7seaq8t2gl6plzs5vh7nyl6656wscgq3

node_uri=grpc+tls://snow-tx1.snowblossom.org,grpc+tls://snow-de1.snowblossom.org