Commit graph

324 commits

Author SHA1 Message Date
Heiko Schaefer
1ba8ac2884
ch3: fix myst syntax 2023-10-23 11:54:42 +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
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
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
Tammi L. Coles
cf553aba38
edit details on PGP distribution 2023-10-12 11:46:18 +02:00
Tammi L. Coles
121119c709
clarify timeframe on v4 popularity 2023-10-12 11:46:18 +02:00
Tammi L. Coles
25f9252e48
add Bouncy Castle, remove PGPainless 2023-10-12 11:46:18 +02:00
Tammi L. Coles
250c9f42eb
insert comma 2023-10-12 11:46:18 +02:00
Tammi L. Coles
705f651a89
add s 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e968ad9c75
added in 2023-10-12 11:46:18 +02:00
Tammi L. Coles
6947239101
removed extra a, changed like to such as 2023-10-12 11:46:18 +02:00
Tammi L. Coles
7fdcdb2391
edit, change to 'personally identifiable information (PII)' 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e5b114a9ef
remove html in markdown 2023-10-12 11:46:18 +02:00
Tammi L. Coles
ff96d27b2e
move certificate and keys section to Ch4 2023-10-12 11:46:18 +02:00
Tammi L. Coles
f0db3cb5cc
move building blocks to Ch1 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ff8b69cb7
move high-level operations to Ch1 2023-10-12 11:46:18 +02:00
Tammi L. Coles
c65141a712
clarify why there is no v5 2023-10-12 11:46:18 +02:00
Tammi L. Coles
8e8507ebbf
add note regarding zoom in intructions 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ba166f4df
remove (interop_section)= line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
b39d808290
move interoperability section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
a8c14033a7
correct typo 2023-10-12 11:46:18 +02:00
Tammi L. Coles
02603ef7db
correct typo 2023-10-12 11:46:18 +02:00
Tammi L. Coles
bfb34f8f6b
change header on implementations 2023-10-12 11:46:18 +02:00
Tammi L. Coles
5b5e449925
note that an issue needs to be created re v5 2023-10-12 11:46:18 +02:00
Tammi L. Coles
b3338bb4e2
note that an issue needs to be created re OpenPGP line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
985f29d4c7
fix punctuation 2023-10-12 11:46:18 +02:00
Tammi L. Coles
3c75ccc3c5
edit certificates and keys concept section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
5077358a99
add line breaks for legibility 2023-10-12 11:46:18 +02:00
Tammi L. Coles
fb0b47d4f4
add line breaks for legibility 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9b81ebb8fe
improve text re version 6 2023-10-12 11:46:18 +02:00
Tammi L. Coles
9ef56526bc
improve text re version 4 and its implementations 2023-10-12 11:46:18 +02:00
Tammi L. Coles
7a0b4832ec
edit history to of PGP, standardizing, and GnuPG 2023-10-12 11:46:18 +02:00
Tammi L. Coles
6679f2fdf9
edit language and punctuation of PGP line 2023-10-12 11:46:18 +02:00
Tammi L. Coles
e103ac0797
expand "why OpenPGP" section 2023-10-12 11:46:18 +02:00
Tammi L. Coles
797ff78719 Merge pull request 'ch1: high level text moved here (formerly from ch2)' (#44) from tammi-ch1 into draft
Reviewed-on: https://codeberg.org/openpgp/notes/pulls/44
2023-10-12 09:43:26 +00:00
Heiko Schaefer
b1dab566a8
ch3: move terminology note into an
"admonition"
2023-10-09 18:04:54 +02:00
Tammi L. Coles
3f8fb4690f change format to standard and clarify role 2023-10-07 14:12:45 +02:00
Tammi L. Coles
6a22002cb8 remove unnecessary line breaks 2023-10-07 13:34:50 +02:00
Tammi L. Coles
67bdc2f64b integrate operations & building blocks statements formerly in Ch2 2023-10-07 13:29:31 +02:00
Heiko Schaefer
7e760f2035
ch4: minor edits 2023-10-05 10:33:42 +02:00
Heiko Schaefer
c657d64734
ch4: improvements to "zooming in" 2023-10-05 10:33:42 +02:00
Heiko Schaefer
ec78df2453
ch4: clarify terminology
Also see #43
2023-10-05 10:30:35 +02:00
Heiko Schaefer
d20fbbc13d
ch3: processed feedback from wiktor 2023-10-04 21:21:04 +02:00
Heiko Schaefer
305f039dff
ch4: feedback from wiktor 2023-10-04 18:40:02 +02:00
Heiko Schaefer
810cec05e2
ch2: feedback from david 2023-10-04 16:25:04 +02:00
Heiko Schaefer
8ca953e39e
diag: Use png versions of diagrams for now
In the epub version, some viewers don't show text for svg diagrams (probably a missing font issue).
2023-10-04 16:25:04 +02:00
Heiko Schaefer
0368edef16
ch4: flesh out first part of "zooming in" section 2023-10-04 15:37:39 +02:00
Heiko Schaefer
0a41338801
ch4: simplify "note" markup 2023-10-04 15:35:46 +02:00
Heiko Schaefer
c1e6630f9f
ch10/11: outline adjustments
Move legacy "SED" mode from "encrypt" to "decrypt" chapter
2023-10-04 15:19:12 +02:00
Heiko Schaefer
061f4a9625
ch2: add section about PQC work; move "zooming in" to the end 2023-10-04 14:55:40 +02:00
Heiko Schaefer
ee35f4af51
ch4: remove duplication 2023-10-04 14:33:41 +02:00
Heiko Schaefer
f62fb72190
ch3: drop task (it's done) 2023-10-04 14:33:40 +02:00
Heiko Schaefer
664f3cec86
conf: enable show_relbars
fixes #40
2023-10-04 14:01:51 +02:00
Heiko Schaefer
55d1ce73a1
ch3: improvements suggested by @vanitasvitae
fixes #34
2023-10-04 10:56:10 +02:00
Heiko Schaefer
a59190bf4b
diag: new component key diagram 2023-10-03 20:39:05 +02:00
Heiko Schaefer
724a0673fd
fix/normalize "zooming in" section titles 2023-10-03 20:08:02 +02:00
Heiko Schaefer
cc6077e27c
ch4: use new diagrams 2023-10-03 19:34:48 +02:00
Heiko Schaefer
1f18e9a8ff
ch4: Edit main part of the text 2023-10-03 19:34:48 +02:00
Heiko Schaefer
ea7dc03e46
diag: backsig 2023-10-03 19:34:48 +02:00
Heiko Schaefer
59e292a3ec
diag: clarify metadata 2023-10-03 19:34:48 +02:00
Heiko Schaefer
0cbc17840e
diag: clarify metadata in component keys 2023-10-03 19:34:48 +02:00
Heiko Schaefer
d69617afbd
Appendix A: adjust chapter name
This name is shown when linking to (alice_priv) and not providing a link text.
2023-10-03 19:34:48 +02:00
Heiko Schaefer
59b19eeb89
ch3: use new diagram 2023-10-03 19:34:48 +02:00
Heiko Schaefer
f855a35284
diag: remove duplicate files 2023-10-03 19:18:10 +02:00
skvisual
df73987719
png/svg-Version of
-crypotgraphic keypair
-fingerprint
-OpenPGP_Certificate
-Subkeys
and updated diagram file
2023-10-03 19:14:39 +02:00
Heiko Schaefer
42e37a6260
ch4: Introduce "component" term 2023-10-03 19:14:39 +02:00
Heiko Schaefer
7c94b45ea8
ch4: Add new certificate diagram 2023-10-03 19:14:39 +02:00
skvisual
c19d77e0c0
diag library & openpgp certificate update 2023-10-03 19:14:39 +02:00
skvisual
a488e737f5
diag library & openpgp cert first draft 2023-10-03 19:14:39 +02:00
Heiko Schaefer
85b4003a53
conf: make code_font_size smaller
So that "sq packet dump" output fits into the view column.
2023-10-02 15:38:26 +02:00
Heiko Schaefer
854bda18ad
ch4: adjust to use alice's v6 key; minor edits 2023-10-01 18:32:06 +02:00
Heiko Schaefer
f080803555
ch4: add alt text to figure 2023-10-01 18:30:56 +02:00
Heiko Schaefer
47867b32f4
ch4: update links from 4880 to crypto-refresh 2023-10-01 16:35:17 +02:00
Heiko Schaefer
2640c84181
diag: update to alice's v6 test key 2023-10-01 16:35:16 +02:00
Heiko Schaefer
911b5dfebe
conf: set version to 0.01
EPUB3 generation warns if no version is set.
2023-10-01 15:08:38 +02:00
Heiko Schaefer
9c8a4c388b
drop "indices and tables" from index, for now 2023-10-01 12:41:25 +02:00