diff options
| author | user <user@host.com> | 2021-03-19 00:11:00 +0100 |
|---|---|---|
| committer | user <user@host.com> | 2021-03-19 00:11:00 +0100 |
| commit | 2b9b27f9c3801b2a4e5456c8abad56f42d397df5 (patch) | |
| tree | df872a56ac5648aaa53fa3c4a7b8b4f9168ea216 | |
| parent | c791d67728133321ef467e074dc4aeff49da88f3 (diff) | |
adds note about disabled commands
fixes some spelling issues
uses real h5 headers, also listed in the TOC
adds spacing between the sections for better legibility
adding   is a hack, but I did not want to start
messing with the css
| -rw-r--r-- | schleuder/docs/subscribers.md | 24 |
1 files changed, 18 insertions, 6 deletions
diff --git a/schleuder/docs/subscribers.md b/schleuder/docs/subscribers.md index 7105edd..c0a47be 100644 --- a/schleuder/docs/subscribers.md +++ b/schleuder/docs/subscribers.md @@ -6,6 +6,9 @@ title: Documentation for subscribers {% include_relative _list_usage_basics.md %} + + + #### Subscription and key management The following keywords must be send to the request address of the list: `foo-request@hostname`. @@ -20,11 +23,14 @@ Include `x-list-name: foo@hostname` with every command you send. **x-unset-fingerprint:** person@example.org : Remove the fingerprint associated with your subscription. -#### Example: Updating you key for a list + + + +#### Example: Updating your key for a list 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 new key to lists keyring ``` x-list-name: foo@hostname @@ -44,16 +50,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 uploaded key made it into the keyring ``` x-list-name: foo@hostname x-list-keys - ``` -The answer will list all keys in the lists keyring. Make sure, your **new** key is in the keyring now. +The answer will be a list of all keys in the lists keyring. +Make sure, your **new** key is in the keyring now. -**3. change you subscription to use the new key** +##### 3. change you subscription to use the new key ``` x-list-name: foo@hostname @@ -66,6 +72,12 @@ A successful answer should look something like this: 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 +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. + + #### Resending |