Commit graph

400 commits

Author SHA1 Message Date
1ce91b8820
Complete diagram 2023-10-29 22:26:29 +01:00
5f8e36a605
Add signature diagram 2023-10-29 22:26:29 +01:00
c5ba06dc78
s/user ID/User ID/ 2023-10-29 22:26:29 +01:00
be5fff67ab
Progress 2023-10-29 22:26:29 +01:00
c80678e8f1
Move conflict-related changes to conflicts and duplication section 2023-10-29 22:26:29 +01:00
f04987df80
Add section on packet criticality 2023-10-29 22:26:29 +01:00
6c88b1631d
Fix notes on subpackets 2023-10-29 22:26:29 +01:00
heiko
55a6aac9dd Merge branch 'draft' into tammi-ch3-MAC 2023-10-29 14:07:39 +00:00
Heiko Schaefer
543b1a8cc1
clearly mark different sections of packet discussions 2023-10-28 01:50:07 +02:00
Heiko Schaefer
1612dfd5ba
wording fix 2023-10-28 01:47:40 +02:00
Heiko Schaefer
c3d7d5f8b5
ch4: updated user ids diagram 2023-10-28 01:04:45 +02:00
Heiko Schaefer
f0d240c5fa
this fixes a git mixup i made 2023-10-28 01:02:54 +02:00
Heiko Schaefer
3e3b7477bb
wording fix 2023-10-28 00:59:25 +02:00
Heiko Schaefer
4febf47bf0
add TODO note 2023-10-28 00:58:26 +02:00
Heiko Schaefer
a890aeddd5
wording fix 2023-10-27 23:40:07 +02:00
Heiko Schaefer
890f90c5f3
typo fix 2023-10-27 23:38:54 +02:00
Heiko Schaefer
38f5139600
word fix 2023-10-27 23:37:45 +02:00
Heiko Schaefer
a590637762
fixes to Direct Key Signature section 2023-10-27 23:34:41 +02:00
Heiko Schaefer
2c57712c3b
fix title 2023-10-27 23:24:59 +02:00
Tammi L. Coles
05d2e15fee finish current version of ch17, UserID+certification self-sig 2023-10-27 17:17:47 +02:00
Tammi L. Coles
a487db6996 correct packet type ID capitalization 2023-10-27 16:46:14 +02:00
Tammi L. Coles
a2b8f75ea2 edit User ID packet 2023-10-27 16:45:41 +02:00
Tammi L. Coles
580325dca4 edit ## Adding an identity component 2023-10-27 16:33:45 +02:00
Tammi L. Coles
63fbd49dcf edit subkey binding signature, correct comma placement 2023-10-27 16:20:48 +02:00
Tammi L. Coles
c2405f53ef edit next part of subkex binding signature 2023-10-27 15:01:20 +02:00
Tammi L. Coles
b6da12d0ee edit part 1 of subkey binding signature 2023-10-27 14:55:17 +02:00
Tammi L. Coles
fb24639ea1 edit Public-Subkey packet 2023-10-27 14:37:26 +02:00
Tammi L. Coles
1f8411caa6 edit encryption subkey 2023-10-27 14:17:25 +02:00
Tammi L. Coles
c8b417ccdb finish direct key signature section 2023-10-27 11:59:39 +02:00
Tammi L. Coles
199d0bb5e8 reformat subpacket details to ease comprehension 2023-10-27 11:05:18 +02:00
Tammi L. Coles
6283630e6c edits to ch17 field-by-field explainer 2023-10-27 09:45:26 +02:00
Tammi L. Coles
3f38d588f5 edit ch17 2023-10-27 09:26:13 +02:00
Tammi L. Coles
a2aa3c9109 edit KDFs section 2023-10-26 14:12:48 +02:00
David Runge
6aeaa0d35d
fix: Use current link for flowcrypt on sending password protected mails
Signed-off-by: David Runge <dave@sleepmap.de>
2023-10-26 13:08:50 +02:00
David Runge
d342884ecf
feat: Add make target to check links in html output using lychee
Signed-off-by: David Runge <dave@sleepmap.de>
2023-10-26 13:08:06 +02:00
Tammi L. Coles
4bf1ded007 edit ch3 MAC section 2023-10-26 12:12:26 +02:00
Tammi L. Coles
647b2494f5 Merge pull request 'Add section on KDFs' (#83) from 03-key_derivation into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/83
2023-10-26 09:32:04 +00:00
Heiko Schaefer
5496d54772
add link to gcm discussion, as a note for writing 2023-10-25 16:17:03 +02:00
Heiko Schaefer
460bc9d5a4
ch5: fix admonition type 2023-10-24 21:09:39 +02:00
Heiko Schaefer
87e26fa6cd
ch5: process input from wiktor 2023-10-24 21:08:14 +02:00
Heiko Schaefer
74d58454ea
ch17: import new diagram from skvis-draft 2023-10-24 00:53:53 +02:00
Tammi L. Coles
01103ebcf6
manually add link to zoom_certificates from issue #73 2023-10-24 00:53:18 +02:00
Heiko Schaefer
576c8de26d
ch18: add "secret-key packet" diagram 2023-10-24 00:41:10 +02:00
David Runge
121e352b59
feat: Add license attribution for all files
Signed-off-by: David Runge <dave@sleepmap.de>
2023-10-23 20:55:08 +02:00
e4164aab4d
Add section on HMAC 2023-10-23 13:04:42 +02:00
0b078830f2
Add section on KDFs 2023-10-23 12:40:15 +02:00
Heiko Schaefer
1ba8ac2884
ch3: fix myst syntax 2023-10-23 11:54:42 +02:00
Tammi L. Coles
9e4944064c manually add issue #73 again 2023-10-22 13:10:10 +02:00
Tammi L. Coles
27a43977cb remove misplaced section 2023-10-22 13:05:35 +02:00
Tammi L. Coles
7e709c6a00 manually add issue #73 2023-10-22 11:49:41 +02:00
Heiko Schaefer
a8467cd166
ch3: drop todo, the key types are now visualized 2023-10-22 10:15:42 +02:00
Heiko Schaefer
cf8c754624
use new diagrams for ch3 2023-10-22 09:59:41 +02:00
Heiko Schaefer
14e3919b9d
add new key diagrams for ch3 2023-10-22 09:59:41 +02:00
Tammi L. Coles
bd468da34f
expand on hybrid concept, mark for move 2023-10-22 09:59:41 +02:00
Tammi L. Coles
e1f0452ccd
expand on hybrid concept 2023-10-22 09:59:41 +02:00
Tammi L. Coles
b9341d921e
clarify MDC 2023-10-22 09:59:41 +02:00
Tammi L. Coles
6734930bd9
edit hybrid cryptosystems 2023-10-22 09:59:41 +02:00
Tammi L. Coles
5e6a857040
clarify private vs secret in this document 2023-10-22 09:59:41 +02:00
Tammi L. Coles
d810608dc6
swap parts for components 2023-10-22 09:59:41 +02:00
Tammi L. Coles
773015bdf4
clarify private vs secret in this document 2023-10-22 09:59:41 +02:00
Tammi L. Coles
bef3a69be9
rewrite header and note on Usage and terminology 2023-10-22 09:59:41 +02:00
Tammi L. Coles
b33251aa31
rework language of digital signatures and signers 2023-10-22 09:59:41 +02:00
Tammi L. Coles
57c4d2ef31
improve language of asymmetric key pair section 2023-10-22 09:59:41 +02:00
Tammi L. Coles
891ce892fc
simplify public-key cryptophay section for dummies like me 2023-10-22 09:59:41 +02:00
Tammi L. Coles
61f8a76bd6
simplify AEAD language, correct punctuation of footnote 2023-10-22 09:59:41 +02:00
Tammi L. Coles
4d0fbb3f43
simplify sessionkey footnote 2023-10-22 09:59:41 +02:00
Tammi L. Coles
3fb0179a77
clarify and question the benefits and downsides section 2023-10-22 09:59:41 +02:00
Tammi L. Coles
ce6d28020c
weave in asymmetric cryptography formerly in ch3 as symm-key explainer 2023-10-22 09:59:41 +02:00
Tammi L. Coles
2a828cd0fd
simplify cryptographic hash functions 2023-10-22 09:59:41 +02:00
Tammi L. Coles
173d23bb65 edit ch4, rewrite 3rd-party certifications 2023-10-21 15:01:50 +02:00
Tammi L. Coles
25af6a907a continue edits to ch4 2023-10-21 12:58:44 +02:00
Tammi L. Coles
498b01f01a get remote changes 2023-10-19 19:49:53 +02:00
Tammi L. Coles
b484018f41
edit key flags in part 2023-10-19 19:42:05 +02:00
Tammi L. Coles
17e0efb421
add warning/task regarding capitalization 2023-10-19 19:42:05 +02:00
Tammi L. Coles
9a5ff9f2ab
edit ch4 subkeys 2023-10-19 19:42:05 +02:00
Tammi L. Coles
f981225261
edit ch4 primary key 2023-10-19 19:42:05 +02:00
Tammi L. Coles
6abd5336cf
edit ch4 2023-10-19 19:42:05 +02:00
Tammi L. Coles
bedd68855a Merge remote-tracking branch 'refs/remotes/origin/tammi-ch4' into tammi-ch4 2023-10-19 19:28:17 +02:00
Tammi L. Coles
bec23c73f7
edit key flags in part 2023-10-19 19:19:53 +02:00
Tammi L. Coles
e7bf063c92
add warning/task regarding capitalization 2023-10-19 19:19:36 +02:00
Tammi L. Coles
23954ef803
edit ch4 subkeys 2023-10-19 19:19:34 +02:00
Tammi L. Coles
9cfc933e86
edit ch4 primary key 2023-10-19 19:18:37 +02:00
Tammi L. Coles
615ade4cfa
edit ch4 2023-10-19 19:18:34 +02:00
Tammi L. Coles
0b7ac3402f edit key flags in part 2023-10-19 19:16:11 +02:00
Tammi L. Coles
435b52593c add warning/task regarding capitalization 2023-10-19 17:44:47 +02:00
Tammi L. Coles
5eb49aee3e edit ch4 subkeys 2023-10-19 17:40:57 +02:00
Tammi L. Coles
4bcb73e5ec edit ch4 primary key 2023-10-19 17:35:17 +02:00
Tammi L. Coles
4edf20da61 edit ch4 2023-10-19 17:30:13 +02:00
Heiko Schaefer
14de863d53
index: add current date; limit toc to "maxdepth 2" 2023-10-19 09:26:07 +02:00
Heiko Schaefer
f16f4f341d
ch4: add "advanced" section about primary key metadata 2023-10-18 17:57:47 +02:00
Heiko Schaefer
e066c2e7a2
ch5: writing 2023-10-18 17:48:45 +02:00
Heiko Schaefer
fbd4126a63
ch4: move misplaced text 2023-10-17 18:16:24 +02:00
Heiko Schaefer
2cdcd6aebd
ch4: adjust fingerprint in text to diagram 2023-10-17 18:15:59 +02:00
Heiko Schaefer
9d79096f24
ch4: flatten section structure
(And remove todo that was moved to ch6)
2023-10-17 18:08:42 +02:00
Heiko Schaefer
9be2dfc539
ch4: shorten "Linking" section; most of it goes to ch6 2023-10-17 17:58:26 +02:00
Heiko Schaefer
1f9f953aa6
use new diagram for ch4 2023-10-17 17:58:26 +02:00
Heiko Schaefer
5525be4c5e
update certificate diagram 2023-10-17 17:58:26 +02:00
Heiko Schaefer
a40a2654f4
a: Add link anchor for bob's key 2023-10-16 15:25:24 +02:00
Heiko Schaefer
7873c72f97
annex a: add a key for bob, with Argon2 protected Secret-Key packets 2023-10-16 15:23:56 +02:00
Heiko Schaefer
86329e757b
restructure: move "zooming in" texts from ch4 to a new chapter 17 2023-10-16 15:22:37 +02:00
Heiko Schaefer
13a3d84526
ch4: move revocations section 2023-10-16 13:20:38 +02:00
Heiko Schaefer
0965fa4fae
ch4, zooming in: remove material that involves private key
(All of that should be in ch5)
2023-10-15 14:10:21 +02:00
Heiko Schaefer
2b018c73ee
ch4: clarify that this chapter deals with "public keys" only 2023-10-15 10:56:38 +02:00
Heiko Schaefer
3ed3d5ed6a
ch4: elaborate on user id conventions 2023-10-14 22:48:55 +02:00
Heiko Schaefer
2df7aa779d
ch4: Outline how key flags are set
(addresses one point of #63)
2023-10-14 22:48:55 +02:00
Heiko Schaefer
443023b8e9
ch4: fix phrasing 2023-10-14 22:45:03 +02:00
Heiko Schaefer
13f5cd5d73
ch4: clarify text in draft user id diagram 2023-10-14 20:50:30 +02:00
Heiko Schaefer
83ccdda6b4
Terminology fixes 2023-10-12 16:07:28 +02:00
Tammi L. Coles
f0959a2b0f
Adjust
to updated RFC terminology

Fixes #52
2023-10-12 16:03:08 +02:00
Heiko Schaefer
7617d7eea6
ch4: write "user id" zooming in section 2023-10-12 14:11:21 +02:00
Heiko Schaefer
3688054f4f
ch4: restructure packet splitting text sections 2023-10-12 14:11:02 +02:00
Heiko Schaefer
1aa4696f3e
ch4: add todo notes 2023-10-12 14:11:02 +02:00
Heiko Schaefer
d1203075d1
ch4: move text into a "note" block
And add a remark that a visualization would help.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
69f7eb60e5
ch4: clarify linking 2023-10-12 14:11:02 +02:00
Heiko Schaefer
bab5e427e9
ch4: add a section to talk about "no more user facing hex fingerprints in v6" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
2a3605f731
ch4: move diagram up 2023-10-12 14:11:02 +02:00
Heiko Schaefer
af355ae81e
ch4: adjust markup/styling of critical flags 2023-10-12 14:11:02 +02:00
Heiko Schaefer
c1acc328d0
ch4: move "criticality" footnote into a more visible note block 2023-10-12 14:11:02 +02:00
Heiko Schaefer
a1fe545e88
ch4: add a note that the example key isn't password protected
Add link to ch5 for discussion of encrypted private key material.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
134407ee2f
ch4: add a TODO note 2023-10-12 14:11:02 +02:00
Heiko Schaefer
66087b3ec9
ch4: clarify terms, use "identity components" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
1f89d39740
ch4: link to glossary for "CA" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
74710d804a
ch4: clarify the primary key can't confer validity beyond its own 2023-10-12 14:11:02 +02:00
Heiko Schaefer
fd2469e0e4
ch4: make links for "more on this below" pointers 2023-10-12 14:11:02 +02:00
Heiko Schaefer
8bf3440373
ch4: zooming in, write subkey sections 2023-10-12 14:11:02 +02:00
Heiko Schaefer
74e3810e84
ch4: zooming in, edits 2023-10-12 14:11:02 +02:00
Heiko Schaefer
96d9eff25f
ch4: zooming in, fix indentation of sq dump output 2023-10-12 14:11:02 +02:00
Heiko Schaefer
b1acb31ed0
ch4: zooming in, add subkey dumps 2023-10-12 14:11:02 +02:00
Heiko Schaefer
5fdb9be451
ch4: minor edits to "Seen as an OpenPGP certificate" 2023-10-12 14:11:02 +02:00
Heiko Schaefer
ac070e5229
ch4 "zooming in": fix capitalizations/styling
- Don't use quotation marks for RFC terms. Use italics, when appropriate.
- The word "packet" isn't capitalized when referring to a specific packet.
2023-10-12 14:11:02 +02:00
Heiko Schaefer
c592c6c02d
ch4: don't use title case 2023-10-12 14:11:02 +02:00
Tammi L. Coles
44eba4a6bb
change to 'may refer to' 2023-10-12 14:07:26 +02:00
Tammi L. Coles
6f179d2c07
remove asysmmetric explainer, evaluate for ch3 2023-10-12 14:07:26 +02:00
Tammi L. Coles
b353129bcc
add digital signatures 2023-10-12 14:07:26 +02:00
Tammi L. Coles
2beba67d13
edit section on layers of keys, integrating previoous Ch2 section 2023-10-12 14:07:26 +02:00
Tammi L. Coles
4e9ddaee0b
clarify in section on public vs private keys 2023-10-12 14:07:26 +02:00
Tammi L. Coles
ab926334bd
edit section intro on understanding keys 2023-10-12 14:07:26 +02:00
Tammi L. Coles
7da0131ea7
change opening lines/introduction to chapter 2023-10-12 14:07:26 +02:00
Tammi L. Coles
e5625f43db Merge branch 'draft' into tammi-ch4 2023-10-12 12:07:20 +00:00
Tammi L. Coles
1672ecc4c2 change to 'may refer to' 2023-10-12 14:06:10 +02:00
Tammi L. Coles
54a4f3457a remove asysmmetric explainer, evaluate for ch3 2023-10-12 13:54:51 +02:00
Tammi L. Coles
6130da92f3 add digital signatures 2023-10-12 13:42:38 +02:00
Heiko Schaefer
a0a33b13b4
ch1: notes on the elaboration 2023-10-12 12:06:53 +02:00
Heiko Schaefer
9a3bb16236
sphinx conf: more minimalistic output 2023-10-12 12:05:46 +02:00
Tammi L. Coles
f93b74638d
change to 'enable' for clarity 2023-10-12 12:01:34 +02:00
Heiko Schaefer
ea74ed2128
moved to https://codeberg.org/openpgp/notes/issues/58 2023-10-12 11:56:53 +02:00
Heiko Schaefer
b18f1eefec
moved to https://codeberg.org/openpgp/notes/issues/57 2023-10-12 11:56:18 +02:00
Heiko Schaefer
731c92d9fc
moved note into https://codeberg.org/openpgp/notes/issues/56 2023-10-12 11:50:15 +02:00
Heiko Schaefer
4fb5fb4fff
use myst "note" markup 2023-10-12 11:46:18 +02:00
Heiko Schaefer
62bf41b040
re-add (interop_section) link target 2023-10-12 11:46:18 +02:00