Identity Stick

The Identity Stick is a security key based on Solokey. It extends the functionality of the Solokey with the ability to identify users using the identity-stick extension. This is a prototype and will only work with the Solo Hacker.

The basic functionality of supporting FIDO2 and U2F standards of the Solokey is still supported. This enables the Identity Stick to be used for identification, two-factor authentication and password-less login.

If you want to know more about the Solokey, visit their repo or documentaion.

Checking out the code

git clone --recurse-submodules https://github.com/solokeys/solo
cd identity-stick

If you forgot the --recurse-submodules while cloning, simply run git submodule update --init --recursive.

make update will also checkout the latest code on master and submodules.

Prerequisites the toolchain and applying updates

Getting the ARM Compiler tool chain

Download the Compiler tool chain for your system here and unzip it. There is a readme.txt __ in gcc-arm-none-eabi-x-yyyy-dd-major/share/doc/gcc-arm-none-eabi. It contains installation guides for Linux, Windows and Mac.

Make sure to install the solo tool.

pip install solo-python

#Or
pip3 install solo-python

If you are on a linux system, you might have to add some udev rules as described here.

Build

If you have everything installed, you can build the code with:

cd targets/stm32l432
make cbor
make build-hacker
cd ../..

You can then program your Solo Hacker with:

solo program aux enter-bootloader
solo program bootloader targets/stm32l432/solo.hex

You can also just run the script in the root folder:

./build-program-hacker.sh

License

This software is fully open source.

All software, unless otherwise noted, is dual licensed under Apache 2.0 and MIT. You may use this software under the terms of either the Apache 2.0 license or MIT license.

All hardware, unless otherwise noted, is dual licensed under CERN and CC-BY-SA. You may use the hardware under the terms of either the CERN 2.1 license or CC-BY-SA 4.0 license.

All documentation, unless otherwise noted, is licensed under CC-BY-SA. You may use the documentation under the terms of the CC-BY-SA 4.0 license

Supported by

This fork is part of the project Identity Stick. Identity Stick is a finalist of the PrototypeFund round 7, see our project site for details.