<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/nitrocli/doc, branch master</title>
<subtitle>A command line tool for interacting with Nitrokey devices (GitHub mirror)
</subtitle>
<id>https://git.ireas.org/mirrors/nitrocli/atom?h=master</id>
<link rel='self' href='https://git.ireas.org/mirrors/nitrocli/atom?h=master'/>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/'/>
<updated>2020-10-04T13:51:10Z</updated>
<entry>
<title>Update man page after change to base32 default OTP format</title>
<updated>2020-10-04T13:51:10Z</updated>
<author>
<name>Daniel Mueller</name>
<email>deso@posteo.net</email>
</author>
<published>2020-10-04T13:51:10Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=a992925f7dcee6a27404df0a56b47c09faed5265'/>
<id>urn:sha1:a992925f7dcee6a27404df0a56b47c09faed5265</id>
<content type='text'>
When we switched the default OTP format from hexadecimal to base32 we
missed that the manual was providing examples of the otp set command
that were implicitly making use of the default format -- leading to a
mismatch between what the example is meant to do and what it actually
does.
This change fixes this oversight in the manual by adjusting the examples
accordingly.
</content>
</entry>
<entry>
<title>Fix number of password safe slots mentioned in the man page</title>
<updated>2020-10-04T13:30:03Z</updated>
<author>
<name>Daniel Mueller</name>
<email>deso@posteo.net</email>
</author>
<published>2020-10-04T13:30:03Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=4d779638826bee5e4ee5c7ea2ed2fc8d0d7275be'/>
<id>urn:sha1:4d779638826bee5e4ee5c7ea2ed2fc8d0d7275be</id>
<content type='text'>
The man page mentions a password safe slot count of 20 for both the
Nitrokey Pro and the Nitrokey Storage devices. This count is incorrect,
as both devices can store only 16 entries each, as is evident from the
corresponding technical details for each device. With this change we
correct said number.
</content>
</entry>
<entry>
<title>Rename device path to USB path in list output</title>
<updated>2021-01-11T01:37:57Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-09-09T11:03:44Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=b39663bf381cbc1079fed08fbd3d0fe665151e90'/>
<id>urn:sha1:b39663bf381cbc1079fed08fbd3d0fe665151e90</id>
<content type='text'>
For consistency with the --usb-path option, this path renames the device
path column in the output of the list command to USB path.
</content>
</entry>
<entry>
<title>Add --usb-path option to select device</title>
<updated>2021-01-11T01:37:57Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-09-08T16:23:30Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=9593dfd03a6ca085d649ca090b6ec5e5f0104e78'/>
<id>urn:sha1:9593dfd03a6ca085d649ca090b6ec5e5f0104e78</id>
<content type='text'>
This patch adds the --usb-path option as an additional way to filter the
Nitrokey device to connect to.  While the serial number is a better
identifier in theory, the Nitrokey Storage devices do not send their
serial number in the USB device descriptor.  Having the --usb-path
options allows users to select one of multiple Nitrokey Storage devices.

While we could directly call the nitrokey::Manager::connect_path
function with the specified path, we integrate the --usb-path option
into the existing find_device function for consistent error messages and
to avoid having to duplicate the --model and --serial-number checks.
</content>
</entry>
<entry>
<title>Add --serial-number option</title>
<updated>2021-01-11T01:37:56Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-01-25T19:33:57Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=6ce6dc4f3db67c3f6b6148b1fb03644e91900291'/>
<id>urn:sha1:6ce6dc4f3db67c3f6b6148b1fb03644e91900291</id>
<content type='text'>
This patch adds the --serial-number option that allows the user to
filter the attached Nitrokey devices by serial number.  As the Nitrokey
Storage does not include its serial number in the USB device descriptor
and as we don't want to connect to it just to query the serial number,
this option only works for Nitrokey Storage devices.
</content>
</entry>
<entry>
<title>Fail if multiple matching devices are attached</title>
<updated>2021-01-11T01:37:55Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-09-06T21:44:18Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=6f029e744abc0f6d4cfe756d7e6b771be1be3999'/>
<id>urn:sha1:6f029e744abc0f6d4cfe756d7e6b771be1be3999</id>
<content type='text'>
Previously, we just applied our filter (if any) to all attached Nitrokey
devices and selected the first match when connection to a Nitrokey
device.  This may lead to unexpected behavior if multiple devices are
attached.  This patch changes the find_device function to return an
error if multiple matching devices are found.
</content>
</entry>
<entry>
<title>Adjust copyright &amp; license specification to comply with REUSE 3.0</title>
<updated>2020-09-03T04:40:32Z</updated>
<author>
<name>Daniel Mueller</name>
<email>deso@posteo.net</email>
</author>
<published>2020-09-03T04:40:32Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=79346022d01a73a8987298d82a2f0b749b63ac50'/>
<id>urn:sha1:79346022d01a73a8987298d82a2f0b749b63ac50</id>
<content type='text'>
With this change we switch to using a REUSE compliant way of specifying
the copyright &amp; license of the program. To be fully in conformance we
also add additional license specifications for the remaining files in
the project. Lastly, a new CI pipeline rule takes care of verifying
compliance on an ongoing basis.
</content>
</entry>
<entry>
<title>Update man page</title>
<updated>2021-01-11T01:37:52Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-02-02T11:15:32Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=6a9c31f19617f01f17d71b8a85f94cf6877fe7c8'/>
<id>urn:sha1:6a9c31f19617f01f17d71b8a85f94cf6877fe7c8</id>
<content type='text'>
This patch updates the man page for the last changes:
- new option --no-cache
- changes to the environment variables
- configuration files
</content>
</entry>
<entry>
<title>Add config test case and example config file</title>
<updated>2021-01-11T01:37:52Z</updated>
<author>
<name>Robin Krahl</name>
<email>robin.krahl@ireas.org</email>
</author>
<published>2020-02-02T11:15:27Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=aeaffebcde16db3fa505935771b19cbae9a6f658'/>
<id>urn:sha1:aeaffebcde16db3fa505935771b19cbae9a6f658</id>
<content type='text'>
This patch adds a simple configuration file that demonstrates the syntax
and contains some documentation.  We suggest to ship this file together
with nitrocli and to install it e.g., in the /usr/share/doc/nitrocli
directory.  This patch also adds a simple test case that makes sure that
the example file is parsed correctly.
</content>
</entry>
<entry>
<title>Change default OTP format to base32</title>
<updated>2020-07-08T00:35:50Z</updated>
<author>
<name>Daniel Mueller</name>
<email>deso@posteo.net</email>
</author>
<published>2020-07-08T00:35:50Z</published>
<link rel='alternate' type='text/html' href='https://git.ireas.org/mirrors/nitrocli/commit/?id=99fde3cac7c9cf278b81876994d3a4f4b795b8ce'/>
<id>urn:sha1:99fde3cac7c9cf278b81876994d3a4f4b795b8ce</id>
<content type='text'>
An arguably unrepresentative survey of services (GitHub, Google
Authenticator, and Bitbucket) seems to suggests that the base32 format
is the de-facto standard format for OTP secrets. Given that it's not
necessarily obvious what format a secret is in and that most services
refrain from mentioning it explicitly, having the correct default format
is fairly important.
With this change we switch the default format from hexadecimal to
base32 to accommodate for this finding.
</content>
</entry>
</feed>
