Hardware-based SSH/PGP agent
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Roman Zeyde dfde6dbee4 bump version 8 years ago
trezor_agent Fix typo (#48) 8 years ago
.gitignore gitignore: sublime text project files 8 years ago
.pylintrc pylint: ignore TODOs 8 years ago
.travis.yml travis: add Python 3.5 8 years ago
LICENSE Initial commit 9 years ago
README-GPG.md GPG: fix installation instructions 8 years ago
README-SSH.md README: add an example for remote git repository 8 years ago
README.md Add explanation about entering PIN (#47) 8 years ago
setup.py bump version 8 years ago
tox.ini removed .decode('ascii') and added missing bytestrings 8 years ago

README.md

Using TREZOR as a hardware SSH/GPG agent

Build Status Python Versions Package Version Development Status Downloads

See SatoshiLabs' blog posts about this feature:

Installation

First, make sure that the latest trezorlib Python package is installed correctly (at least v0.6.6):

$ apt-get install python-dev libusb-1.0-0-dev libudev-dev
$ pip install Cython trezor
$ pip install -U setuptools

Then, install the latest trezor_agent package:

$ pip install trezor_agent

Finally, verify that you are running the latest TREZOR firmware version (at least v1.4.0):

$ trezorctl get_features | head
vendor: "bitcointrezor.com"
major_version: 1
minor_version: 4
patch_version: 0
...

If you have an error regarding protobuf imports (after installing it), please see this issue.

Usage

For SSH, see the following instructions.

For GPG, see the following instructions.

Entering PIN

Look at the digits shown on the TREZOR display and enter their positions using this regular numeric keyboard mapping:

|7|8|9|
|4|5|6|
|1|2|3|

For example, if your PIN is 1234 and your TREZOR is displaying the following:

|3|1|2|
|7|5|8|
|6|4|9|

You have to enter 8972.

Troubleshooting

If there is an import problem with the installed protobuf package, see this issue for fixing it.

Gitter

Questions, suggestions and discussions are welcome: Chat