June 2019 - tor-commits - lists.torproject.org

[tor-browser-build/master] Bug 30863: Fix tor-android-service and tor-onion-proxy-library filenames
by gk＠torproject.org 26 Jun '19

26 Jun '19

commit a27f6be9a921119cb5e7869da9b891c359651bda Author: Nicolas Vigier <boklm(a)torproject.org> Date: Wed Jun 12 12:03:54 2019 +0200 Bug 30863: Fix tor-android-service and tor-onion-proxy-library filenames --- projects/tor-android-service/config | 2 +- projects/tor-onion-proxy-library/config | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/projects/tor-android-service/config b/projects/tor-android-service/config index 2290c6e..ec0d4b0 100644 --- a/projects/tor-android-service/config +++ b/projects/tor-android-service/config @@ -1,6 +1,6 @@ # vim: filetype=yaml sw=2 version: '[% c("abbrev") %]' -filename: '[% project %]-[% c("version") %]-[% c("var/build_id") %].tar.gz' +filename: '[% project %]-[% c("version") %]-[% c("var/build_id") %]' git_hash: d9b049c8cee225b4e7bb6f0191093f543d0f9f65 git_url: https://git.torproject.org/tor-android-service.git git_submodule: 1 diff --git a/projects/tor-onion-proxy-library/config b/projects/tor-onion-proxy-library/config index 9db33bd..0f24402 100644 --- a/projects/tor-onion-proxy-library/config +++ b/projects/tor-onion-proxy-library/config @@ -1,6 +1,6 @@ # vim: filetype=yaml sw=2 version: '[% c("abbrev") %]' -filename: '[% project %]-[% c("version") %]-[% c("var/build_id") %].tar.gz' +filename: '[% project %]-[% c("version") %]-[% c("var/build_id") %]' git_hash: 27df20a5cb107a009db009df4aaef000a6e78e2e git_url: https://github.com/sisbell/Tor_Onion_Proxy_Library.git git_submodule: 1

1 0

[tor-browser-build/master] Merge remote-tracking branch 'boklm/bug_30863'
by gk＠torproject.org 26 Jun '19

26 Jun '19

commit b4414487740039152a8fa62dde5d8ea13aa34cb2 Merge: 343b8bc a27f6be Author: Georg Koppen <gk(a)torproject.org> Date: Wed Jun 26 12:18:28 2019 +0000 Merge remote-tracking branch 'boklm/bug_30863' projects/tor-android-service/config | 2 +- projects/tor-onion-proxy-library/config | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-)

1 0

[tpo/master] Remove 9.0a1 and 9.0a2 from RecommendedTBBVersions
by boklm＠torproject.org 26 Jun '19

26 Jun '19

commit 2be2e6e58c5df31ba58a49e1116d0ae0495f36b5 Author: Nicolas Vigier <boklm(a)torproject.org> Date: Wed Jun 26 11:59:42 2019 +0200 Remove 9.0a1 and 9.0a2 from RecommendedTBBVersions --- content/projects/torbrowser/RecommendedTBBVersions/contents.lr | 8 -------- 1 file changed, 8 deletions(-) diff --git a/content/projects/torbrowser/RecommendedTBBVersions/contents.lr b/content/projects/torbrowser/RecommendedTBBVersions/contents.lr index cec4405..1495cd3 100644 --- a/content/projects/torbrowser/RecommendedTBBVersions/contents.lr +++ b/content/projects/torbrowser/RecommendedTBBVersions/contents.lr @@ -9,14 +9,6 @@ body: "8.5.3-MacOS", "8.5.3-Linux", "8.5.3-Windows", -"9.0a1", -"9.0a1-MacOS", -"9.0a1-Linux", -"9.0a1-Windows", -"9.0a2", -"9.0a2-MacOS", -"9.0a2-Linux", -"9.0a2-Windows", "9.0a3", "9.0a3-MacOS", "9.0a3-Linux",

1 0

