summaryrefslogtreecommitdiff
path: root/doc/HACKING
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2019-11-12 12:01:33 -0500
committerNick Mathewson <nickm@torproject.org>2019-11-12 12:01:33 -0500
commit91f377deec9d2d65f8bebe1ac7ea01974b90d376 (patch)
tree40a66a111497001e23d2634907340302c251ad27 /doc/HACKING
parent89396bc72636903d380543c3effe24c7709d750e (diff)
downloadtor-91f377deec9d2d65f8bebe1ac7ea01974b90d376.tar.gz
tor-91f377deec9d2d65f8bebe1ac7ea01974b90d376.zip
HACKING/design: turn the remaining parts of crypto into a certs doc
Diffstat (limited to 'doc/HACKING')
-rw-r--r--doc/HACKING/design/01d-crypto.md27
1 files changed, 0 insertions, 27 deletions
diff --git a/doc/HACKING/design/01d-crypto.md b/doc/HACKING/design/01d-crypto.md
deleted file mode 100644
index 3e23a07013..0000000000
--- a/doc/HACKING/design/01d-crypto.md
+++ /dev/null
@@ -1,27 +0,0 @@
-
-
-### Certificates ###
-
-We have, alas, several certificate types in Tor.
-
-The tor_x509_cert_t type represents an X.509 certificate. This document
-won't explain X.509 to you -- possibly, no document can. (OTOH, Peter
-Gutmann's "x.509 style guide", though severely dated, does a good job of
-explaining how awful x.509 can be.) Do not introduce any new usages of
-X.509. Right now we only use it in places where TLS forces us to do so.
-
-The authority_cert_t type is used only for directory authority keys. It
-has a medium-term signing key (which the authorities actually keep
-online) signed by a long-term identity key (which the authority operator
-had really better be keeping offline). Don't use it for any new kind of
-certificate.
-
-For new places where you need a certificate, consider tor_cert_t: it
-represents a typed and dated _something_ signed by an Ed25519 key. The
-format is described in tor-spec. Unlike x.509, you can write it on a
-napkin.
-
-(Additionally, the Tor directory design uses a fairly wide variety of
-documents that include keys and which are signed by keys. You can
-consider these documents to be an additional kind of certificate if you
-want.)