Difference between revisions of "ConfigOption/node uri"
(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