Buy

TKey Device Verification

Description

The TKey Device Verification application is a program that verifies the TKey you have in your hand is genuine. A genuine TKey is produced by Tillitis and contains the exact same firmware as when it was produced.

It is recommended that you verify your TKey before first use. You may also repeat the verification later.

Follow the below instructions for how to perform verification on different Operating Systems (OS). Note that you can verify your TKey on one computer/OS and use it on another. The verification is for your TKey, not your computer.

Installation and usage

Linux

To verify your TKey with Linux download the tkey-verification binary (link is to GitHub). Hash of the binary and source code is located in this GitHub repo. The published binaries can be reproduced.

To simplify, rename the downloaded file to “tkey-verification”.
Open a terminal and find the folder where you have stored the file, then do:

chmod +x ./tkey-verification

Plug in your TKey to your computer and execute this command in the terminal:

./tkey-verification verify

After processing the data and communicating with your TKey, expect a final message saying

TKey is genuine!

The program requires Internet connectivity to download the verification data. It is possible to get this data downloaded on another system, and transfer it to where you want to run the verification. Execute this command for more help and other usage.

./tkey-verification verify --help

macOS

We distribute Tkey Device Verification using our own tap for Homebrew on GitHub.

Hash of the binary and source code is located in this GitHub repo. The published binaries can be reproduced.

Open a terminal and start by adding our Homebrew tap

brew tap tillitis/tkey

then install tkey-verification

brew install tkey-verification

Plug in your TKey to your computer.

Automatic detection of the serial port is currently not available for tkey-verification on MacOS. First execute this command in the terminal to list the present serial port devices:

ls -l /dev/cu*

The TKey device name looks like “/dev/cu.usbmodemN” where N is a number. Now you can run the verification like:

tkey-verification verify --port /dev/cu.usbmodemN

After processing the data and communicating with your TKey, expect a final message saying

TKey is genuine!

The program requires Internet connectivity to download the verification data. It is possible to get this data downloaded on another system, and transfer it to where you want to run the verification. Execute this command for more help and other usage.

tkey-verification verify --help

 

Windows

To verify your TKey on Windows you need to download a tkey-verification binary for Windows (link is to GitHub). Hash of the binary and source code is located in this GitHub repo. The published binaries can be reproduced.

Insert your TKey into your computer and then run the program version that you downloaded in a console/terminal.

The following is a way to use Windows PowerShell to download the program and then run the verification:

Invoke-WebRequest -outfile tkey-verification.exe -uri https://github.com/tillitis/tkey-verification/releases/download/v0.0.3/tkey-verification_0.0.3_windows-amd64.exe
.\tkey-verification.exe verify

Note that this will download our executable directly from GitHub over the Internet, which Windows might complain about.

After processing the data and communicating with your TKey, expect a final message saying:

TKey is genuine!

The program requires Internet connectivity to download the verification data. It is possible to get this data downloaded on another system, and transfer it to where you want to run the verification. Execute this command for more help and other usage.

.\tkey-verification verify –-help