Skip to content

MSC4161: Crypto terminology for non-technical users #4161

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 56 commits into
base: main
Choose a base branch
from
Open

MSC4161: Crypto terminology for non-technical users #4161

Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
5f08ae9
Initial commit for MSC4161: Crypto terminology for non-technical users
andybalaam Jun 27, 2024
32f386b
First draft
andybalaam Jun 27, 2024
cd26b70
Fix typo
andybalaam Jun 27, 2024
a7b5a77
Fix mis-formatted heading
andybalaam Jun 27, 2024
a79b289
Fix incorrect bolding
andybalaam Jun 27, 2024
89412cc
Ensure we are consistently saying Alice's identity appears to have ch…
andybalaam Jun 27, 2024
d15576e
Add another example for key storage
andybalaam Sep 5, 2024
af70e43
Link to MSC4153 where we mention it.
andybalaam Sep 5, 2024
720cdeb
Make the wording about resetting keys more precise.
andybalaam Sep 5, 2024
de285aa
Re-word the paragraph about the importance of verified identity chang…
andybalaam Sep 5, 2024
57fc5c1
Link to the spec equivalent wording for our recovery key
andybalaam Sep 5, 2024
a4b95b4
Re-word the paragraph about Invisible Crypto
andybalaam Sep 5, 2024
0499900
Propose being an appendix to the spec
andybalaam Sep 6, 2024
b919630
Add a section on what to say when a message can't be decrypted
andybalaam Sep 6, 2024
007a15f
Add a missing 's'
andybalaam Sep 6, 2024
45928bb
changes->changed
andybalaam Sep 6, 2024
3a2d012
Remove erroneous UTD message
andybalaam Sep 6, 2024
56b5daf
Mention that clients SHOULD follow this guide and document any except…
andybalaam Oct 7, 2024
fba4f5c
person->user
andybalaam Oct 7, 2024
9246021
Reword sentence on cross-signing
andybalaam Oct 7, 2024
0c9d812
Re-word the "Waiting for this message" sentence
andybalaam Oct 7, 2024
705f7bb
Add missing word "message"
andybalaam Oct 7, 2024
4bcee33
Remove unneeded 'private key' warning
andybalaam Oct 7, 2024
f654c2e
Re-word 'key-backup' paragraph to contrast with export.
andybalaam Oct 7, 2024
3c7695f
Make clear that 'insecure device' is permitted
andybalaam Oct 7, 2024
7a789c5
Remove 'cryptographic' before 'identity', and also tone down the warn…
andybalaam Dec 17, 2024
3ed51ec
Link to spec sections on QR and emoji, and transitive trust MSC
andybalaam Dec 17, 2024
b44397b
Add a section about why this is important
andybalaam Dec 17, 2024
04df819
Add a paragraph about losing the recovery key
andybalaam Dec 17, 2024
bdbd7b4
Remove the 'appears to have changed' wording and add explanation
andybalaam Dec 17, 2024
7a9a84b
Note that older spec versions say 'recovery key'
andybalaam Dec 17, 2024
c13bd45
Add an Alternatives section about device and session
andybalaam Jan 31, 2025
d087885
Add a note about the Devices section depending on MSC4153
andybalaam Jan 31, 2025
a938372
Re-write key storage and recovery
andybalaam Jan 31, 2025
9cacbe7
Rename 'reset recovery' to 'change recovery key'
andybalaam Feb 3, 2025
0a449f6
Remove recommendation against recovery code
andybalaam Feb 3, 2025
f4de07d
Use a comma instead of a dash to avoid looking like a bullet point.
andybalaam Feb 4, 2025
2954056
Only unverified devices that have published keys are an error
andybalaam Feb 4, 2025
ecfd1ad
Link to the equivalent spec names for key storage and recovery
andybalaam Feb 4, 2025
6754d25
Use assertive language rather than "we propose"
andybalaam Mar 20, 2025
00993d9
Allow either 'device' or 'session'
andybalaam Mar 20, 2025
2f2c745
Be more assertive about updating the spec where relevant.
andybalaam Mar 20, 2025
bb56dff
Be more vague about where this lands in the spec
andybalaam Mar 20, 2025
4a943ef
Improve explanation of why to avoid 'device keys'
andybalaam Mar 20, 2025
8ede8fc
Tweak comments about loss of devices
andybalaam Mar 20, 2025
d68f033
Clarify who should be warned on identity reset
andybalaam Mar 20, 2025
0cc24c5
Make clear that bolded terms are normative.
andybalaam Mar 20, 2025
ba56376
Add missing quotation prefix
andybalaam Mar 20, 2025
b7f3f8b
Proposal language for double ratchet sentence.
andybalaam Mar 20, 2025
9976599
Remove MSC4153 material - it has been proposed to be added in MSC4153
andybalaam Mar 20, 2025
40c268d
Note that Element is using this as a reference
andybalaam Mar 21, 2025
cc83a41
Call out the situation when UTD is because of an error
andybalaam Mar 21, 2025
30acaac
Explain a little more what a recovery passphrase actually is
andybalaam Mar 21, 2025
38e2f25
Provide a list of references for using the word identity
andybalaam Mar 21, 2025
fa893e1
Add more alternatives to device
andybalaam Mar 21, 2025
d7ed82b
Reword 'identity was changed' to 'identity has been reset'
andybalaam Mar 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading