Skip to contentSkip to conversation

Documentation: PGP: update for newer HW devices

PATCH New Konstantin Ryabitsev 1 participant 1 message Jun 26, 2019

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: PGP: update for newer HW devices

Newer devices like Yubikey 5 and Nitrokey Pro 2 have added support for NISTP's implementation of ECC cryptography, so update the guide accordingly and add a note on when to use nistp256 and when to use ed25519 for generating S keys.

---
.../process/maintainer-pgp-guide.rst | 31 ++++++++++---------

1 file changed, 17 insertions(+), 14 deletions(-)
Documentation/process/maintainer-pgp-guide.rst +4 -1
index 4bab7464ff8c..17db11b7ed48 100644
@@ -238,7 +238,10 @@ your new subkey::
    work.
 
    If for some reason you prefer to stay with RSA subkeys, just replace
-    "ed25519" with "rsa2048" in the above command.
+    "ed25519" with "rsa2048" in the above command. Additionally, if you
+    plan to use a hardware device that does not support ED25519 ECC
+    keys, like Nitrokey Pro or a Yubikey, then you should use
+    "nistp256" instead or "ed25519."
 
 

Back up your master key for disaster recovery
@@ -432,23 +435,23 @@ Available smartcard devices

Unless all your laptops and workstations have smartcard readers, the easiest is to get a specialized USB device that implements smartcard -functionality. There are several options available:
+functionality. There are several options available:

- Nitrokey Start_: Open hardware and Free Software, based on FSI

-  Japan's `Gnuk`_. Offers support for ECC keys, but fewest security
-  features (such as resistance to tampering or some side-channel
-  attacks).

-- Nitrokey Pro_: Similar to the Nitrokey Start, but more
- tamper-resistant and offers more security features, but no ECC
- support.
-- Yubikey 4_: proprietary hardware and software, but cheaper than

+  Japan's `Gnuk`_. One of the few available commercial devices that
+  support ED25519 ECC keys, but offer fewest security features (such as
+  resistance to tampering or some side-channel attacks).
+- `Nitrokey Pro 2`_: Similar to the Nitrokey Start, but more
+  tamper-resistant and offers more security features. Pro 2 supports ECC
+  cryptography (NISTP).
+- `Yubikey 5`_: proprietary hardware and software, but cheaper than

Nitrokey Pro and comes available in the USB-C form that is more useful with newer laptops. Offers additional security features such as FIDO
- U2F, but no ECC.
+ U2F, among others, and now finally supports ECC keys (NISTP).

LWN has a good review_ of some of the above models, as well as several -others. If you want to use ECC keys, your best bet among commercially -available devices is the Nitrokey Start.
+others. Your choice will depend on cost, shipping availability in your +geographical region, and open/proprietary hardware considerations.

.. note::

@@ -457,8 +460,8 @@ available devices is the Nitrokey Start.
Foundation.

.. _Nitrokey Start: https://shop.nitrokey.com/shop/product/nitrokey-start-6
-.. _Nitrokey Pro: https://shop.nitrokey.com/shop/product/nitrokey-pro-3
-.. _Yubikey 4: https://www.yubico.com/product/yubikey-4-series/
+.. _Nitrokey Pro 2: https://shop.nitrokey.com/shop/product/nitrokey-pro-2-3
+.. _Yubikey 5: https://www.yubico.com/products/yubikey-5-overview/
.. _Gnuk: http://www.fsij.org/doc-gnuk/
.. _LWN has a good review: https://lwn.net/Articles/736231/
.. _qualify for a free Nitrokey Start: https://www.kernel.org/nitrokey-digital-tokens-for-kernel-developers.html

Signature · 1 line
2.21.0