aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobin Krahl <robin.krahl@ireas.org>2020-09-25 02:09:18 +0200
committerDaniel Mueller <deso@posteo.net>2021-01-10 21:06:18 -0800
commit3d83b07ca7090817192bcd8f250effc0d0817b2a (patch)
tree8bdaf47908ee4e0526546d65f3531c817c5c87a2
parentf18fdc680c0bc616d64b116abaf2daede613f48b (diff)
downloadnitrocli-3d83b07ca7090817192bcd8f250effc0d0817b2a.tar.gz
nitrocli-3d83b07ca7090817192bcd8f250effc0d0817b2a.tar.bz2
Support Librem Key
This patch adds the librem device model for the Librem Key.
-rw-r--r--CHANGELOG.md1
-rw-r--r--README.md5
-rw-r--r--doc/nitrocli.114
-rw-r--r--doc/nitrocli.1.pdfbin43299 -> 43549 bytes
-rw-r--r--src/args.rs4
-rw-r--r--src/tests/mod.rs1
6 files changed, 16 insertions, 9 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 39237c9..bc268a2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,6 @@
Unreleased
----------
+- Added support for the Librem Key
- Added the `fill` command that fills the SD card of a Nitrokey Storage device
with random data
- Added the `termion` dependency in version `1.5.5`
diff --git a/README.md b/README.md
index adcd128..27801f7 100644
--- a/README.md
+++ b/README.md
@@ -8,8 +8,8 @@ nitrocli
- [Changelog](CHANGELOG.md)
**nitrocli** is a program that provides a command line interface for
-interaction with [Nitrokey Pro][nitrokey-pro] and [Nitrokey
-Storage][nitrokey-storage] devices.
+interaction with [Nitrokey Pro][nitrokey-pro], [Nitrokey
+Storage][nitrokey-storage], and [Librem Key][librem-key] devices.
The following commands are currently supported:
@@ -181,6 +181,7 @@ the full text of the license.
[nitrokey-gmbh]: https://www.nitrokey.com
[nitrokey-pro]: https://shop.nitrokey.com/shop/product/nitrokey-pro-2-3
[nitrokey-storage]: https://shop.nitrokey.com/shop/product/nitrokey-storage-2-56
+[librem-key]: https://puri.sm/products/librem-key/
[nitrocli-arch]: https://aur.archlinux.org/packages/nitrocli
[nitrocli-cratesio]: https://crates.io/crates/nitrocli
[nitrocli-debian]: https://packages.debian.org/stable/nitrocli
diff --git a/doc/nitrocli.1 b/doc/nitrocli.1
index c6d27be..fc089ad 100644
--- a/doc/nitrocli.1
+++ b/doc/nitrocli.1
@@ -7,7 +7,7 @@ nitrocli \- access Nitrokey devices
[\fIarguments\fR]
.SH DESCRIPTION
\fBnitrocli\fR provides access to Nitrokey devices.
-It supports the Nitrokey Pro and the Nitrokey Storage.
+It supports the Nitrokey Pro, the Nitrokey Storage, and the Librem Key.
It can be used to access the encrypted volume, the one-time password generator,
and the password safe.
.SS Device selection
@@ -21,7 +21,7 @@ Use the \fBlist\fR command to list all attached devices with their USB path,
model, and serial number (if available).
.SH OPTIONS
.TP
-\fB\-m\fR, \fB\-\-model pro\fR|\fBstorage\fR
+\fB\-m\fR, \fB\-\-model librem\fR|\fBpro\fR|\fBstorage\fR
Restrict connections to the given device model, see the Device selection
section.
.TP
@@ -153,9 +153,9 @@ Instead it checks whether a fill operation is currently running on the device
and shows its progress.
.SS One-time passwords
-The Nitrokey Pro and the Nitrokey Storage support the generation of one-time
-passwords using the HOTP algorithm according to RFC 4226 or the TOTP algorithm
-according to RFC 6238.
+The Nitrokey Pro, the Nitrokey Storage, and the Librem Key support the
+generation of one-time passwords using the HOTP algorithm according to RFC 4226
+or the TOTP algorithm according to RFC 6238.
The required data \(en a name and the secret \(en is stored in slots.
Currently, the Nitrokey devices provide three HOTP slots and 15 TOTP slots.
The slots are numbered per algorithm starting at zero.
@@ -245,8 +245,8 @@ If \fB\-\-no\-otp\-pin\fR is set, OTP generation can be performed without PIN.
These two options are mutually exclusive.
.SS Password safe
-The Nitrokey Pro and the Nitrokey Storage provide a password safe (PWS) with 16
-slots.
+The Nitrokey Pro, the Nitrokey Storage, and the Librem Key provide a password
+safe (PWS) with 16 slots.
In each of these slots you can store a name, a login, and a password.
The PWS is not encrypted, but it is protected with the user PIN by the firmware.
Once the PWS is unlocked by one of the commands listed below, it can be
diff --git a/doc/nitrocli.1.pdf b/doc/nitrocli.1.pdf
index 6fd3406..f8b62e5 100644
--- a/doc/nitrocli.1.pdf
+++ b/doc/nitrocli.1.pdf
Binary files differ
diff --git a/src/args.rs b/src/args.rs
index e4bc77d..3bb1225 100644
--- a/src/args.rs
+++ b/src/args.rs
@@ -38,6 +38,7 @@ pub struct Args {
Enum! {
/// The available Nitrokey models.
DeviceModel, [
+ Librem => "librem",
Pro => "pro",
Storage => "storage",
]
@@ -46,6 +47,7 @@ Enum! {
impl DeviceModel {
pub fn as_user_facing_str(&self) -> &str {
match self {
+ DeviceModel::Librem => "Librem",
DeviceModel::Pro => "Pro",
DeviceModel::Storage => "Storage",
}
@@ -55,6 +57,7 @@ impl DeviceModel {
impl From<DeviceModel> for nitrokey::Model {
fn from(model: DeviceModel) -> nitrokey::Model {
match model {
+ DeviceModel::Librem => nitrokey::Model::Librem,
DeviceModel::Pro => nitrokey::Model::Pro,
DeviceModel::Storage => nitrokey::Model::Storage,
}
@@ -66,6 +69,7 @@ impl convert::TryFrom<nitrokey::Model> for DeviceModel {
fn try_from(model: nitrokey::Model) -> Result<DeviceModel, anyhow::Error> {
match model {
+ nitrokey::Model::Librem => Ok(DeviceModel::Librem),
nitrokey::Model::Pro => Ok(DeviceModel::Pro),
nitrokey::Model::Storage => Ok(DeviceModel::Storage),
_ => Err(anyhow::anyhow!("Unsupported device model: {}", model)),
diff --git a/src/tests/mod.rs b/src/tests/mod.rs
index 23eecc5..65983bb 100644
--- a/src/tests/mod.rs
+++ b/src/tests/mod.rs
@@ -76,6 +76,7 @@ impl Nitrocli {
fn model_to_arg(model: nitrokey::Model) -> &'static str {
match model {
+ nitrokey::Model::Librem => "--model=librem",
nitrokey::Model::Pro => "--model=pro",
nitrokey::Model::Storage => "--model=storage",
_ => panic!("Unexpected model in test suite: {}", model),