[metrics-bugs] #34231 [Metrics/Onionperf]: Document and maybe improve how we're mapping TGen transfers to Tor streams/circuits

[Tor Bug Tracker & Wiki]

#34231: Document and maybe improve how we're mapping TGen transfers to Tor
streams/circuits
-------------------------------+--------------------------------
 Reporter:  karsten            |          Owner:  metrics-team
     Type:  enhancement        |         Status:  new
 Priority:  Medium             |      Milestone:
Component:  Metrics/Onionperf  |        Version:
 Severity:  Normal             |     Resolution:
 Keywords:                     |  Actual Points:
Parent ID:  #33328             |         Points:
 Reviewer:                     |        Sponsor:  Sponsor59-must
-------------------------------+--------------------------------

Comment (by dennis.jackson):

 I have a need for similar functionality, with a slightly different twist.
 I would like to associate web requests from the Tor Browser with
 particular circuits. So the mapping would be User Action -> HTTP Request
 -> SOCKS Username/Password for Stream Isolation -> A Circuit.

 As far as I understand TorButton uses this exact functionality internally
 so as to display it to the user, however, I haven't looked into it in
 enough detail to see if it is robust:

 https://gitweb.torproject.org/torbutton.git/tree/chrome/content/tor-
 circuit-display.js#n45

 https://gitweb.torproject.org/torbutton.git/tree/components/domain-
 isolator.js#n124

 In particular, the following comment is informative:
 {{{
 // Watches for STREAM SENTCONNECT events. When a SENTCONNECT event occurs,
 then
 // we assume isolation settings (SOCKS username+password) are now fixed
 for the
 // corresponding circuit. Whenever the first stream on a new circuit is
 seen,
 // looks up u+p and records the node data in the credentialsToNodeDataMap.
 // We need to update the circuit display immediately after any new node
 data
 // is received. So the `updateUI` callback will be called at that point.
 // See https://trac.torproject.org/projects/tor/ticket/15493
 }}}

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/34231#comment:3>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online