Opened 4 years ago

Closed 4 years ago

#15009 closed enhancement (fixed)

New @type for hidden service descriptors

Reported by: atagar Owned by:
Priority: Very Low Milestone:
Component: Metrics/Website Version:
Severity: Keywords:
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


Hi Karsten, as per #15004 I'm adding the ability to parse hidden service descriptors to Stem. I know this isn't of interest to Metrics right now but I'd like for us to add a new @type annotation for these documents.

This is a bit similar to #8365 for which you made commit bba6809. I'm thinking "@type hidden-service-descriptor 1.0" - thoughts?

Child Tickets

Change History (7)

comment:1 Changed 4 years ago by karsten

Sure, I can imagine adding that @type on CollecTor's formats page. Mind writing a short paragraph with a short description what these descriptors are, which entities publish them, that they're not collected by CollecTor but that they can be obtained from a local tor process, that they can be processed using libraries that also support processing the other descriptors listed on the formats page, and whatever else you think should be written there? Thanks!

comment:2 Changed 4 years ago by atagar

Can do... ish. Here's the description I used in Stem's pydocs...

Parsing for Tor hidden service descriptors as described in Tor's `rend-spec

Unlike other descriptor types these describe a hidden service rather than a
relay. They're created by the service, and can only be fetched via relays with
the HSDir flag.

# TODO: Add a description for how to retrieve them when tor supports that (#14847).

Trouble is that TODO. Tor hasn't yet merged a controller method for getting these. :)

comment:3 Changed 4 years ago by karsten

Status: newneeds_information

Can you ping me once #14847 is implemented?

comment:4 Changed 4 years ago by atagar

Will do.

comment:5 Changed 4 years ago by karsten

How about we add the following text to after Tor bridge descriptors?

Tor hidden service descriptors

Tor hidden services make it possible for users to hide their locations while offering various kinds of services, such as web publishing or an instant messaging server. A hidden service assembles a hidden service descriptor to make its service available in the network. This descriptor gets stored on hidden service directories and can be retrieved by hidden service clients. Hidden service descriptors are not formally archived, but some libraries support parsing these descriptors when obtaining them from a locally running Tor instance.

Hidden service descriptors @type hidden-service-descriptor 1.0

Hidden service descriptors contain all details that are necessary for clients to connect to a hidden service. Despite the version number being 1.0, these descriptors are part of the version 2 hidden service protocol.

comment:6 Changed 4 years ago by atagar

Looks great to me!

comment:7 Changed 4 years ago by karsten

Resolution: fixed
Status: needs_informationclosed

Great, merged. Closing.

Note: See TracTickets for help on using tickets.