This document refers to Schleuder version 3.4 To read about older versions of Schleuder please see the older docs.
- Using a list
- Changed behaviour
Using a list
Everything you send to
foo@hostname will be send to all subscribers, but they will see only certain headers and the body of your email. The selection of these headers can be configured for each list individually by the list-admins.
Getting a list’s public key
Each Schleuder-list replies with its public key to any email sent to
foo-sendkey@hostname. E.g. to receive the key for our contact address write an email to
Schleuder knows some special keywords that trigger different behaviour. You can e.g. subscribe someone, or resend an email to a non-subscriber using keywords. See a list of available keywords below.
Keywords require that:
- they start the line and begin with “x-“,
- they are written into the beginning of the first text-part of the email (usually that’s just the normal body of the email),
- possible arguments must be written on the same line as the keyword (exceptions are mentioned in the descriptions below),
- the email must be encrypted and signed by a list-member’s key.
- the email must be formatted as a plain text message and not with HTML, RTF or similar formatting.
Keywords can be repeated within one email at will. Letter case doesn’t matter.
There are two types of keywords: those to enhance messages sent over the list (“list-keywords”), and those to request something from Schleuder (“request-keywords”).
To mitigate replay attacks of emails containing keywords, every email using a keyword must contain the special
x-list-name keyword followed by the list’s emailaddress. Example:
- x-list-name: email@example.com
- You must always provide this keyword once per email. Without it, no other keyword will be considered but you will receive an error message.
Subscription and key management
The following keywords must be send to the request address of the list:
- x-set-fingerprint: 0x12345678DEADBEEF12345678DEADBEEF12345678
- Assign the key with the given fingerprint to your subscription. It is not possible to set an empty fingerprint. To unset your fingerprint use
- x-unset-fingerprint: firstname.lastname@example.org
- Remove the fingerprint associated with your subscription.
The resending-keywords must be included in messages sent to the normal list-address:
- Attachs the public key of the list. Probably most useful in combination with x-resend.
- x-resend: email@example.com
- Send the message to the given address, encrypted if possible, otherwise in the clear.
- x-resend-encrypted-only: firstname.lastname@example.org
- Send the message to the given address only if it could be encrypted. Can be abbreviated to
- x-resend-unencrypted: email@example.com
- Send the message to the given address without encrypting it. You can use this keyword to make schleuder skip looking for a matching key for this address and enforce sending the email out in the clear.
- x-resend-cc: firstname.lastname@example.org email@example.com
- Send one message to all of the given addresses in Cc, so they get to know of each other (encrypted if possible, otherwise in the clear).
- x-resend-cc-encrypted-only: firstname.lastname@example.org
- Send one message to all of the given addresses in Cc, so they get to know of each other, only if it could be encrypted to all of those addresses. Can be abbreviated to
- x-resend-cc-unencrypted: email@example.com
- Send one unencrypted message to all of the given addresses in Cc, so they get to know of each other. We skip looking for any key and will just send out the email in the clear.
foo-owner@hostname to contact the list-owner(s) even if you don’t know who they are. Use the list’s key to encrypt the email!
Changes to the previous version of Schleuder are summarized in changes.