diff options
author | Nick Mathewson <nickm@torproject.org> | 2019-11-12 12:01:33 -0500 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2019-11-12 12:01:33 -0500 |
commit | 91f377deec9d2d65f8bebe1ac7ea01974b90d376 (patch) | |
tree | 40a66a111497001e23d2634907340302c251ad27 /doc | |
parent | 89396bc72636903d380543c3effe24c7709d750e (diff) | |
download | tor-91f377deec9d2d65f8bebe1ac7ea01974b90d376.tar.gz tor-91f377deec9d2d65f8bebe1ac7ea01974b90d376.zip |
HACKING/design: turn the remaining parts of crypto into a certs doc
Diffstat (limited to 'doc')
-rw-r--r-- | doc/HACKING/design/01d-crypto.md | 27 |
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.) |