diff options
| author | Nina <n.siessegger@zeromail.org> | 2021-03-23 19:37:46 +0000 |
|---|---|---|
| committer | Nina <n.siessegger@zeromail.org> | 2021-03-23 19:37:46 +0000 |
| commit | 1ee9b9bfd97b068372b0f31f030b6ecfd6d2dcf8 (patch) | |
| tree | ef6265c56ed18c7e0806122c5158465efb17ceeb | |
| parent | 1bf2a6ab3ab031ab3f59602e035b4039d6064afc (diff) | |
| parent | 9b08170400f37d48666e84e133b42493217d9bcc (diff) | |
Merge branch 'subscribers-update-key-improvements' into 'main'
Schleuder subscribers: Improve wording of 'key update' docs
See merge request schleuder/schleuder-website!102
| -rw-r--r-- | schleuder/docs/subscribers.md | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/schleuder/docs/subscribers.md b/schleuder/docs/subscribers.md index 14b0025..6fe0668 100644 --- a/schleuder/docs/subscribers.md +++ b/schleuder/docs/subscribers.md @@ -27,11 +27,11 @@ Include `x-list-name: foo@hostname` with every command you send. -#### Example: Updating your key for a list +#### Example: Update your key of a list subscription -All commands to switch to a **new** key must be signed with the current **old** key. +**All commands to switch to a new key must be signed with the current old key.** -##### 1. submit new key to lists keyring +##### 1. Submit the new key to the keyring of the list ``` x-list-name: foo@hostname @@ -51,16 +51,16 @@ A successful answer should look something like this: > This key was newly added: > 0x12345678DEADBEEF12345678DEADBEEF12345678 youraccount@yourmail.net 2019-05-23 [expires: 2023-05-23] -##### 2. verify that uploaded key made it into the keyring +##### 2. Verify that the uploaded key made it into the keyring ``` x-list-name: foo@hostname x-list-keys ``` -The answer will be a list of all keys in the lists keyring. +The answer will be a list of all keys in the keyring of the list. Make sure, your **new** key is in the keyring now. -##### 3. change you subscription to use the new key +##### 3. Change your subscription to use the new key ``` x-list-name: foo@hostname @@ -70,13 +70,13 @@ x-set-fingerprint: 0x12345678DEADBEEF12345678DEADBEEF12345678 A successful answer should look something like this: > Fingerprint for youraccount@yourmail.net set to 12345678DEADBEEF12345678DEADBEEF12345678. -From now on, all mails will be encrpyted to the **new** key -and all your mails must be signed with this key. +From now on, all mails will be encrpyted to the **new** key and all your mails must be signed with this key. + +##### One caveat: Disabled commands -##### One caveat: disabled commands To further improve security and confidentiality, list-admins can manually **disable certain commands** like `x-add-key` for mere subscribers of the list. With these commands disabled for you, -you have to rely on the list-admin for key management. +you have to rely on the list-admin to handle key management. |