[tor-bugs] #18329 [Core Tor/Tor]: Let bridges indicate when they don't want BridgeDB to distribute their address

[Tor Bug Tracker & Wiki]

#18329: Let bridges indicate when they don't want BridgeDB to distribute their
address
------------------------------+------------------------------------
 Reporter:  karsten           |          Owner:
     Type:  enhancement       |         Status:  needs_revision
 Priority:  Medium            |      Milestone:  Tor: 0.3.1.x-final
Component:  Core Tor/Tor      |        Version:
 Severity:  Normal            |     Resolution:
 Keywords:  tor-bridge, stem  |  Actual Points:
Parent ID:                    |         Points:  .2 remaining
 Reviewer:  nickm             |        Sponsor:
------------------------------+------------------------------------

Comment (by isis):

 Replying to [comment:30 atagar]:
 > > Damian, does that look okay from Stem's point of view? (Also, does
 this text make enough sense to the type of bridge operator who wants to
 micromanage their bridge?)
 >
 > Hi Isis, looks good except that we should specify what characters future
 methods can consist of. For instance, can future method names have spaces
 in it?

 Ah, good point. I'll specify printable ascii, no whitespace, plus `-` and
 `_`. So `(KeywordChar | _)+` (and we'll optionally lowercase the letters
 input from the torrc).  Does that sound okay?

 > > Each "method" describes how...
 >
 > Use of the word 'each' here confuses me since the field can only appear
 once, and according to this can have only one value on this line.

 You're right, that should be taken out. (I first started writing something
 where the user could specify multiple comma-separated methods, e.g.
 `email,https` would choose email or https, but the logic for this is
 complicated and confusing, so I revised to allow just one "method".)

 Here's the new draft:

 {{{
     "bridge-distribution-request" SP Method NL

         [At most once]

         The "Method" describes how a Bridge address is distributed by
         BridgeDB. Recognized methods are: "none", "any", "https", "email",
         "moat", "hyphae". If set to "none", BridgeDB will avoid
 distributing
         your bridge address. If set to "any", BridgeDB will choose how to
         distribute your bridge address. Choosing any of the other methods
 will
         tell BridgeDB to distribute your bridge via a specific method:

           - "https" specifies distribution via the web interface at
              https://bridges.torproject.org;
           - "email" specifies distribution via the email autoresponder at
             bridges at torproject.org;
           - "moat" specifies distribution via an interactive menu inside
 Tor
             Browser; and
           - "hyphae" specifies distribution via a cryptographically-
 secure,
             invitation-based system.

         Potential future "Method" specifiers must be as follows:
             Method = (KeywordChar | "_") +

         (Default: "any")
 }}}

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