From a0fbbb698bb8d04df701fef10f520690f1baa6de Mon Sep 17 00:00:00 2001 From: Yarmo Mackenbach Date: Tue, 9 Mar 2021 11:01:51 +0100 Subject: [PATCH] Add IRC and Matrix guides --- content/guides/irc.md | 67 ++++++++++++++++++++++++++++++++++++++ content/guides/matrix.md | 69 ++++++++++++++++++++++++++++++++++++++++ views/guides.pug | 12 ++++--- 3 files changed, 144 insertions(+), 4 deletions(-) create mode 100644 content/guides/irc.md create mode 100644 content/guides/matrix.md diff --git a/content/guides/irc.md b/content/guides/irc.md new file mode 100644 index 0000000..47cab15 --- /dev/null +++ b/content/guides/irc.md @@ -0,0 +1,67 @@ +# Adding an IRC proof + +Let's add a decentralized IRC proof to your OpenPGP keys. + +[[toc]] + +### Add a property to your IRC taxonomy + +After logging in into the IRC server with your registered nickname, send the +following message (make sure to replace FINGERPRINT): + +``` +/msg NickServ SET PROPERTY KEY openpgp4fpr:FINGERPRINT +``` + +To check whether successful, send (make sure to replace NICK): + +``` +/msg NickServ TAXONOMY NICK +``` + +To add more fingerprints, send: + +``` +/msg NickServ SET PROPERTY KEY2 openpgp4fpr:FINGERPRINT +``` + +### Update the PGP key + +First, edit the key (make sure to replace FINGERPRINT): + +``` +gpg --edit-key FINGERPRINT +``` + +Add a new notation: + +``` +notation +``` + +Enter the notation (make sure to replace IRC_SERVER and NICK): + +``` +proof@metacode.biz=irc://IRC_SERVER/NICK +``` + +So, for user `foo` on the freenode server, this would be: + +``` +proof@metacode.biz=irc://chat.freenode.net/foo +``` + +Save the key: + +``` +save +``` + +Upload the key to WKD or use the following command to upload the key to +[keys.openpgp.org](https://keys.openpgp.org) (make sure to replace FINGERPRINT): + +``` +gpg --keyserver hkps://keys.openpgp.org --send-keys FINGERPRINT +``` + +And you're done! Reload your profile page, it should now show an IRC account. diff --git a/content/guides/matrix.md b/content/guides/matrix.md new file mode 100644 index 0000000..27c01a4 --- /dev/null +++ b/content/guides/matrix.md @@ -0,0 +1,69 @@ +# Adding a Matrix proof + +Let's add a decentralized Matrix proof to your OpenPGP keys. + +[[toc]] + +### Sending a proof message + +After logging in into Matrix, join the +[#doipver:matrix.org](https://matrix.to/#/#doipver:matrix.org) room and send the +following message (make sure to replace FINGERPRINT) + +``` +[Verifying my OpenPGP key: openpgp4fpr:FINGERPRINT] +``` + +Click on "View Source" for that message, you should now see the value for +`room_id` and `event_id`. + +The value for `room_id` should be `!dBfQZxCoGVmSTujfiv:matrix.org`. The value +for `event_id` is unique to your message. + +If your Matrix client does not support "View Source", choose "Share" or +"Permalink". The URL obtained should look like this: + +``` +https://matrix.to/#/ROOM_ID/EVENT_ID?via=... +``` + +### Update the PGP key + +First, edit the key (make sure to replace FINGERPRINT): + +``` +gpg --edit-key FINGERPRINT +``` + +Add a new notation: + +``` +notation +``` + +Enter the notation (make sure to replace USER_ID, ROOM_ID, EVENT_ID): + +``` +proof@metacode.biz=matrix:u/USER_ID?org.keyoxide.r=ROOM_ID&org.keyoxide.e=EVENT_ID +``` + +So, for user `@foo:matrix.org`, this would be: + +``` +proof@metacode.biz=matrix:u/@foo:matrix.org?org.keyoxide.r=!dBfQZxCoGVmSTujfiv:matrix.org&org.keyoxide.e=$3dVX1nv3lmwnKxc0mgto_Sf-REVr45Z6G7LWLWal10w +``` + +Save the key: + +``` +save +``` + +Upload the key to WKD or use the following command to upload the key to +[keys.openpgp.org](https://keys.openpgp.org) (make sure to replace FINGERPRINT): + +``` +gpg --keyserver hkps://keys.openpgp.org --send-keys FINGERPRINT +``` + +And you're done! Reload your profile page, it should now show a Matrix account. diff --git a/views/guides.pug b/views/guides.pug index c7d2a79..a11da1d 100644 --- a/views/guides.pug +++ b/views/guides.pug @@ -15,7 +15,7 @@ block content a(href='/guides/contributing') Contributing to Keyoxide br a(href='/guides/self-hosting-keyoxide') Self-hosting Keyoxide - + .guides__section h3 OpenPGP and identity proofs a(href='/guides/openpgp-proofs') How OpenPGP identity proofs work @@ -23,7 +23,7 @@ block content a(href='/guides/web-key-directory') Uploading keys using web key directory br a(href='/guides/signature-profiles') Using signature profiles - + .guides__section h3 Adding proofs a(href='/guides/devto') Dev.to @@ -40,8 +40,12 @@ block content br a(href='/guides/hackernews') Hackernews br + a(href='/guides/irc') IRC + br a(href='/guides/lobsters') Lobste.rs br + a(href='/guides/matrix') Matrix + br a(href='/guides/mastodon') Mastodon br a(href='/guides/owncast') Owncast @@ -53,13 +57,13 @@ block content a(href='/guides/twitter') Twitter br a(href='/guides/xmpp') XMPP+OMEMO - + .guides__section h3 Other services a(href='/guides/feature-comparison-keybase') Feature comparison with Keybase br a(href='/guides/migrating-from-keybase') Migrating from Keybase - + .guides__section h3 Managing proofs in GnuPG a(href='/guides/managing-proofs-listing') Listing proofs