keycard-go/cmd/keycard
Andrea Franz 9aed67c579
interactive shell not allowed
2019-03-15 16:08:15 +01:00
..
README.md add -u flag to go get 2019-03-07 10:04:31 +01:00
initializer.go add shell command 2019-03-15 10:39:17 +01:00
installer.go use identifiers.KeycardDefaultInstanceIndex 2019-03-11 12:56:22 +01:00
main.go interactive shell not allowed 2019-03-15 16:08:15 +01:00
shell.go add more logging to shell 2019-03-15 11:11:31 +01:00

README.md

keycard

keycard is a command line tool you can use to initialize a smartcard with the Status Keycard.

Dependencies

To install keycard-go you need go in your system.

MacOSX:

brew install go

Installation

go get -u github.com/status-im/keycard-go/cmd/keycard

The executable will be installed in $GOPATH/bin. Check your $GOPATH with go env.

Usage

Install the keycard applet

The install command will install an applet to the card. You can download the status cap file from the status-im/status-keycard releases page.

keycard install -l debug -a PATH_TO_CAP_FILE

In case the applet is already installed and you want to force a new installation you can pass the -f flag.

Card info

keycard info -l debug

The info command will print something like this:

Installed: true
Initialized: false
InstanceUID: 0x
PublicKey: 0x112233...
Version: 0x
AvailableSlots: 0x
KeyUID: 0x

Card initialization

keycard init -l debug

The init command initializes the card and generates the secrets needed to pair the card to a device.

PIN 123456
PUK 123456789012
Pairing password: RandomPairingPassword

Deleting the applet from the card

⚠️ WARNING! This command will remove the applet and all the keys from the card. ⚠️

keycard delete -l debug

Pairing

keycard pair -l debug

The process will ask for PairingPassword and PIN and will generate a pairing key you can use to interact with the card.