[research-web/staging] Creates a research tools page
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 5ae2fde9908f5d880b497d0297f13856141d6ae8 Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Thu May 2 20:55:53 2019 +0100 Creates a research tools page Fixes: #29560 --- config.toml | 10 +++++++-- content/tools.md | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 73 insertions(+), 2 deletions(-) diff --git a/config.toml b/config.toml index eca81cf..3aa7979 100644 --- a/config.toml +++ b/config.toml @@ -22,12 +22,18 @@ theme = "torproject" weight = -180 [[menu.main]] - name = "Research Ideas" - title = "Research Ideas with Tor" + name = "Ideas" + title = "Tor Research Ideas" url = "/ideas" weight = -170 [[menu.main]] + name = "Tools" + title = "Tor Research Tools" + url = "/tools" + weight = -165 + +[[menu.main]] name = "Tech Reports" title = "Tor Project Technical Reports" url = "/techreports" diff --git a/content/tools.md b/content/tools.md new file mode 100644 index 0000000..90dc5bc --- /dev/null +++ b/content/tools.md @@ -0,0 +1,65 @@ +--- +title: Research Tools +--- + +If you're interested in performing research relating to Tor, you might find +the following tools useful. Always ensure that the research you are performing +is [safe](/safetyboard). + +## Test Networks + +New design proposals and attacks on Tor are challenging to test in the live +network due to deployment issues and the risk of invading users’ privacy. The +following tools allow you to easily run a test Tor network, isolated from the +live public network, that you can safely perform experimentation on. + +* [Chutney](https://trac.torproject.org/projects/tor/wiki/doc/TorChutneyGuide) + is a Tor test network configuration tool that can launch Tor processes and + estabilsh connectivity between them. It can also be used for CPU-limited + bandwidth testing. +* [Shadow](https://shadow.github.io/) is a network simulator/emulator hybrid + that uses archived Tor directory data to generate realistic network + topologies. + +You might also choose to build a testing network manually, or using your +preferred configuration management tool. See the [testing network +options](https://manpages.debian.org/stretch/tor/torrc.5.en.html#TESTING_NETWORK_OPTIONS) +of the tor configuration file for more details. + +## Path Selection + +The relays chosen for a path through the Tor network require tradeoffs to be +made between anonymity, performance, and other properties. + +* [TorPS](https://torps.github.io/) simulates changes to Tor's path selection + algorithm using archived data. + +## Controllers + +A controller allows applications to interact with Tor. This happens via the +[Tor Control Protocol](https://spec.torproject.org/control-spec). Various +events such as circuit creation and bandwidth counts will be able to be read +from the Tor process. Commands can also be given to change the configuration of +the Tor process or to instruct it to perform tasks. + +* [Stem](https://stem.torproject.org/) is a Python controller library for Tor, + used in the [Nyx](https://nyx.torproject.org/) monitor application. +* [jtorctl](https://github.com/guardianproject/jtorctl) is a Java controller + library for Tor, used in the + [Orbot](https://play.google.com/store/apps/details?id=org.torproject.android) + Android app. + +## Parsing Libraries + +The following libraries help you with parsing Tor network data, either from a +directory authority or the +[CollecTor](https://metrics.torproject.org/collector.html) service: + +* [Tor Metrics Library](https://metrics.torproject.org/metrics-lib.html) is a + Java library, used by [Tor Metrics](https://metrics.torproject.org/) to + produce analysis and visualisations, including parsers for Tor-specific data + formats. +* [Stem](https://stem.torproject.org/) is a Python library that includes + parsers for Tor-specific data formats. +* [Zoossh](https://github.com/NullHypothesis/zoossh) is a parser written in Go + for Tor-specific data formats.

1 0

