proposals/120-shutdown-descriptors.txt

   1 Filename: 120-shutdown-descriptors.txt
   2 Title: Shutdown descriptors when Tor servers stop
   3 Author: Roger Dingledine
   4 Created: 15-Aug-2007
   5 Status: Dead
   6
   7 [Proposal dead as of 11 Jul 2008. The point of this proposal was to give
   8 routers a good way to get out of the networkstatus early, but proposal
   9 138 (already implemented) has achieved this.]
  10
  11 Overview:
  12
  13   Tor servers should publish a last descriptor whenever they shut down,
  14   to let others know that they are no longer offering service.
  15
  16 The Problem:
  17
  18   The main reason for this is in reaction to Internet services that want
  19   to treat connections from the Tor network differently. Right now,
  20   if a user experiments with turning on the "relay" functionality, he
  21   is punished by being locked out of some websites, some IRC networks,
  22   etc --- and this lockout persists for several days even after he turns
  23   the server off.
  24
  25 Design:
  26
  27   During the "slow shutdown" period if exiting, or shortly after the
  28   user sets his ORPort back to 0 if not exiting, Tor should publish a
  29   final descriptor with the following characteristics:
  30
  31   1) Exit policy is listed as "reject *:*"
  32   2) It includes a new entry called "opt shutdown 1"
  33
  34   The first step is so current blacklists will no longer list this node
  35   as exiting to whatever the service is.
  36
  37   The second step is so directory authorities can avoid wasting time
  38   doing reachability testing. Authorities should automatically not list
  39   as Running any router whose latest descriptor says it shut down.
  40
  41   [I originally had in mind a third step --- Advertised bandwidth capacity
  42   is listed as "0" --- so current Tor clients will skip over this node
  43   when building most circuits. But since clients won't fetch descriptors
  44   from nodes not listed as Running, this step seems pointless. -RD]
  45
  46 Spec:
  47
  48   TBD but should be pretty straightforward.
  49
  50 Security issues:
  51
  52   Now external people can learn exactly when a node stopped offering
  53   relay service. How bad is this? I can see a few minor attacks based
  54   on this knowledge, but on the other hand as it is we don't really take
  55   any steps to keep this information secret.
  56
  57 Overhead issues:
  58
  59   We are creating more descriptors that want to be remembered. However,
  60   since the router won't be marked as Running, ordinary clients won't
  61   fetch the shutdown descriptors. Caches will, though. I hope this is ok.
  62
  63 Implementation:
  64
  65   To make things easy, we should publish the shutdown descriptor only
  66   on controlled shutdown (SIGINT as opposed to SIGTERM). That would
  67   leave enough time for publishing that we probably wouldn't need any
  68   extra synchronization code.
  69
  70   If that turns out to be too unintuitive for users, I could imagine doing
  71   it on SIGTERMs too, and just delaying exit until we had successfully
  72   published to at least one authority, at which point we'd hope that it
  73   propagated from there.
  74
  75 Acknowledgements:
  76
  77   tup suggested this idea.
  78
  79 Comments:
  80
  81   2) Maybe add a rule "Don't do this for hibernation if we expect to wake
  82      up before the next consensus is published"?
  83                                                       - NM 9 Oct 2007