[tor-bugs] #33233 [Core Tor/Tor]: Prop 312: 3.2.1. Make the Address torrc Option Support IPv6 Literals

[Tor Bug Tracker & Wiki]

#33233: Prop 312: 3.2.1. Make the Address torrc Option Support IPv6 Literals
--------------------------------+--------------------------------
     Reporter:  teor            |      Owner:  teor
         Type:  enhancement     |     Status:  assigned
     Priority:  Medium          |  Milestone:  Tor: 0.4.4.x-final
    Component:  Core Tor/Tor    |    Version:
     Severity:  Normal          |   Keywords:  ipv6, prop312
Actual Points:                  |  Parent ID:  #33049
       Points:  1               |   Reviewer:
      Sponsor:  Sponsor55-must  |
--------------------------------+--------------------------------
 Make relays and bridges use the Address torrc option to find their IPv6
 addresses.

 This ticket covers the IPv6 literal case:

   1. Explicit IP addresses:
      * allow the option to be specified up to two times,
      * use the IPv4 address for IPv4,
      * use the IPv6 address for IPv6.
      Configuring two addresses in the same address family is a config
 error.

   2. Hostnames / DNS names:
      * allow the option to be specified up to two times,
      * look up the configured name,
      * use the first IPv4 and IPv6 address returned by the resolver, and
      Resolving multiple addresses in the same address family is not a
      runtime error, but only the first address from each family will be
      used.

 It is an error to configure an Address option with a private IPv4 or IPv6
 address. (If tor is configured with a custom set of directory authorities,
 private addresses should be allowed, with a notice-level log.)

 See proposal 312, section 3.2.1, case 1:
 https://gitweb.torproject.org/torspec.git/tree/proposals/312-relay-auto-
 ipv6-addr.txt#n252

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