[research-web/staging] tools: Add add your tool
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 823c897d24c28eecda108ad0e26b85dda9288c8c Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Thu May 16 13:59:56 2019 +0100 tools: Add add your tool --- content/tools.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/content/tools.md b/content/tools.md index 5681196..9568cae 100644 --- a/content/tools.md +++ b/content/tools.md @@ -69,3 +69,10 @@ authority, directory cache, local client or the bridges, and onion services. * [Zoossh](https://github.com/NullHypothesis/zoossh) is a parser written in Go for Tor-specific data formats. + +## Add your tool + +If you have developed a tool that may be useful to other researchers working on +Tor, then please send a mail to +[research@torproject.org](mailto:research@torproject.org) with the details you +would like to have added.

1 0

[research-web/staging] tools: Adds leekspin
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 3171502696a1069705dd6975b3e134a2cf54ca51 Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Thu May 16 13:57:30 2019 +0100 tools: Adds leekspin --- content/tools.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/content/tools.md b/content/tools.md index 6a17699..5681196 100644 --- a/content/tools.md +++ b/content/tools.md @@ -51,10 +51,11 @@ the Tor process or to instruct it to perform tasks. [Orbot](https://play.google.com/store/apps/details?id=org.torproject.android) Android app. -## Parsing Libraries +## Descriptor Libraries -The following libraries help you with parsing Tor network data, either from a -directory authority or the +The following libraries help you with parsing and generating Tor network +related data formats. Descriptors may be obtained either from a directory +authority, directory cache, local client or the [CollecTor](https://metrics.torproject.org/collector.html) service: * [Tor Metrics Library](https://metrics.torproject.org/metrics-lib.html) is a @@ -63,5 +64,8 @@ directory authority or the formats. * [Stem](https://stem.torproject.org/) is a Python library that includes parsers for Tor-specific data formats. +* [leekspin](https://github.com/isislovecruft/leekspin) is a tool for + generating mock Onion Router (OR) descriptors such as those used by relays, + bridges, and onion services. * [Zoossh](https://github.com/NullHypothesis/zoossh) is a parser written in Go for Tor-specific data formats.

1 0

[research-web/staging] tools: Adds txtorcon
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit b76b77c8f8268f52706c11f90ec2af5d39c13346 Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Thu May 16 13:57:23 2019 +0100 tools: Adds txtorcon --- content/tools.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/tools.md b/content/tools.md index 90dc5bc..6a17699 100644 --- a/content/tools.md +++ b/content/tools.md @@ -44,6 +44,8 @@ the Tor process or to instruct it to perform tasks. * [Stem](https://stem.torproject.org/) is a Python controller library for Tor, used in the [Nyx](https://nyx.torproject.org/) monitor application. +* [txtorcon](https://github.com/meejah/txtorcon) is a Python Twisted controller + library for Tor. * [jtorctl](https://github.com/guardianproject/jtorctl) is a Java controller library for Tor, used in the [Orbot](https://play.google.com/store/apps/details?id=org.torproject.android)

1 0

[research-web/staging] techreports: Adds DoS Censorship Report 2
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 6464826027212439211807bff50bb64b7cc064a4 Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Wed Jun 26 09:32:50 2019 +0100 techreports: Adds DoS Censorship Report 2 --- content/techreports.html | 12 ++++++++++++ .../techreports/dos-censorship-report2-2019-05-31.pdf | Bin 0 -> 499598 bytes static/techreports_bib.html | 14 +++++++++++++- techreports.bib | 10 ++++++++++ techreports.html | 12 ++++++++++++ 5 files changed, 47 insertions(+), 1 deletion(-) diff --git a/content/techreports.html b/content/techreports.html index 9dad358..da8c9b5 100644 --- a/content/techreports.html +++ b/content/techreports.html @@ -13,6 +13,18 @@ aliases: +<p><a name="tor-2019-05-001"></a> + +Cecylia Bocovich, Roger Dingledine, Alexander Færøy, Kat Hanna, Philipp + Winter, and Taylor Yu. + Addressing denial of service attacks on free and open communication + on the internet: Final report. + Technical Report 2019-05-001, The Tor Project, May 2019. +[ <a href="../techreports_bib.html#tor-2019-05-001">bib</a> | +<a href="https://research.torproject.org/techreports/dos-censorship-report2-2019-05-…">.pdf</a> ] + +</p> + <p><a name="tor-2019-03-001"></a> Iain R. Learmonth and Karsten Loesing. diff --git a/static/techreports/dos-censorship-report2-2019-05-31.pdf b/static/techreports/dos-censorship-report2-2019-05-31.pdf new file mode 100644 index 0000000..7852990 Binary files /dev/null and b/static/techreports/dos-censorship-report2-2019-05-31.pdf differ diff --git a/static/techreports_bib.html b/static/techreports_bib.html index 733709a..b1213e1 100644 --- a/static/techreports_bib.html +++ b/static/techreports_bib.html @@ -1,4 +1,16 @@ -<h1>techreports.bib</h1><a name="tor-2019-03-001"></a><pre> +<h1>techreports.bib</h1><a name="tor-2019-05-001"></a><pre> +@techreport{<a href="techreports.html#tor-2019-05-001">tor-2019-05-001</a>, + author = {Cecylia Bocovich and Roger Dingledine and Alexander F\ae r\o y and Kat Hanna and Philipp Winter and Taylor Yu}, + title = {Addressing Denial of Service Attacks on Free and Open Communication on the Internet: Final Report}, + institution = {The Tor Project}, + number = {2019-05-001}, + year = {2019}, + month = {May}, + url = {https://research.torproject.org/techreports/dos-censorship-report2-2019-05-31.pdf} +} +</pre> + +<a name="tor-2019-03-001"></a><pre> @techreport{<a href="techreports.html#tor-2019-03-001">tor-2019-03-001</a>, author = {Iain R. Learmonth and Karsten Loesing}, title = {{Tor} Metrics Data Collection, Aggregation, and Presentation}, diff --git a/techreports.bib b/techreports.bib index 0f22e01..a69ebac 100644 --- a/techreports.bib +++ b/techreports.bib @@ -1,3 +1,13 @@ +@techreport{tor-2019-05-001, + author = {Cecylia Bocovich and Roger Dingledine and Alexander F\ae r\o y and Kat Hanna and Philipp Winter and Taylor Yu}, + title = {Addressing Denial of Service Attacks on Free and Open Communication on the Internet: Final Report}, + institution = {The Tor Project}, + number = {2019-05-001}, + year = {2019}, + month = {May}, + url = {https://research.torproject.org/techreports/dos-censorship-report2-2019-05-31.pdf}, +} + @techreport{tor-2019-03-001, author = {Iain R. Learmonth and Karsten Loesing}, title = {{Tor} Metrics Data Collection, Aggregation, and Presentation}, diff --git a/techreports.html b/techreports.html index dde8e34..90cee5c 100644 --- a/techreports.html +++ b/techreports.html @@ -7,6 +7,18 @@ +<p><a name="tor-2019-05-001"></a> + +Cecylia Bocovich, Roger Dingledine, Alexander Færøy, Kat Hanna, Philipp + Winter, and Taylor Yu. + Addressing denial of service attacks on free and open communication + on the internet: Final report. + Technical Report 2019-05-001, The Tor Project, May 2019. +[ <a href="techreports_bib.html#tor-2019-05-001">bib</a> | +<a href="https://research.torproject.org/techreports/dos-censorship-report2-2019-05-…">.pdf</a> ] + +</p> + <p><a name="tor-2019-03-001"></a> Iain R. Learmonth and Karsten Loesing.

1 0

[research-web/staging] README: Update about Jenkins
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 50e9e3056a9c23a07cffc3405b5654b639bfcbad Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Wed Jun 26 09:43:07 2019 +0100 README: Update about Jenkins --- README.md | 33 +++++++++++++-------------------- 1 file changed, 13 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 89e1ddf..26c27ff 100644 --- a/README.md +++ b/README.md @@ -16,29 +16,22 @@ Build and serve on localhost make server ``` -Deploy your changes to staging ------------------------------- - -``` -make staging -``` - -Your changes will shortly appear at https://research-staging.torproject.org/. - -Deploy your changes to production ---------------------------------- - -``` -make production -``` - -Your changes will shortly appear at https://research.torproject.org/. - Adding a technical report ------------------------- To add a technical report, place the final PDF to be published in the `static/techreports/` directory. Add an entry to the BibTeX file `techreports.bib`. This change will be made when you next run `make -server|staging|production` or you can perform only the update step by running -the `update-techreports-html` script. +server` or you can perform only the update step by running the +`update-techreports-html` script. + +Deploy your changes to production/staging +----------------------------------------- + +Simply push to git on the master or staging branches, Your changes will shortly +appear at https://research[-staging].torproject.org/. + +The relevant jenkins jobs are: + +https://jenkins.torproject.org/job/hugo-website-research/ +https://jenkins.torproject.org/job/hugo-website-research-install/

1 0

[research-web/master] README: Update about Jenkins
by irl＠torproject.org 26 Jun '19

26 Jun '19

commit 50e9e3056a9c23a07cffc3405b5654b639bfcbad Author: Iain R. Learmonth <irl(a)fsfe.org> Date: Wed Jun 26 09:43:07 2019 +0100 README: Update about Jenkins --- README.md | 33 +++++++++++++-------------------- 1 file changed, 13 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 89e1ddf..26c27ff 100644 --- a/README.md +++ b/README.md @@ -16,29 +16,22 @@ Build and serve on localhost make server ``` -Deploy your changes to staging ------------------------------- - -``` -make staging -``` - -Your changes will shortly appear at https://research-staging.torproject.org/. - -Deploy your changes to production ---------------------------------- - -``` -make production -``` - -Your changes will shortly appear at https://research.torproject.org/. - Adding a technical report ------------------------- To add a technical report, place the final PDF to be published in the `static/techreports/` directory. Add an entry to the BibTeX file `techreports.bib`. This change will be made when you next run `make -server|staging|production` or you can perform only the update step by running -the `update-techreports-html` script. +server` or you can perform only the update step by running the +`update-techreports-html` script. + +Deploy your changes to production/staging +----------------------------------------- + +Simply push to git on the master or staging branches, Your changes will shortly +appear at https://research[-staging].torproject.org/. + +The relevant jenkins jobs are: + +https://jenkins.torproject.org/job/hugo-website-research/ +https://jenkins.torproject.org/job/hugo-website-research-install/

1 0