Add some info on client.py to README
This commit is contained in:
parent
7c8a5a377b
commit
c54d86412d
1 changed files with 55 additions and 6 deletions
61
README.md
61
README.md
|
@ -4,8 +4,6 @@
|
|||
|
||||
---
|
||||
|
||||
This is a work-in-progress project. See ROADMAP.md for details
|
||||
|
||||
## What is WKD/WKS?
|
||||
|
||||
Due to all the issues involved with the PGP key servers we're using today, GnuPG introduced a feature named [**Web Key
|
||||
|
@ -75,8 +73,8 @@ Configuration is done in `/etc/easywks.yml` (or any other place as specified by
|
|||
|
||||
```yaml
|
||||
---
|
||||
# EasyWKS works inside this directory. Its PGP keys as well# as all
|
||||
# the submitted and published keys are stored here.
|
||||
# EasyWKS works inside this directory. Its PGP keys as well as all
|
||||
# the submitted and published keys are stored here.
|
||||
directory: /var/lib/easywks
|
||||
|
||||
# Number of seconds after which a pending submission request is
|
||||
|
@ -129,7 +127,7 @@ lmtpd:
|
|||
# - {domain}: The email domain for with the request is processed.
|
||||
# - {sender}: The submitter's mail address.
|
||||
# - {submission}: The submission address.
|
||||
# When overriding the "error" template, theres an additional
|
||||
# When overriding the "error" template, there's an additional
|
||||
# placeholder you can use:
|
||||
# - {error}: The error message.
|
||||
#responses:
|
||||
|
@ -254,6 +252,57 @@ gpgwks@example.org lmtp:localhost:10024
|
|||
webkey@example.com lmtp:localhost:10024
|
||||
```
|
||||
|
||||
## EasyWKS Client
|
||||
|
||||
The file `client.py` contains a self-contained WKS client, which
|
||||
prompts you for your email address and IMAP/SMTP/POP3 password, and
|
||||
then attempts to figure out the mail servers via common
|
||||
autoconfiguration methods. Afterwards it will attempt a WKS key submission:
|
||||
|
||||
```console?prompt=$,
|
||||
$ ./client.py
|
||||
Enter email: john.doe@example.org
|
||||
Chose A58D3221F8079F35FF084890505A563492A56583
|
||||
Enter IMAP/POP3/SMTP password (will not echo): ********
|
||||
Autoconfigured incoming server: imaps://john.doe@example.org@imap.example.org:993
|
||||
Autoconfigured outgoing server: smtp+starttls://john.doe@example.org@smtp.example.org:587
|
||||
Please confirm: [Y/n] y
|
||||
Retrieved submission key
|
||||
Retrieved key to publish
|
||||
Created encrypted message
|
||||
Sending submission request
|
||||
Awaiting response
|
||||
Received confirmation request
|
||||
Nonce: 95184efbc5d2f75ed4b56162
|
||||
Creating confirmation response. GnuPG may prompt you for your passphrase.
|
||||
Sending confirmation response
|
||||
Awaiting publish response
|
||||
Decrypting WKS response. GnuPG may prompt you for your passphrase.
|
||||
|
||||
Hi there!
|
||||
|
||||
This is the EasyWKS system at example.org
|
||||
|
||||
Your key has been published to the Web Key Directory.
|
||||
You can test WKD key retrieval e.g. with:
|
||||
|
||||
gpg --auto-key-locate=wkd,nodefault --locate-key john.doe@example.org
|
||||
|
||||
For more information on WKD and WKS see:
|
||||
|
||||
https://gnupg.org/faq/wkd.html
|
||||
https://gnupg.org/faq/wks.html
|
||||
|
||||
|
||||
Regards
|
||||
EasyWKS
|
||||
|
||||
--
|
||||
Dance like nobody is watching.
|
||||
Encrypt live everybody is.
|
||||
|
||||
```
|
||||
|
||||
[wkd]: https://wiki.gnupg.org/WKD
|
||||
[wks]: https://wiki.gnupg.org/WKS
|
||||
[ietf]: https://datatracker.ietf.org/doc/html/draft-koch-openpgp-webkey-service-12
|
||||
[ietf]: https://datatracker.ietf.org/doc/html/draft-koch-openpgp-webkey-service-12
|
||||
|
|
Loading…
Reference in a new issue