The Pico project is liberating humanity from passwords. See https://www.mypico.org.
Pico is an alternative to passwords developed at the University of Cambridge that enables a smooth and password-free login to computers, and consists of a smartphone app and associated software on your computer.
The Pico project was funded by the ERC and ran between February 2013 and December 2017. Since the project completed, this software is provided as-is; we can't offer any guarantees of updates or bug fixes. However, the software is still being maintained by our spin-out company Cambridge Authentication.
Therefore, if you encounter problems with any of the instructions below, please check it works on a clean Ubuntu 16.04 install. If it's still causing problems, file an issue report, ideally including your console output and any logs generated. We will aim to look into problems, but sadly can't make commitments about being able to solve any individual issue.
This version is known to work on a Lenovo ThinkPad X270 laptop running Ubuntu 16.04 and a Nexus 6 phone running Android Nougat 7.11. We've found Bluetooth quality, especially when using dongles, to be patchy, so if you're using different devices your mileage may vary.
The scripts in this repository allow you to build all of the Pico packages in one easy script. However, if you just want the binaries on Ubuntu 16.04, you can install directly from the Pico repository instead.
If you're using Ubunutu 16.04, you can install directly from the Pico repository. Just add the repository:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 22991E96
sudo add-apt-repository "deb https://get.mypico.org/apt/ xenial main"
sudo apt update
then install libpam-pico:
sudo apt install libpam-pico
If you also want the developer files, you can also install these.
sudo apt install libpicobt-dev
sudo apt install libpico1-dev
If you want to build from source, the scripts in this repository will help you.
Pico is made up from several components:
You can build them individually by following the instructions in each of the repositories, or check the developer documentation for more complete instructions.
But you probably don't really want to go through all of that, do you? Suppose you just want to build the lot? If you're using Ubuntu 16.04, you can just clone this repository:
git clone https://github.com/mypico/pico-build-all.git
cd pico-build-all
Then run the following shell script. Note that this will install all of the dependencies, accept the Android Developer licence agreement and install the packages it builds without your intervention. If you're concerned about seeing what it's doing and making these decisions yourself, use the makefile detailed below instead.
./build-all.sh
If you're a more advanced user, you can use the makefile instead. This assumes you have make installed and provides a bit more visibilty. It's configured to stop at various points to ask your consent (e.g. to install packages). You can run it by typing the following.
make
The benefit of the makefile is that it'll only perform the steps to update anything that's changed, and will skip steps that don't need to be performed.
On successful completion, both will create a folder called built, inside which you'll find an Android apk and five deb packages. The deb packages will already have been installed, but if you want to install them manually from inside the built folder, you can use the following.
sudo dpkg -i libpicobt_0.0.2_amd64-run.deb
sudo dpkg -i libpicobt_0.0.2_amd64-dev.deb
sudo dpkg -i libpico1_0.0.3-1_amd64.deb
sudo dpkg -i libpico1-dev_0.0.3-1_amd64.deb
sudo dpkg -i libpam-pico_0.0.3-1_amd64.deb
The easiest way to install the app is to deploy it to your phone via USB. Ensure your phone has developer debugging enabled and connect it via USB to your computer. To check whether your phone is developer-enabled and correctly connected, enter the following on the computer it's connected to.
adb devices -l
If you don't see your device showing correctly in this list, you'll need to fix this first. In this case check out the details on the Android developer site (a common problem is to have permission issues).
Once your developer-enabled Android phone is correctly connected to your computer via USB, you can install the app with the following.
adb -d install built/android-pico-debug.apk
In case this fails, it could be because you've got an old version of Pico already installed. Uninstall it from your phone first, then try again.
You're now in a position to pair the Pico app with your computer. Ensure your computer and phone both have Internet access and enter the following on your computer.
gksu -k "pico-pair --gui --user $USER"
You'll need to enter your password a couple of times and scan the QR code with your Pico. A wizard will take you through the process. At the end of the process, make sure you Bluetooth pair your phone with your computer (check you've paired by sending a file from one to the other).
Finally you need to configure pam_pico for use with the application you want to authenticate to. Configuring PAMs is complex and not for the faint-hearted. Too complex for this README file in fact. If you want to know the full gory details, please refer to the developer documentation.
However, let's suppose you're running a default Ubuntu 16.04 installation with no changes to the existing PAM configuration files. We'll go through adding Pico to the Unity lock screen as an example.
First open the /etc/pam.d/common-auth file in a text editor as root.
sudo nano /etc/pam.d/common-auth
The file is mostly comments, but just over half way down you should see the following line.
auth [success=1 default=ignore] pam_unix.so nullok_secure
Change this line to read:
auth [success=1 default=ignore] pam_unix.so nullok_secure try_first_pass
Save the changes and then open the /etc/pam.d/unity file in a text editor as root.
sudo nano /etc/pam.d/unity
You should see this:
@include common-auth
auth optional pam_gnome_keyring.so
That's a fairly basic PAM config file. The actual hard work is going on inside the common-auth file that you edited above and which is included in this one.
To add Pico functionality, you'd need to add a new line to the top of the file.
auth requisite /usr/lib/x86_64-linux-gnu/security/pam_pico.so channeltype=btc continuous=1 beacons=1 anyuser=1 qrtype=none input=0 timeout=0
@include common-auth
auth optional pam_gnome_keyring.so
Now save the file. If you lock your machine now, you'll need your Pico to log in, so make sure you've correctly paired your Pico with your phone as explained above before doing anything else.
If you're satisfied everything is set up correctly, lock your Unity session and you'll notice the password box has gone. Instead, a button will appear on the Pico scanner screen of your Pico prompting you to 'Touch to log in'.
Touch the button and Pico will log you in to your computer. Check out the end user instructions for more info about how to use Pico.
Independent of how they were installed, the easiest way to uninstall the packages is as follows
sudo apt remove libpicobt-run
Since all of the packages depend on this package, it will cause any of the others you also have installed to be removed as well.
These scripts are released under the AGPL licence. Read COPYING for information.
We welcome comments and contributions to the project. If you're interested in contributing please see here: https://get.mypico.org/cla/
More information can be found at: https://mypico.org
The Pico project team at time of release:
- Frank Stajano (PI)
- David Llewellyn-Jones
- Claudio Dettoni
- Seb Aebischer
- Kat Krol
You can get in contact with us at [email protected]
We thank the European Research Council (ERC) for funding the Pico research through grant StG 307224 (Pico).