Verified Commit 9b081704 authored by georg's avatar georg

Schleuder subscribers: Improve wording of 'key update' docs

* Make the whole note about which key to sign with during the process
bold.

* Improve wording and make it more consistent.

* Fix typo.
parent 1bf2a6ab
Pipeline #56079 passed with stages
in 1 minute and 25 seconds
......@@ -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.
 
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment