{{Header}} {{#seo: |description=Ever wanted to know which information is sent by an application? tor-ctrl-observer shows connection information of applications using Tor. |image=TorControl12312.png }} {{Title|title= tor-ctrl-observer - Tor Connection Destination Viewer }} [[File:TorControl12312.png|thumb]] {{intro| Ever wanted to know which information is sent by an application? tor-ctrl-observer shows connection information of applications using Tor. }} __FORCETOC__ = What tor-ctrl-observer is = Ever wanted to know which information is sent by an application? tor-ctrl-observer shows connection information of applications using Tor. Sample printout:
250-stream-status=1094 SENTCONNECT 20 firefox.settings.services.mozilla.com:443
250-stream-status=1094 SUCCEEDED 20 18.64.79.82:443
tor-ctrl-observer is especially useful in combination with {{project_name_long}} because:
{{TorifiedGateway}} tor-ctrl-observer operates in sane, secure way by using Tor's control protocol to make information visible to users that Tor is internally processing and ready to share with users on request anyhow. = tor-ctrl-observer Advantages = * application level leak testing: tor-ctrl-observer can be used to observe application's network connections. ** For example, issue [https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/40788 Tor Browser 11.0.4-11.0.6 phoning home] (which is a regression of [https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/31575 Firefox is phoning home during start-up in Tor Browser based on ESR 68]) has been identified and bug reported to The Tor Project by tor-ctrl-observer developer [https://github.com/nyxnor nyxnor]. = Usage = In {{project_name_gateway_long}}. '''1.''' Open a terminal. '''2.''' Run tor-ctrl-observer. {{CodeSelect|code= tor-ctrl-observer }} '''3.''' Terminate tor-ctrl-observer with signal sigint. Press keyboard keys Ctrl + C. = What tor-ctrl-observer is not = tor-ctrl-observer does not attempt to be, is not and cannot be a: * Network level [[Dev/Leak Tests|leak tests]] replacement: In illustrative language, this is because tor-ctrl-observer does only nicely ask Tor "please show me all the connections you are creating". It is then up to Tor to honor the request. Tor might generally do so but if there were bugs in the Tor control protocol then tor-ctrl-observer could not catch these. If connections are by-passing Tor, in other words not using Tor then Tor is obviously not aware of these connections and therefore tor-ctrl-observer cannot observe such connections. * Tor auditor: For the same reason as above, tor-ctrl-observer cannot be expected to find bugs in Tor. * [[Tor Controller]]: Such as [[Nyx]]. What is the difference between nyx and tor-ctrl-observer? nyx shows information about which Tor circuits ([[Bridges]], [[Tor Entry Guards]], [[Tor]] middle or exit relays) are used but not the final connection destinations. On the other hand, tor-ctrl-observer shows information about final connection destinations. = Forum Discussion = https://forums.whonix.org/t/tor-ctrl-tor-control-port-command-line-tool/8074/41 = See Also= * [[Tor Controller]] = Footnotes = {{reflist|close=1}} {{Footer}} [[Category:Documentation]]