From ae65fb9b19e7dbf87173cc4e1265d89e88c8893e Mon Sep 17 00:00:00 2001 From: Benoit Joly Date: Tue, 21 Jul 2020 00:56:43 -0400 Subject: [PATCH 1/2] Adding details around listing and deleting proofs notation related commands are quite obscur. listing and deleting proofs are not that easy to find. --- views/guides.php | 6 ++++ .../managing-proofs-deleting.content.php | 32 +++++++++++++++++++ .../guides/managing-proofs-deleting.title.php | 1 + .../managing-proofs-listing.content.php | 23 +++++++++++++ .../guides/managing-proofs-listing.title.php | 1 + 5 files changed, 63 insertions(+) create mode 100644 views/guides/managing-proofs-deleting.content.php create mode 100644 views/guides/managing-proofs-deleting.title.php create mode 100644 views/guides/managing-proofs-listing.content.php create mode 100644 views/guides/managing-proofs-listing.title.php diff --git a/views/guides.php b/views/guides.php index 59d622f..bdb0b82 100644 --- a/views/guides.php +++ b/views/guides.php @@ -39,5 +39,11 @@ Feature comparison with Keybase
Migrating from Keybase
+ +
+

Managing proofs in GnuPG

+ Listing proofs
+ Deleting proofs
+
diff --git a/views/guides/managing-proofs-deleting.content.php b/views/guides/managing-proofs-deleting.content.php new file mode 100644 index 0000000..9eb2a64 --- /dev/null +++ b/views/guides/managing-proofs-deleting.content.php @@ -0,0 +1,32 @@ +

Over time, you may need to delete proofs. Changing proofs can be achieved by deleting proofs and adding new ones.

+ +

Delete all proofs

+ +

First, edit the key (make sure to replace FINGERPRINT):

+gpg --edit-key FINGERPRINT + +

Launch the notation prompt

+notation + +

Enter the 'none' notation to delete all notations

+none + +

Save the changes

+save + +

Delete one of your proofs

+ +

First, edit the key (make sure to replace FINGERPRINT):

+gpg --edit-key FINGERPRINT + +

Launch the notation prompt

+notation + +

In this case, you need to start with - followed by the proof you want to delete. Make sure you type the proof exactly like it is in your key.

+-proof@metacode.biz=dns:yourdomain.org?type=TXT + +

Save the changes

+save + +

Publish your key changes

+

Like adding new proofs, you most probably want to publish your changes to WKD or to a keyserver like keys.openpgp.org diff --git a/views/guides/managing-proofs-deleting.title.php b/views/guides/managing-proofs-deleting.title.php new file mode 100644 index 0000000..62440b4 --- /dev/null +++ b/views/guides/managing-proofs-deleting.title.php @@ -0,0 +1 @@ +Deleting Proofs using GnuPG diff --git a/views/guides/managing-proofs-listing.content.php b/views/guides/managing-proofs-listing.content.php new file mode 100644 index 0000000..329ea35 --- /dev/null +++ b/views/guides/managing-proofs-listing.content.php @@ -0,0 +1,23 @@ +

Now that we have proofs on our OpenPGP keys, lets list them.

+ +

Listing notations in GnuPG

+ +

First, edit the key (make sure to replace FINGERPRINT):

+gpg --edit-key FINGERPRINT + +

List detailed prefs:

+showpref + +

You should now see your key details, uid, and proofs assigned to your keys

+ +[ultimate] (1). Your Name + Cipher: AES256, AES192, AES, 3DES + Digest: SHA512, SHA384, SHA256, SHA1 + Compression: ZLIB, BZIP2, ZIP, Uncompressed + Features: MDC, Keyserver no-modify + Notations: proof@metacode.biz=https://gist.github.com/youruser/somehash + proof@metacode.biz=dns:yourdomain.org?type=TXT + + +

Exit gpg

+quit diff --git a/views/guides/managing-proofs-listing.title.php b/views/guides/managing-proofs-listing.title.php new file mode 100644 index 0000000..33308f0 --- /dev/null +++ b/views/guides/managing-proofs-listing.title.php @@ -0,0 +1 @@ +Listing Proofs using GnuPG From 9a5242dc5ddc75d2f6cd0362853612a2c54edc28 Mon Sep 17 00:00:00 2001 From: Yarmo Mackenbach Date: Mon, 27 Jul 2020 13:50:40 +0200 Subject: [PATCH 2/2] Improve guides --- .../managing-proofs-deleting.content.php | 18 ++++++++++-------- .../guides/managing-proofs-listing.content.php | 8 ++++---- 2 files changed, 14 insertions(+), 12 deletions(-) diff --git a/views/guides/managing-proofs-deleting.content.php b/views/guides/managing-proofs-deleting.content.php index 9eb2a64..1e8c99c 100644 --- a/views/guides/managing-proofs-deleting.content.php +++ b/views/guides/managing-proofs-deleting.content.php @@ -5,13 +5,13 @@

First, edit the key (make sure to replace FINGERPRINT):

gpg --edit-key FINGERPRINT -

Launch the notation prompt

+

Launch the notation prompt:

notation -

Enter the 'none' notation to delete all notations

+

Enter the 'none' notation to delete all notations:

none -

Save the changes

+

Save the changes:

save

Delete one of your proofs

@@ -19,14 +19,16 @@

First, edit the key (make sure to replace FINGERPRINT):

gpg --edit-key FINGERPRINT -

Launch the notation prompt

+

Launch the notation prompt:

notation -

In this case, you need to start with - followed by the proof you want to delete. Make sure you type the proof exactly like it is in your key.

+

Enter the - (minus) symbol followed by the proof you want to delete. Make sure you type the proof exactly like it is in your key.

-proof@metacode.biz=dns:yourdomain.org?type=TXT -

Save the changes

+

To make it easier to enter the right proof, you could first list all proofs and simply copy the proof (including "proof@metacode.biz=") you want to delete.

+ +

Save the changes:

save -

Publish your key changes

-

Like adding new proofs, you most probably want to publish your changes to WKD or to a keyserver like keys.openpgp.org +

Upload the key to WKD or use the following command to upload the key to keys.openpgp.org (make sure to replace FINGERPRINT):

+gpg --keyserver hkps://keys.openpgp.org --send-keys FINGERPRINT diff --git a/views/guides/managing-proofs-listing.content.php b/views/guides/managing-proofs-listing.content.php index 329ea35..2765799 100644 --- a/views/guides/managing-proofs-listing.content.php +++ b/views/guides/managing-proofs-listing.content.php @@ -1,14 +1,14 @@ -

Now that we have proofs on our OpenPGP keys, lets list them.

+

Let's list the identity proofs stored in our OpenPGP keys.

Listing notations in GnuPG

First, edit the key (make sure to replace FINGERPRINT):

gpg --edit-key FINGERPRINT -

List detailed prefs:

+

List detailed preferences:

showpref -

You should now see your key details, uid, and proofs assigned to your keys

+

You should now see your key details, uid, and proofs assigned to your keys:

[ultimate] (1). Your Name Cipher: AES256, AES192, AES, 3DES @@ -19,5 +19,5 @@ proof@metacode.biz=dns:yourdomain.org?type=TXT -

Exit gpg

+

Exit gpg:

quit